New-SCVirtualDVDDrive
Crea un'unità DVD virtuale in una macchina virtuale, un modello di macchina virtuale o un profilo hardware utilizzato in VMM.
Sintassi
JobGroup
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
-JobGroup <Guid>
[-VMMServer <ServerConnection>]
[-Link]
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
HardwareProfile
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
-HardwareProfile <HardwareProfile>
[-Link]
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
VM
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
-VM <VM>
[-Link]
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Template
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
-VMTemplate <Template>
[-Link]
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Descrizione
Il cmdlet New-SCVirtualDVDDrive crea un oggetto unità DVD virtuale in una macchina virtuale, un modello di macchina virtuale o un profilo hardware utilizzato in un ambiente Virtual Machine Manager (VMM). Per impostazione predefinita, l'unità DVD virtuale creata da New-SCVirtualDVDDrive non è collegata ad alcun supporto. È possibile utilizzare il cmdlet Set-SCVirtualDVDDrive per connettere un'unità DVD virtuale a un'unità DVD fisica in un host di una macchina virtuale o a un'immagine ISO.
Nota: è possibile collegare un'unità DVD virtuale a un dispositivo IDE su una macchina virtuale, ma non è possibile collegare un'unità DVD virtuale a un adattatore SCSI su una macchina virtuale.
Esempio
Esempio 1: Creare un'unità DVD virtuale in una macchina virtuale
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualDVDDrive -VM $VM -Bus 1 -LUN 1
Il primo comando ottiene l'oggetto macchina virtuale denominato VM01 e archivia l'oggetto nella variabile $VM.
Il secondo comando crea un'unità DVD virtuale su VM01 e collega l'unità DVD virtuale al canale secondario (1) specificando il bus IDE 1 e il LUN 1.
Esempio 2: Creare un'unità DVD virtuale in un modello di macchina virtuale
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualDVDDrive -VMTemplate $VMTemplate -Bus 1 -LUN 1
Il primo comando ottiene l'oggetto templat della macchina virtuale denominato VMTemplate01 e memorizza l'oggetto nella variabile $Template.
Il secondo comando crea un'unità DVD virtuale su VMTemplate01 che collega un'unità DVD virtuale al canale secondario (1) sul bus IDE quando il modello viene utilizzato per creare una macchina virtuale.
Esempio 3: Creare un'unità DVD virtuale su un profilo hardware
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualDVDDrive -HardwareProfile $HWProfile -Bus 1 -LUN 1
Il primo comando ottiene l'oggetto profilo hardware denominato NewHardwareProfile01 e archivia l'oggetto nella variabile $HWProfile.
Il secondo comando crea un'unità DVD virtuale su HardwareProfile1 che collega un'unità DVD virtuale al canale secondario (1) sul bus IDE quando il profilo hardware viene utilizzato per creare una macchina virtuale.
Esempio 4: Creare una macchina virtuale con un'unità DVD virtuale che si connette a qualsiasi unità DVD fisica disponibile nell'host
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
Il primo comando crea una nuova stringa GUID e la archivia nella variabile $JobGroupID. Questo GUID è un ID gruppo di processi che funge da identificatore che raggruppa i comandi successivi che includono questo identificatore in un singolo gruppo di processi.
Il secondo comando crea un nuovo oggetto unità DVD virtuale e specifica che questa nuova unità DVD virtuale può utilizzare qualsiasi unità DVD fisica disponibile. Il comando collegherà la nuova unità DVD virtuale al primo slot del secondo canale IDE (IDE è l'unico tipo di bus a cui può essere collegata un'unità DVD virtuale). L'utilizzo dell'ID del gruppo di processi specifica che questo comando non viene eseguito fino a poco prima dell'esecuzione del comando finale che include il parametro JobGroup .
Il terzo comando ottiene l'oggetto host denominato VMHost04 e memorizza l'oggetto nella variabile $VMHost.
L'ultimo comando crea una macchina virtuale, la chiama VM04, fornisce una descrizione, assegna un proprietario e specifica la posizione nell'host in cui archiviare la macchina virtuale. Il comando utilizza l'ID del gruppo di processi per eseguire il comando New-SCVirtualDVDDrive appena prima dell'esecuzione del comando New-SCVirtualMachine; l'oggetto unità DVD virtuale risultante è associato alla nuova macchina virtuale.
Esempio 5: Aggiungere una nuova unità DVD virtuale a una macchina virtuale esistente e allegare un file ISO dalla libreria all'unità
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
Il primo comando ottiene l'oggetto macchina virtuale denominato VM05 e archivia l'oggetto nella variabile $VM.
Il secondo comando ottiene l'oggetto ISO denominato WindowsServer2008R2.iso e memorizza l'oggetto nella variabile $ISO.
L'ultimo comando crea una nuova unità DVD virtuale su VM05, la collega alla posizione specificata sul bus IDE e la collega con l'immagine ISO memorizzata in $ISO.
Parametri
-AnyVMHostDrive
Indica che un DVD virtuale o un'unità floppy su una macchina virtuale verrà collegata a qualsiasi unità fisica corrispondente su un host. Questo mapping si verifica quando si distribuisce una macchina virtuale archiviata in un host o quando si utilizza un modello o un profilo hardware per creare e distribuire una macchina virtuale in un host.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | AnyHostDrive |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Bus
Specifica il bus IDE a cui collegare un'unità disco virtuale o un'unità DVD virtuale oppure il bus SCSI a cui collegare un'unità disco virtuale.
Proprietà dei parametri
| Tipo: | Byte |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-HardwareProfile
Specifica un oggetto profilo hardware.
Proprietà dei parametri
| Tipo: | HardwareProfile |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
HardwareProfile
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ISO
Specifica un oggetto ISO.
Proprietà dei parametri
| Tipo: | ISO |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-JobGroup
Specifica un identificatore per una serie di comandi che verranno eseguiti come set subito prima dell'esecuzione del comando finale che include lo stesso identificatore del gruppo di processi.
Proprietà dei parametri
| Tipo: | Guid |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
JobGroup
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-JobVariable
Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Link
Indica che una risorsa deve essere collegata anziché copiata.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-LUN
Specifica il numero di unità logica (LUN) per un oggetto unità disco virtuale o per un oggetto unità DVD virtuale su un bus IDE o per un oggetto unità disco virtuale su un bus SCSI.
- Formato di esempio:
-IDE -Bus 1 -LUN 0 - Formato di esempio:
-SCSI -Bus 0 -LUN 1
Proprietà dei parametri
| Tipo: | Byte |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-OnBehalfOfUser
Specifica un nome utente. Questo cmdlet funziona per conto dell'utente specificato da questo parametro.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-OnBehalfOfUserRole
Specifica un ruolo utente. Per ottenere un ruolo utente, utilizzare il cmdlet Get-SCUserRole . Questo cmdlet funziona per conto del ruolo utente specificato da questo parametro.
Proprietà dei parametri
| Tipo: | UserRole |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PROTipID
Specifica l'ID del suggerimento per le prestazioni e l'ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti pro.
Proprietà dei parametri
| Tipo: | Guid |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RunAsynchronously
Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-VM
Specifica un oggetto macchina virtuale.
Proprietà dei parametri
| Tipo: | VM |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
VM
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-VMHostDrive
Specifica un'unità in un host macchina virtuale.
Formati di esempio:
- Hyper-V disco rigido host:
"C:" - Hyper-V unità floppy host:
"A:" - Disco rigido host VMware ESX:
"/dev/tools" - Unità floppy host VMware ESX:
"/dev/sda" - Disco rigido host Citrix XenServer:
"Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]" - Unità floppy host Citrix XenServer: non supportata
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | HostDrive |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-VMMServer
Specifica un oggetto server VMM.
Proprietà dei parametri
| Tipo: | ServerConnection |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
JobGroup
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-VMTemplate
Specifica un oggetto modello VMM usato per creare macchine virtuali.
Proprietà dei parametri
| Tipo: | Template |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Modello |
Set di parametri
Template
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Output
VirtualDVDDrive
Questo cmdlet restituisce un oggetto VirtualDVDDrive .
Note
- Richiede un oggetto macchina virtuale VMM, un oggetto modello di macchina virtuale o un oggetto profilo hardware. È possibile recuperare questi oggetti utilizzando rispettivamente i cmdlet Get-SCVirtualMachine, Get-SCVMTemplate o Get-SCHardwareProfile .