Set-SCVirtualDVDDrive
Modifica le proprietà di un'unità DVD virtuale associata a una macchina virtuale, a un modello di macchina virtuale o a un profilo hardware usato in VMM.
Sintassi
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>]
Descrizione
Il cmdlet Set-SCVirtualDRIVE modifica una o più proprietà di un oggetto unità DVD virtuale associato a una macchina virtuale, a un modello di macchina virtuale o a un profilo hardware usato in un ambiente VMM (Virtual Machine Manager).
È possibile usare questo cmdlet per connettere un'unità DVD virtuale a un'unità DVD fisica in un server host di macchine virtuali, a un percorso diverso nel bus IDE o a un'immagine ISO oppure per disconnettere l'unità DVD virtuale.
La maggior parte delle impostazioni che è possibile configurare per un'unità DVD virtuale in una macchina virtuale è identica indipendentemente dal fatto che la piattaforma di virtualizzazione dell'host sia Hyper-V, VMware o Citrix XenServer. Tutte queste piattaforme di virtualizzazione supportano quanto segue:
Connessione di un'unità DVD virtuale a un canale primario o secondario in un host.
Acquisizione di informazioni da un'unità CD o DVD fisica nell'host senza specificare una lettera di unità.
Acquisizione di informazioni da un file di immagine (ISO) archiviato nella libreria VMM.
Acquisizione di "nessun supporto" (usata per disconnettere un'unità DVD virtuale dall'unità host o da un file ISO).
L'unica impostazione che varia per questo cmdlet in base alla piattaforma di virtualizzazione è se un file ISO può essere usato direttamente dalla libreria VMM:
Hyper-V host. Se si configura una connessione a un file ISO nella libreria VMM, è possibile scegliere di usare l'ISO direttamente dalla libreria anziché copiarlo nell'host.
Host VMware ESX. Se si configura una connessione a un file ISO nella libreria VMM, non è possibile usare l'ISO direttamente dalla libreria, ma deve invece accettare l'impostazione predefinita, che copia il file ISO nell'host.
Host Citrix XenServer. Se si configura una connessione a un file ISO nella libreria VMM, non è possibile usare l'ISO direttamente dalla libreria, ma deve invece accettare l'impostazione predefinita, che copia il file ISO nell'host. L'host deve avere almeno un repository ISO disponibile con accesso in scrittura e spazio di archiviazione sufficiente per contenere il file ISO.
Nota: se l'unità DVD virtuale è configurata in una macchina virtuale creata tramite la procedura guidata Macchina virtuale nella console di Hyper-V Manager anziché nella console VMM, è necessario specificare una lettera di unità. Tale lettera di unità verrà visualizzata nelle proprietà della macchina virtuale nella console VMM.
Esempio
Esempio 1: Connettere un'unità DVD virtuale a un'unità DVD fisica
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:"
Il primo comando ottiene l'oggetto macchina virtuale denominato VM01 e archivia l'oggetto nella variabile $VM.
Il secondo comando ottiene l'oggetto unità DVD virtuale che si trova nel canale secondario 0 (specificato da -Bus 1 e -LUN 0) nel bus IDE in VM01 e archivia l'oggetto nella variabile $DVDDrive.
L'ultimo comando connette l'oggetto unità DVD virtuale archiviato in $DVDDrive a un'unità fisica nell'host (unità D: ). Elimina anche qualsiasi file ISO usato in precedenza dall'unità DVD virtuale se nessun'altra macchina virtuale usa attualmente tale file ISO.
Esempio 2: Connettere un'unità DVD virtuale a una posizione diversa nel 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
Il comando ottiene l'oggetto macchina virtuale denominato VM02 e archivia l'oggetto nella variabile $VM.
Il secondo comando ottiene l'oggetto unità DVD virtuale che si trova nel canale secondario 0 (specificato da -Bus 1 e -LUN 0) nel bus IDE in VM02 e quindi archivia l'oggetto unità DVD virtuale in $DVDDrive.
L'ultimo comando connette l'oggetto unità DVD virtuale archiviato in $DVDDrive a una posizione diversa nel bus IDE impostando il numero di unità logica (LUN) su 1.
Esempio 3: Disconnettere un'unità DVD virtuale
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
Il primo comando ottiene l'oggetto macchina virtuale denominato VM03 e archivia l'oggetto nella variabile $VM.
Il secondo comando ottiene l'oggetto unità DVD virtuale che si trova sul canale secondario 0 (specificato da -Bus 1 e -LUN 0) nel bus IDE in VM03 e quindi archivia l'oggetto unità DVD virtuale in $DVDDrive.
L'ultimo comando usa il parametro NoMedia per disconnettere l'oggetto unità DVD virtuale archiviato in $DVDDrive da qualsiasi unità host o ISO a cui è connesso. Elimina anche qualsiasi file ISO usato in precedenza dall'unità DVD virtuale se nessun'altra macchina virtuale usa attualmente tale file ISO.
Esempio 4: Connettere un'unità DVD virtuale in una macchina virtuale esistente a qualsiasi unità DVD fisica disponibile
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})
Il primo comando ottiene l'oggetto macchina virtuale denominato VM04 e archivia l'oggetto nella variabile $VM.
L'ultimo comando ottiene l'oggetto unità DVD virtuale che si trova nel primo slot del canale secondario (specificato da -Bus 1 e -LUN 0) nel bus IDE in VM04.
Il comando usa il cmdlet Set-SCVirtualDRIVE
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: | True |
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: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ISO
Specifica un oggetto ISO.
Tipo: | ISO |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
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: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-NoMedia
Disconnette un'unità DVD virtuale dall'unità host o ISO a cui è stata connessa o disconnette un'unità floppy virtuale dall'unità host o dal disco floppy virtuale a cui è stata connessa.
Tipo: | SwitchParameter |
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 |
-SourceBus
Specifica il bus dell'IDE di origine per l'unità.
Tipo: | Byte |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-SourceLUN
Specifica il numero di unità logica di origine (LUN) per un oggetto unità DVD virtuale in un bus IDE.
Tipo: | Byte |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-VirtualDVDDrive
Specifica un oggetto unità DVD virtuale.
Tipo: | VirtualDVDDrive |
Posizione: | 0 |
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: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
Output
VirtualDVDDrive
Questo cmdlet restituisce un oggetto VirtualDRIVE
Note
- Richiede un oggetto unità DVD virtuale VMM, che può essere recuperato usando il cmdlet get-SCVirtualDRIVE get-SCVirtualDRIVE.