Add-SCLibraryShare
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.
Syntax
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 l’applet de commande 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’actualiseur de bibliothèque, mais non créées par un administrateur incluent des disques durs virtuels (fichiers .vhd basés sur Windows, des fichiers .vhd basés sur Citrix XenServer ou des fichiers .vmdk basés sur VMware), des disques floppy virtuels (fichiers .vfd 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 établit la connexion à 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 , qui ajoute chaque partage Windows en tant que partage de bibliothèque à VMM.
Remarque : Pour plus d’informations sur l’instruction de boucle ForEach standard Windows PowerShell, 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 comme alias.
Paramètres
-AddDefaultResources
Indique que les ressources par défaut d’un partage de bibliothèque sont ajoutées.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 Get-Help Get-Credential.
Pour plus d’informations sur les comptes d’identification, tapez Get-Help New-SCRunAsAccount.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Spécifie une description du partage de bibliothèque.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Spécifie un identificateur pour une série de commandes qui seront exécutées ensemble juste avant que la commande finale qui comprend le même identificateur de groupe de travaux soit exécutée.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-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 |
-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 |
-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 d’accès UNC (Universal Naming Convention).
Exemple de format : -SharePath "\\LibServer01\LibShare"
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseAlternateDataStream
Spécifie s’il faut ou non utiliser AlternateDataStream.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Spécifie un objet serveur VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Sorties
LibraryShare
Cette applet de commande retourne un objet LibraryShare .