New-SCVirtualDVDDrive

Référence

Module:: VirtualMachineManager

Crée un lecteur DVD virtuel sur une machine virtuelle, un modèle de machine virtuelle ou un profil matériel utilisé dans VMM.

Syntaxe

New-SCVirtualDVDDrive
   [-VMMServer <ServerConnection>]
   -Bus <Byte>
   -LUN <Byte>
   [-Link]
   -JobGroup <Guid>
   [-ISO <ISO>]
   [-VMHostDrive <String>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualDVDDrive
   -Bus <Byte>
   -LUN <Byte>
   [-Link]
   -HardwareProfile <HardwareProfile>
   [-ISO <ISO>]
   [-VMHostDrive <String>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualDVDDrive
   -Bus <Byte>
   -LUN <Byte>
   [-Link]
   -VM <VM>
   [-ISO <ISO>]
   [-VMHostDrive <String>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualDVDDrive
   -Bus <Byte>
   -LUN <Byte>
   [-Link]
   -VMTemplate <Template>
   [-ISO <ISO>]
   [-VMHostDrive <String>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

La cmdlet New-SCVirtualDVDDrive crée un objet de lecteur DVD virtuel sur une machine virtuelle, un modèle de machine virtuelle ou un profil matériel utilisé dans un environnement Virtual Machine Manager (VMM). Par défaut, le lecteur de DVD virtuel créé par New-SCVirtualDVDDrive n’est connecté à aucun média. Vous pouvez utiliser l’applet de commande set-SCVirtualDVDDrive pour connecter un lecteur DVD virtuel à un lecteur DVD physique sur un hôte de machine virtuelle ou à une image ISO.

Remarque : vous pouvez connecter un lecteur DE DVD virtuel à un appareil IDE sur une machine virtuelle, mais vous ne pouvez pas connecter un lecteur DE DVD virtuel à une carte SCSI sur une machine virtuelle.

Exemples

Exemple 1 : Créer un lecteur DE DVD virtuel sur une machine virtuelle

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualDVDDrive -VM $VM -Bus 1 -LUN 1

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

La deuxième commande crée un lecteur de DVD virtuel sur VM01 et attache le lecteur de DVD virtuel au canal secondaire (1) en spécifiant IDE Bus 1 et LUN 1.

Exemple 2 : Créer un lecteur DE DVD virtuel sur un modèle de machine virtuelle

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualDVDDrive -VMTemplate $VMTemplate -Bus 1 -LUN 1

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

La deuxième commande crée un lecteur de DVD virtuel sur VMTemplate01 qui attache un lecteur DE DVD virtuel au canal secondaire (1) sur le bus IDE lorsque le modèle est utilisé pour créer une machine virtuelle.

Exemple 3 : Créer un lecteur DE DVD virtuel sur un profil matériel

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualDVDDrive -HardwareProfile $HWProfile -Bus 1 -LUN 1

La première commande obtient l’objet de profil matériel nommé NewHardwareProfile01 et stocke l’objet dans la variable $HWProfile.

La deuxième commande crée un lecteur DE DVD virtuel sur HardwareProfile1 qui attache un lecteur DE DVD virtuel au canal secondaire (1) sur le bus IDE lorsque le profil matériel est utilisé pour créer une machine virtuelle.

Exemple 4 : Créer une machine virtuelle avec un lecteur de DVD virtuel qui se connecte à n’importe quel lecteur de DVD physique disponible sur l’hôte

PS C:\> $JobGroupId = [Guid]::NewGuid().ToString()
PS C:\> New-SCVirtualDVDDrive -VMMServer "VMMServer01.Contoso.com" -JobGroup $JobGroupId -Bus 1 -LUN 0 -AnyVMHostDrive 
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost04"
PS C:\> New-SCVirtualMachine -Name "VM04" -Description "A new VM with a DVD drive" -VMMServer "VMMServer01.Contoso.com" -Owner "Contoso\Katarina" -VMHost $VMHost -Path "D:\VirtualMachinePath" -StartVM -JobGroup $JobGroupId

La première commande crée une chaîne GUID et la stocke dans la variable $JobGroupID. Ce GUID est un ID de groupe de travaux qui fonctionne comme identificateur qui regroupe les commandes suivantes qui incluent cet identificateur dans un seul groupe de travaux.

La deuxième commande crée un objet de lecteur de DVD virtuel et spécifie que ce nouveau lecteur de DVD virtuel peut utiliser n’importe quel lecteur de DVD physique disponible. La commande attache le nouveau lecteur de DVD virtuel au premier emplacement du deuxième canal IDE (IDE est le seul type de bus auquel un lecteur DE DVD virtuel peut être attaché). L’utilisation de l’ID de groupe de travaux spécifie que cette commande ne s’exécute qu’avant la commande finale qui inclut le paramètre JobGroup s’exécute.

La troisième commande obtient l’objet hôte nommé VMHost04 et stocke l’objet dans la variable $VMHost.

La dernière commande crée une machine virtuelle, la nomme VM04, fournit une description, attribue un propriétaire et spécifie l’emplacement sur l’hôte pour stocker la machine virtuelle. La commande utilise l’ID de groupe de travaux pour exécuter la commande New-SCVirtualDVDDrive juste avant l’exécution de la commande New-SCVirtualMachine ; l’objet de lecteur DE DVD virtuel résultant est associé à la nouvelle machine virtuelle.

Exemple 5 : Ajouter un nouveau lecteur DE DVD virtuel à une machine virtuelle existante et attacher un fichier ISO de la bibliothèque au lecteur

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $ISO = Get-SCISO | where {$_.Name -eq "WindowsServer2008R2.iso"}
PS C:\> New-SCVirtualDVDDrive -VM $VM -ISO $ISO -Bus 1 -LUN 1

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

La deuxième commande obtient l’objet ISO nommé WindowsServer2008R2.iso et stocke l’objet dans la variable $ISO.

La dernière commande crée un lecteur DE DVD virtuel sur VM05, l’attache à l’emplacement spécifié sur le bus IDE et le lie à l’image ISO stockée dans $ISO.

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:	False
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:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-HardwareProfile

Spécifie un objet de profil matériel.

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

-ISO

Spécifie un objet ISO.

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

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

-VM

Spécifie un objet de machine virtuelle.

Type:	VM
Position:	Named
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:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-VMMServer

Spécifie un objet serveur VMM.

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

-VMTemplate

Spécifie un objet de modèle VMM utilisé pour créer des machines virtuelles.

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

Sorties

VirtualDVDDrive

Cette applet de commande retourne un objet VirtualDVDDrive.

Notes

Nécessite un objet de machine virtuelle VMM, un objet de modèle de machine virtuelle ou un objet de profil matériel. Vous pouvez récupérer ces objets à l’aide desGet-SCVirtualMachine , Get-SCVMTemplate, ou Get-SCHardwareProfile applets de commande, respectivement.

Partager via

New-SCVirtualDVDDrive

Syntaxe

Description

Exemples

Exemple 1 : Créer un lecteur DE DVD virtuel sur une machine virtuelle

Exemple 2 : Créer un lecteur DE DVD virtuel sur un modèle de machine virtuelle

Exemple 3 : Créer un lecteur DE DVD virtuel sur un profil matériel

Exemple 4 : Créer une machine virtuelle avec un lecteur de DVD virtuel qui se connecte à n’importe quel lecteur de DVD physique disponible sur l’hôte

Exemple 5 : Ajouter un nouveau lecteur DE DVD virtuel à une machine virtuelle existante et attacher un fichier ISO de la bibliothèque au lecteur

Paramètres

-AnyVMHostDrive

-Bus

-HardwareProfile

-ISO

-JobGroup

-JobVariable

-Link

-LUN

-OnBehalfOfUser

-OnBehalfOfUserRole

-PROTipID

-RunAsynchronously

-VM

-VMHostDrive

-VMMServer

-VMTemplate

Sorties

Notes

Ressources supplémentaires

Partager via

New-SCVirtualDVDDrive

Syntaxe

Description

Exemples

Exemple 1 : Créer un lecteur DE DVD virtuel sur une machine virtuelle

Exemple 2 : Créer un lecteur DE DVD virtuel sur un modèle de machine virtuelle

Exemple 3 : Créer un lecteur DE DVD virtuel sur un profil matériel

Exemple 4 : Créer une machine virtuelle avec un lecteur de DVD virtuel qui se connecte à n’importe quel lecteur de DVD physique disponible sur l’hôte

Exemple 5 : Ajouter un nouveau lecteur DE DVD virtuel à une machine virtuelle existante et attacher un fichier ISO de la bibliothèque au lecteur

Paramètres

-AnyVMHostDrive

-Bus

-HardwareProfile

-ISO

-JobGroup

-JobVariable

-Link

-LUN

-OnBehalfOfUser

-OnBehalfOfUserRole

-PROTipID

-RunAsynchronously

-VM

-VMHostDrive

-VMMServer

-VMTemplate

Sorties

Notes

Liens associés

Ressources supplémentaires