Partager via

Remove-SCVirtualDVDDrive

  • Référence
Module:
VirtualMachineManager

Supprime un objet de lecteur DVD virtuel de VMM.

Syntax

Remove-SCVirtualDVDDrive
      [-VirtualDVDDrive] <VirtualDVDDrive>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCVirtualDVDDrive
      -SourceBus <Byte>
      -SourceLUN <Byte>
      -JobGroup <Guid>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

L’applet de commande Remove-SCVirtualDVDDrive supprime un ou plusieurs objets de lecteur DVD virtuel d’un profil matériel, d’une machine virtuelle ou d’un modèle de machine virtuelle utilisé dans un environnement VMM (Virtual Machine Manager). L’applet de commande supprime également tout fichier .iso que le lecteur DVD virtuel utilise à partir du système de fichiers sur le serveur de bibliothèque.

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 lecteur DVD virtuel spécifique d’une machine virtuelle

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Remove-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive

La première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.

La deuxième commande obtient l’objet de lecteur DVD virtuel situé sur le premier emplacement du canal secondaire (spécifié par -Bus 1 et -LUN 0) sur le bus IDE sur VM01, puis stocke l’objet lecteur DVD virtuel dans la variable $DVDDrive.

La dernière commande supprime de VM01 l’objet lecteur de DVD virtuel stocké dans $DVDDrive, et supprime du système de fichiers sur le serveur de bibliothèque tous les fichiers .iso utilisés par ce lecteur de DVD virtuel.

Exemple 2 : Supprimer le troisième lecteur dvd virtuel d’une machine virtuelle

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM
PS C:\> $DVDDrive[2] | Remove-SCVirtualDVDDrive

La première commande obtient l’objet de machine virtuelle nommé VM02 et stocke l’objet dans la variable $VM.

La deuxième commande obtient tous les objets de lecteur DVD virtuel connectés à VM02 et stocke chaque objet de lecteur DVD virtuel dans le tableau d’objets $DVDDrive. Dans cet exemple, il est supposé que VM02 possède trois lecteurs DVD virtuels ; par conséquent, le tableau contient trois éléments (compteur de 0 à 2).

La dernière commande transmet le troisième lecteur dvd virtuel (objet [2]) stocké dans $DVDDrive à l’applet de commande Remove-SCVirtualDVDDrive , qui supprime cet objet de lecteur DVD virtuel de VM02 et supprime tout fichier .iso utilisé par ce lecteur DVD virtuel 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

-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:True
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

-OnBehalfOfUser

Spécifie un nom d'utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

Type:UserRole
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

-SourceBus

Spécifie le bus IDE source pour le lecteur.

Type:Byte
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SourceLUN

Spécifie le numéro d’unité logique source (LUN) d’un objet de lecteur DVD virtuel sur un bus IDE.

Type:Byte
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VirtualDVDDrive

Spécifie un objet lecteur de DVD virtuel.

Type:VirtualDVDDrive
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 lecteur DVD virtuel VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCVirtualDVDDrive .