Partager via

Remove-SCLibraryShare

  • Référence
Module:
VirtualMachineManager

Supprime un partage de bibliothèque de VMM, mais ne supprime pas le partage du système de fichiers Windows.

Syntaxe

Remove-SCLibraryShare
      [-LibraryShare] <LibraryShare>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-SCLibraryShare supprime un partage de bibliothèque de la bibliothèque Virtual Machine Manager (VMM). Cette applet de commande ne supprime aucun partage ou fichier du système de fichiers sur l’ordinateur.

Cette applet de commande retourne l’objet en cas de réussite (avec la propriété MarkedForDeletion définie sur $True) ou retourne un message d’erreur en cas d’échec.

Exemples

Exemple 1 : Supprimer un objet de partage de bibliothèque de la bibliothèque VMM

PS C:\> $LibShare = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AllVHDs" }
PS C:\> Remove-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 supprime l’objet de partage de bibliothèque et tous les objets de bibliothèque de ce partage de la bibliothèque VMM, mais ne supprime pas le partage ou son contenu du système de fichiers sur le serveur de bibliothèque.

Exemple 2 : Supprimer plusieurs objets de partage de bibliothèque de la bibliothèque VMM

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

La première commande obtient tous les objets de partage de bibliothèque sur LibraryServer01 dont le nom inclut la chaîne « vhd » de la bibliothèque VMM sur VMMServer01, puis stocke ces objets de partage dans la variable $LibShares (tableau d’objets).

La deuxième commande transmet chaque objet de partage de bibliothèque dans $LibShares à Remove-SCLibraryShare. L’applet de commande supprime chacun des objets de partage de bibliothèque et tous les objets du partage de la bibliothèque VMM, mais ne supprime pas les partages correspondants ou leur contenu du système de fichiers sur le serveur de bibliothèque.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
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

-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

-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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

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