Partager via

Remove-SCVirtualHardDisk

  • Référence
Module:
VirtualMachineManager

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

Syntax

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 VMM (Virtual Machine Manager). Remove-VirtualHardDisk supprime également le fichier de disque dur virtuel correspondant (un fichier .vhd Windows, un fichier .vhd 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 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 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 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 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 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

-Force

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

Type:SwitchParameter
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 du conseil d’optimisation des performances et des ressources 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

-VirtualHardDisk

Spécifie un objet disque dur virtuel.

Type:VirtualHardDisk
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

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 .