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.

Syntax

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 cmdlet ne supprime pas de partages ou de fichiers 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 demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-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

-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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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