Partager via


Set-SCVirtualDVDDrive

Modifie les propriétés d’un lecteur DE DVD virtuel associé à une machine virtuelle, un modèle de machine virtuelle ou un profil matériel utilisé dans VMM.

Syntaxe

Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-NoMedia]
   -JobGroup <Guid>
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   -VMHostDrive <String>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   [-NoMedia]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   [-JobGroup <Guid>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-Link]
   -ISO <ISO>
   -JobGroup <Guid>
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   -VMHostDrive <String>
   -JobGroup <Guid>
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-Link]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   -ISO <ISO>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   -JobGroup <Guid>
   [-AnyVMHostDrive]
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   -JobGroup <Guid>
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande Set-SCVirtualDVDDrive modifie une ou plusieurs propriétés d’un objet de lecteur DVD virtuel associé à une machine virtuelle, un modèle de machine virtuelle ou un profil matériel utilisé dans un environnement Virtual Machine Manager (VMM).

Vous pouvez utiliser cette applet de commande pour connecter un lecteur DE DVD virtuel à un lecteur DE DVD physique sur un serveur hôte de machine virtuelle, à un autre emplacement sur le bus IDE ou à une image ISO, ou vous pouvez l’utiliser pour déconnecter le lecteur de DVD virtuel.

La plupart des paramètres que vous pouvez configurer pour un lecteur DE DVD virtuel sur une machine virtuelle sont identiques, que la plateforme de virtualisation de l’hôte soit Hyper-V, VMware ou Citrix XenServer. Toutes ces plateformes de virtualisation prennent en charge les éléments suivants :

  • Connexion d’un lecteur DE DVD virtuel à un canal principal ou secondaire sur un hôte.

  • Capture d’informations à partir d’un lecteur CD ou DVD physique sur l’hôte sans spécifier de lettre de lecteur.

  • Capture d’informations à partir d’un fichier d’image (ISO) stocké dans la bibliothèque VMM.

  • Capture de « aucun média » (utilisé pour déconnecter un lecteur de DVD virtuel du lecteur hôte ou d’un fichier ISO).

Le seul paramètre qui varie pour cette applet de commande par plateforme de virtualisation est de savoir si un fichier ISO peut être utilisé directement à partir de la bibliothèque VMM :

  • hôte Hyper-V. Si vous configurez une connexion à un fichier ISO dans la bibliothèque VMM, vous pouvez choisir d’utiliser la norme ISO directement à partir de la bibliothèque au lieu de la copier sur l’hôte.

  • Hôte VMware ESX. Si vous configurez une connexion à un fichier ISO dans la bibliothèque VMM, vous ne pouvez pas utiliser l’ISO directement à partir de la bibliothèque, mais devez accepter la valeur par défaut, qui copie le fichier ISO vers l’hôte.

  • Hôte Citrix XenServer. Si vous configurez une connexion à un fichier ISO dans la bibliothèque VMM, vous ne pouvez pas utiliser l’ISO directement à partir de la bibliothèque, mais devez accepter la valeur par défaut, qui copie le fichier ISO vers l’hôte. L’hôte doit disposer d’au moins un référentiel ISO disponible avec un accès en écriture et suffisamment d’espace de stockage pour contenir le fichier ISO.

Remarque : Si le lecteur DE DVD virtuel est configuré sur une machine virtuelle créée à l’aide de l’Assistant Machine virtuelle dans la console Hyper-V Manager plutôt que dans la console VMM, vous devez spécifier une lettre de lecteur. Cette lettre de lecteur apparaît dans les propriétés de cette machine virtuelle dans la console VMM.

Exemples

Exemple 1 : Connecter un lecteur de DVD virtuel à un lecteur de DVD physique

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

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 canal secondaire 0 (spécifié par -Bus 1 et -LUN 0) sur le bus IDE sur VM01 et stocke l’objet dans la variable $DVDDrive.

La dernière commande connecte l’objet de lecteur de DVD virtuel stocké dans $DVDDrive à un lecteur physique sur l’hôte (lecteur D :). Il supprime également tout fichier ISO utilisé précédemment par le lecteur DVD virtuel si aucune autre machine virtuelle n’utilise actuellement ce fichier ISO.

Exemple 2 : Connecter un lecteur DE DVD virtuel à un autre emplacement sur le bus IDE

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

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

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

La dernière commande connecte l’objet de lecteur de DVD virtuel stocké dans $DVDDrive à une position différente sur le bus IDE en définissant le numéro d’unité logique (LUN) sur 1.

Exemple 3 : Déconnecter un lecteur de DVD virtuel

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

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

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

La dernière commande utilise le paramètre NoMedia pour déconnecter l’objet de lecteur DVD virtuel stocké dans $DVDDrive de n’importe quel lecteur hôte ou ISO auquel il est connecté. Il supprime également tout fichier ISO utilisé précédemment par le lecteur DVD virtuel si aucune autre machine virtuelle n’utilise actuellement ce fichier ISO.

Exemple 4 : Connecter un lecteur de DVD virtuel sur une machine virtuelle existante à n’importe quel lecteur de DVD physique disponible

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> Set-SCVirtualDVDDrive -AnyVMHostDrive -VirtualDVDDrive (Get-VirtualDVDDrive -VM $VM | where {$_.Bus -eq 1 -and $_.Lun -eq 0})

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

La dernière 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 VM04. La commande utilise l’applet de commande Set-SCVirtualDVDDrive avec le paramètre AnyVMHostDrive pour connecter le lecteur DVD virtuel à n’importe quel lecteur de DVD physique disponible sur l’hôte.

Paramètres

-AnyVMHostDrive

Indique qu’un DVD virtuel ou un lecteur de floppy sur une machine virtuelle est connecté à n’importe quel lecteur physique correspondant sur un hôte. Ce mappage se produit lorsque vous déployez une machine virtuelle stockée sur un hôte, ou lorsque vous utilisez un modèle ou un profil matériel pour créer et déployer une machine virtuelle sur un hôte.

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

-Bus

Spécifie le bus IDE auquel attacher un lecteur de disque virtuel ou un lecteur DE DVD virtuel, ou le bus SCSI auquel attacher un lecteur de disque virtuel.

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

-ISO

Spécifie un objet ISO.

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

Indique qu’une ressource doit être liée au lieu d’être copiée.

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

-LUN

Spécifie le numéro d’unité logique (LUN) d’un objet de lecteur de disque virtuel ou d’un objet de lecteur DVD virtuel sur un bus IDE, ou pour un objet de lecteur de disque virtuel sur un bus SCSI.

  • Exemple de format : -IDE -Bus 1 -LUN 0
  • Exemple de format : -SCSI -Bus 0 -LUN 1
Type:Byte
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NoMedia

Déconnecte un lecteur DE DVD virtuel du lecteur hôte ou iso auquel il a été connecté, ou déconnecte un lecteur de floppy virtuel du lecteur hôte ou du disque de floppy virtuel auquel il a été connecté.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
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

-VMHostDrive

Spécifie un lecteur sur un hôte de machine virtuelle.

Exemples de formats :

  • Hyper-V disque dur hôte : "C:"
  • lecteur de floppy hôte Hyper-V : "A:"
  • Disque dur hôte VMware ESX : "/dev/tools"
  • Lecteur de floppy hôte VMware ESX : "/dev/sda"
  • Disque dur hôte Citrix XenServer : "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
  • Lecteur de floppy hôte Citrix XenServer : non pris en charge
Type:String
Alias:HostDrive
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

VirtualDVDDrive

Cette applet de commande retourne un objet VirtualDVDDrive.

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 .