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