New-SCVirtualDVDDrive
Crée un lecteur de DVD virtuel sur une machine virtuelle, un modèle de machine virtuelle ou un profil matériel utilisé dans VMM.
Syntax
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
L’applet de commande New-SCVirtualDVDDrive crée un objet de lecteur DE 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 de DVD virtuel à un lecteur de 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 1La 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 1La première commande obtient l’objet de modèle 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 1La 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 $JobGroupIdLa première commande crée une nouvelle chaîne GUID et la stocke dans la variable $JobGroupID. Ce GUID est un ID de groupe de travaux qui fait office d’identificateur regroupant en un seul groupe de travaux les commandes suivantes qui incluent cet identificateur.
La deuxième commande crée un nouvel objet lecteur de DVD virtuel et spécifie que ce nouveau lecteur de DVD virtuel puisse utiliser tout lecteur de DVD physique disponible. La commande attachera 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 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 1La 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 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: | False |
| 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: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HardwareProfile
Spécifie un objet profil matériel.
| Type: | HardwareProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ISO
Spécifie un objet ISO.
| Type: | ISO |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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: | 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 |
-VM
Spécifie un objet ordinateur virtuel.
| Type: | VM |
| Position: | Named |
| 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Spécifie un objet serveur VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMTemplate
Spécifie un objet modèle VMM utilisé pour créer des ordinateurs virtuels.
| Type: | Template |
| Aliases: | Template |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 des applets de commande Get-SCVirtualMachine, Get-SCVMTemplate ou Get-SCHardwareProfile , respectivement.