Partager via

Remove-SCVirtualDVDDrive

  • Référence
Module:
VirtualMachineManager

Supprime un objet de lecteur DE DVD virtuel de VMM.

Syntaxe

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 DE 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 de 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 DE 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 l’objet de lecteur DE DVD virtuel stocké dans $DVDDrive de VM01 et supprime tout fichier .iso que ce lecteur DVD virtuel utilise à partir du système de fichiers sur le serveur de bibliothèque.

Exemple 2 : Supprimer le troisième lecteur de 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 DE DVD virtuels connectés à VM02 et stocke chaque objet de lecteur DE DVD virtuel dans le tableau d’objets $DVDDrive. Cet exemple part du principe que VM02 a trois lecteurs DE DVD virtuels et que le tableau contient donc trois éléments (comptant 0 à 2).

La dernière commande passe le troisième lecteur de DVD virtuel (objet [2]) stocké dans $DVDDrive à l’applet de commande Remove-SCVirtualDVDDrive, qui supprime cet objet de lecteur DE 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 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

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

-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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet 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
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

-SourceBus

Spécifie le bus IDE source pour le lecteur.

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

-SourceLUN

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

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

-VirtualDVDDrive

Spécifie un objet de lecteur de DVD virtuel.

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