Partager via

Remove-SCVirtualHardDisk

  • Référence
Module:
VirtualMachineManager

Supprime un objet de disque dur virtuel d’une machine virtuelle ou d’un modèle, ou de la bibliothèque VMM.

Syntaxe

Remove-SCVirtualHardDisk
      [-VirtualHardDisk] <VirtualHardDisk>
      [-JobGroup <Guid>]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L 'applet de commande remove-SCVirtualHardDisk supprime un objet de disque dur virtuel d’une machine virtuelle ou d’un modèle, ou de la bibliothèque Virtual Machine Manager (VMM). Remove-VirtualHardDisk supprime également le fichier de disque dur virtuel correspondant (un fichier .vhd windows, un fichier .vhd basé sur Citrix XenServer ou un fichier .vmdk VMware) du serveur de bibliothèque.

Si le disque dur virtuel est attaché à un lecteur de disque virtuel sur une machine virtuelle ou un modèle (et si vous n’utilisez pas le paramètre Force), VMM répertorie le conteneur qui contient le disque dur virtuel et vous invite à confirmer que vous souhaitez supprimer le disque dur virtuel :

  • Si vous répondez Oui, VMM supprime l’association entre le disque dur virtuel et le conteneur auquel il est attaché, puis supprime l’objet de disque dur virtuel de VMM.

  • Si vous répondez Non, l’opération est annulée.

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 disque dur virtuel de la bibliothèque

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCVirtualHardDisk -VirtualHardDisk $VHD

La première commande obtient l’objet de disque dur virtuel nommé VHD01.vhd stocké sur LibraryServer01 et stocke l’objet retourné dans la variable $VHD.

La deuxième commande supprime l’objet de disque dur virtuel stocké dans $VHD de la bibliothèque et supprime le fichier correspondant du système de fichiers sur le serveur de bibliothèque.

Exemple 2 : Supprimer un disque dur virtuel d’une machine virtuelle

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }
PS C:\> $VHD | Remove-SCVirtualHardDisk

La première commande se connecte à VMMServer01.

La deuxième commande obtient l’objet de machine virtuelle nommé VM01, obtient tous les disques durs virtuels sur VM01 dont le nom inclut la chaîne « DataDisk », puis stocke ces objets de disque dur virtuel dans un tableau nommé $VHD.

La troisième commande supprime chaque objet de disque dur virtuel stocké dans le tableau $VHD de la machine virtuelle et supprime chaque fichier correspondant 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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-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

-VirtualHardDisk

Spécifie un objet de disque dur virtuel.

Type:VirtualHardDisk
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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

Notes

  • Nécessite un objet de disque dur virtuel VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCVirtualHardDisk .