New-SCVirtualDVDDrive
Crea un'unità DVD virtuale in una macchina virtuale, un modello di macchina virtuale o un profilo hardware usato in VMM.
Sintassi
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>]
Descrizione
Il cmdlet New-SCVirtualDRIVE
Nota: è possibile connettere un'unità DVD virtuale a un dispositivo IDE in una macchina virtuale, ma non è possibile connettere un'unità DVD virtuale a una scheda SCSI in 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 in VM01 e collega l'unità DVD virtuale al canale secondario (1) specificando il bus IDE 1 e 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 archivia l'oggetto nella variabile $Template.
Il secondo comando crea un'unità DVD virtuale in VMTemplate01 che collega un'unità DVD virtuale al canale secondario (1) nel bus IDE quando il modello viene usato per creare una macchina virtuale.
Esempio 3: Creare un'unità DVD virtuale in 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 in HardwareProfile1 che collega un'unità DVD virtuale al canale secondario (1) nel bus IDE quando viene usato il profilo hardware 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 in una 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ò usare qualsiasi unità DVD fisica disponibile. Il comando collega la nuova unità DVD virtuale al primo slot del secondo canale IDE (IDE è l'unico tipo di bus a cui è possibile collegare un'unità DVD virtuale). L'uso dell'ID del gruppo di processi specifica che questo comando non viene eseguito solo prima dell'esecuzione del comando finale che include il parametro JobGroup.
Il terzo comando ottiene l'oggetto host denominato VMHost04 e archivia l'oggetto nella variabile $VMHost.
L'ultimo comando crea una macchina virtuale, lo denomina VM04, fornisce una descrizione, assegna un proprietario e specifica il percorso nell'host per archiviare la macchina virtuale.
Il comando usa l'ID del gruppo di processi per eseguire il comando New-SCVirtualDRIVE
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 archivia l'oggetto nella variabile $ISO.
L'ultimo comando crea una nuova unità DVD virtuale in VM05, la collega alla posizione specificata nel bus IDE e la collega all'immagine ISO archiviata in $ISO.
Parametri
-AnyVMHostDrive
Indica che un DVD virtuale o un'unità floppy in una macchina virtuale verrà connessa a qualsiasi unità fisica corrispondente in un host. Questo mapping si verifica quando si distribuisce una macchina virtuale archiviata in un host o quando si usa un modello o un profilo hardware per creare e distribuire una macchina virtuale in un host.
Tipo: | SwitchParameter |
Alias: | AnyHostDrive |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Bus
Specifica il bus IDE a cui collegare un'unità disco virtuale o un'unità DVD virtuale o il bus SCSI a cui collegare un'unità disco virtuale.
Tipo: | Byte |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-HardwareProfile
Specifica un oggetto profilo hardware.
Tipo: | HardwareProfile |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-ISO
Specifica un oggetto ISO.
Tipo: | ISO |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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.
Tipo: | Guid |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-JobVariable
Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Link
Indica che una risorsa deve essere collegata a anziché copiata.
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-LUN
Specifica il numero di unità logica (LUN) per un oggetto unità disco virtuale o per un oggetto unità DVD virtuale in un bus IDE o per un oggetto unità disco virtuale in un bus SCSI.
- Formato di esempio:
-IDE -Bus 1 -LUN 0
- Formato di esempio:
-SCSI -Bus 0 -LUN 1
Tipo: | Byte |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-OnBehalfOfUser
Specifica un nome utente. Questo cmdlet opera per conto dell'utente specificato da questo parametro.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-OnBehalfOfUserRole
Specifica un ruolo utente.
Per ottenere un ruolo utente, usare il cmdlet Get-SCUserRole
Tipo: | UserRole |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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.
Tipo: | Guid |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-RunAsynchronously
Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-VM
Specifica un oggetto macchina virtuale.
Tipo: | VM |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-VMHostDrive
Specifica un'unità in un host di macchine virtuali.
Formati di esempio:
- disco rigido host Hyper-V:
"C:"
- unità floppy host Hyper-V:
"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
Tipo: | String |
Alias: | HostDrive |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-VMMServer
Specifica un oggetto server VMM.
Tipo: | ServerConnection |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-VMTemplate
Specifica un oggetto modello VMM usato per creare macchine virtuali.
Tipo: | Template |
Alias: | Template |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
Output
VirtualDVDDrive
Questo cmdlet restituisce un oggetto VirtualDRIVE
Note
- Richiede un oggetto macchina virtuale VMM, un oggetto modello di macchina virtuale o un oggetto profilo hardware. È possibile recuperare questi oggetti usando il Get-SCVirtualMachine, Get-SCVMTemplateo rispettivamente i cmdlet Get-SCHardwareProfile.