Partager via

Add-SCLibraryShare

  • Référence
Module:
VirtualMachineManager

Ajoute des partages Windows sur le système de fichiers d’un serveur de bibliothèque à la bibliothèque VMM en tant que partages de bibliothèque.

Syntaxe

Add-SCLibraryShare
   [-VMMServer <ServerConnection>]
   [-SharePath] <String>
   [-Credential <PSCredential>]
   [-Description <String>]
   [-AddDefaultResources]
   [-JobGroup <Guid>]
   [-UseAlternateDataStream <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande add-SCLibraryShare ajoute des partages Windows sur le système de fichiers d’un serveur de bibliothèque à la bibliothèque Virtual Machine Manager (VMM) en tant que partages de bibliothèque.

Avant de pouvoir ajouter un partage de bibliothèque à la bibliothèque VMM, vous devez d’abord créer le partage dans le système de fichiers Windows. Vous pouvez, par exemple, utiliser l’Explorateur Windows pour créer et partager un dossier que vous souhaitez ajouter à la bibliothèque.

Si vous créez un partage Windows au même niveau que le partage de bibliothèque par défaut (MSSCVMMLibrary) créé par le programme d’installation de VMM ou sur un serveur de bibliothèque distinct, utilisez l’applet de commande Add-SCLibraryShare pour ajouter ce partage à la bibliothèque VMM.

Si vous créez un dossier Windows sous le partage de bibliothèque VMM par défaut (MSSCVMMLibrary), VMM analyse automatiquement le partage, découvre tous les objets existants stockés sur ce partage qui sont qualifiés d’objets de bibliothèque et ajoute les objets de bibliothèque à la bibliothèque. Toutefois, vous pouvez utiliser la cmdlet Read-SCLibraryShare pour actualiser manuellement ce partage et importer son contenu dans la bibliothèque VMM.

Remarque : Les ressources de bibliothèque qui peuvent être découvertes uniquement par l’actualisation de la bibliothèque, mais qui ne sont pas créées par un administrateur incluent des disques durs virtuels (fichiers .vhd basés sur Windows, fichiers .vhd basés sur Citrix XenServer ou fichiers .vmdk basés sur VMware), des disques de floppy virtuels (fichiers .vfd basés sur Windows ou fichiers .flp basés sur VMware), des images ISO (fichiers .iso) et des scripts.

Exemples

Exemple 1 : Ajouter un partage Windows en tant qu’objet de partage de bibliothèque à la bibliothèque VMM

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Add-SCLibraryShare -SharePath "\\LibraryServer01\AllVHDs"

La première commande se connecte à VMMServer01.

La deuxième commande ajoute un objet de partage de bibliothèque à la bibliothèque nommée AllVHDs (un partage Windows situé sur LibraryServer01). Cet exemple suppose que LibraryServer01 est déjà un serveur de bibliothèque VMM.

Exemple 2 : Ajouter deux partages Windows en tant qu’objets de partage de bibliothèque à la bibliothèque VMM

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $SharePaths = "\\LibraryServer01\AllVHDs", "\\LibraryServer01\AllISOs"
PS C:\> ForEach($SharePath in $SharePaths) { Add-SCLibraryShare -SharePath $SharePath }

La première commande se connecte à VMMServer1.

La deuxième commande stocke les chaînes « \LibraryServer01\AllVHDs » et « \LibraryServer01\AllSOs » dans la variable $SharePaths. Cet exemple suppose que LibraryServer01 est déjà un serveur de bibliothèque VMM.

La dernière commande utilise une boucle ForEach pour passer les deux noms de partage stockés dans $SharePaths à l’applet de commande Add-SCLibraryShare add-SCLibraryShare, qui ajoute chaque partage Windows en tant que partage de bibliothèque à VMM.

Remarque : Pour plus d’informations sur l’instruction de boucle Windows PowerShell standard ForEach, tapez Get-Help about_ForEach. L’instruction de boucle ForEach n’est pas la même que l’applet de commande ForEach-Object, qui utilise ForEach en tant qu’alias.

Paramètres

-AddDefaultResources

Indique que les ressources par défaut d’un partage de bibliothèque sont ajoutées.

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

-Credential

Spécifie un objet d’informations d’identification ou, pour certaines applets de commande, un objet de compte d’identification qui contient le nom d’utilisateur et le mot de passe d’un compte autorisé à effectuer cette action. Ou, dans le cas de restart-SCJob, dispose de l’autorisation d’effectuer une tâche redémarrée.

Pour plus d’informations sur l’objet PSCredential , tapez .

Pour plus d’informations sur les comptes d’identification, tapez Get-Help New-SCRunAsAccount.

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

-Description

Spécifie une description du partage de bibliothèque.

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

-JobGroup

Spécifie un identificateur pour une série de commandes qui s’exécute en tant que jeu juste avant la commande finale qui inclut le même identificateur de groupe de travaux.

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

-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

-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

-SharePath

Spécifie un chemin d’accès à un partage de bibliothèque valide sur un serveur de bibliothèque existant qui utilise un chemin UNC (Universal Naming Convention).

Exemple de format : -SharePath "\\LibServer01\LibShare"

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

-UseAlternateDataStream

Spécifie s’il faut ou non utiliser AlternateDataStream.

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

-VMMServer

Spécifie un objet serveur VMM.

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

Sorties

LibraryShare

Cette applet de commande retourne un objet LibraryShare.