Partager via

Set-SCVirtualDVDDrive

  • Référence
Module:
VirtualMachineManager

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.

Syntax

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 de 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 DE CD ou DVD physique sur l’hôte sans spécifier de lettre de lecteur.

  • Capture d’informations à partir d’un fichier 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 indique 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 l’iso directement à partir de la bibliothèque au lieu de le 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 le fichier ISO directement à partir de la bibliothèque, mais vous devez accepter le paramètre par défaut, qui copie le fichier ISO sur l’ordinateur hôte.

  • Hôte Citrix XenServer. Si vous configurez une connexion à un fichier ISO dans la bibliothèque VMM, vous ne pouvez pas utiliser le fichier ISO directement à partir de la bibliothèque, mais vous devez accepter le paramètre par défaut, qui copie le fichier ISO sur l’ordinateur 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 Du Gestionnaire Hyper-V 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 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 lecteur de DVD virtuel stocké dans $DVDDrive à un lecteur physique sur l’hôte (lecteur D: ). Il supprime également tous les fichiers ISO utilisés préalablement par le lecteur de DVD virtuel si aucun autre ordinateur virtuel 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 qui se trouve 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 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 tous les fichiers ISO utilisés préalablement par le lecteur de DVD virtuel si aucun autre ordinateur virtuel 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 qui se trouve 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 disquette 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
Aliases:AnyHostDrive
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ISO

Spécifie un objet ISO.

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

-Link

Indique qu’une ressource doit être liée au lieu de la copie.

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

-LUN

Spécifie le numéro d’unité logique (LUN) d’un objet lecteur de disque virtuel ou d’un objet lecteur de DVD virtuel sur un bus IDE, ou d’un objet 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoMedia

Déconnecte un lecteur de DVD virtuel du lecteur hôte ou du fichier ISO auquel il était connecté, ou déconnecte un lecteur de disquette virtuel du lecteur hôte ou de la disquette virtuelle auquel il était connecté.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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 spécifié par ce paramètre.

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

-VMHostDrive

Spécifie un lecteur sur un ordinateur hôte d’ordinateur virtuel.

Exemples de formats :

  • Disque dur hôte Hyper-V : "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 de l’hôte Citrix XenServer : "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
  • Lecteur de floppy hôte Citrix XenServer : non pris en charge
Type:String
Aliases:HostDrive
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 .