Partager via

Read-SCLibraryShare

  • Référence
Module:
VirtualMachineManager

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

Syntax

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 les informations sur l’état et les métadonnées de tous les objets de bibliothèque du partage stockés dans $LibShare, puis ajoute tous 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 tous 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 de tous les objets de bibliothèque dans le sous-répertoire spécifié sur le partage de bibliothèque stocké dans $LibShare, puis ajoute tous les nouveaux objets de bibliothèque trouvés dans le partage à la bibliothèque VMM.

Paramètres

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LibraryShare

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

Type:LibraryShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Spécifie le chemin de destination de l’opération.

Exemples de formats :

  • Chemin d’accès local : -Path "F:\"
  • Chemin UNC : -Path "\\Library\Templates"
  • Chemin d’accès GUID du volume : -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • Chemin d’accès VMware ESX : -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Chemin Citrix XenServer : -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Sorties

LibraryShare

Cette applet de commande retourne un objet LibraryShare .