Partager via


Read-SCLibraryShare

Met à jour l’état et les métadonnées des objets de bibliothèque VMM stockés dans un partage de bibliothèque.

Syntaxe

Read-SCLibraryShare
    [-LibraryShare] <LibraryShare>
    [-Path <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

L’applet de commande Read-SCLibraryShare met à jour l’état et les métadonnées de tous les objets de bibliothèque VMM (Virtual Machine Manager) stockés dans le partage de bibliothèque spécifié. Cette mise à jour recherche également de nouveaux fichiers de bibliothèque sur le partage de bibliothèque spécifié ainsi que de nouveaux dossiers partagés enfants sous le partage de bibliothèque spécifié.

Exemples

Exemple 1 : Mettre à jour un partage de bibliothèque spécifié

PS C:\> $LibShare = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AllVHDs" }
PS C:\> Read-SCLibraryShare -LibraryShare $LibShare

La première commande obtient l’objet de partage de bibliothèque nommé AllVHDs sur LibraryServer01 à partir de la bibliothèque VMM sur VMMServer01, puis stocke l’objet dans la variable $LibShare.

La deuxième commande met à jour l’état et les informations de métadonnées pour tous les objets de bibliothèque du partage stockés dans $LibShare, puis ajoute les nouveaux objets de bibliothèque trouvés dans le partage à la bibliothèque VMM.

Exemple 2 : Mettre à jour plusieurs partages de bibliothèque

PS C:\> $LibShares = Get-SCLibraryShare -VMMServer "VMMServer1.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "vhd" }
PS C:\> $LibShares | Read-SCLibraryShare

La première commande obtient les objets de partage de bibliothèque sur LibraryServer01 avec la chaîne « vhd » dans leurs noms, puis stocke les objets dans la variable $LibShares.

La deuxième commande met à jour les informations de tous les partages de bibliothèque stockés dans $LibShares, puis ajoute les nouveaux objets de bibliothèque trouvés dans ces partages à la bibliothèque VMM.

Exemple 3 : Mettre à jour un sous-répertoire spécifique sur un partage de bibliothèque

PS C:\> $LibShare = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AllVHDs" }
PS C:\> Read-SCLibraryShare -LibraryShare $LibShare -Path "Production\WebFrontEnd"

La première commande obtient l’objet de partage de bibliothèque nommé AllVHDs sur LibraryServer01 à partir de la bibliothèque VMM sur VMMServer01, puis stocke l’objet dans la variable $LibShare.

La deuxième commande met à jour les informations d’état et de métadonnées pour tous les objets de bibliothèque du sous-répertoire spécifié sur le partage de bibliothèque stockés dans $LibShare, puis ajoute les nouveaux objets de bibliothèque trouvés dans le partage à la bibliothèque VMM.

Paramètres

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LibraryShare

Spécifie un objet de partage de bibliothèque VMM.

Type:LibraryShare
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Path

Spécifie le chemin d’accès de destination de l’opération.

Exemples de formats :

  • Chemin d’accès local : -Path "F:\"
  • Chemin d’accès UNC : -Path "\\Library\Templates"
  • Chemin d’accès GUID du volume : -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • Chemin VMware ESX : -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Chemin citrix XenServer : -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

LibraryShare

Cette applet de commande retourne un objet LibraryShare.