Set-SCVirtualDVDDrive
Altera as propriedades de uma unidade virtual de DVD associada a uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado em VMM.
Syntax
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>]
Description
O cmdlet Set-SCVirtualDVDDrive altera uma ou mais propriedades de um objeto de unidade de DVD virtual associado a uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado num ambiente virtual de Gestor de Máquinas (VMM).
Pode utilizar este cmdlet para ligar uma unidade de DVD virtual a uma unidade de DVD físico num servidor de anfitrião de máquinas virtuais, a um local diferente no autocarro IDE ou a uma imagem ISO, ou pode usá-lo para desligar a unidade virtual de DVD.
A maioria das configurações que pode configurar para uma unidade de DVD virtual numa máquina virtual são as mesmas, independentemente de a plataforma de virtualização do hospedeiro ser Hyper-V, VMware ou Citrix XenServer. Todas estas plataformas de virtualização suportam o seguinte:
Ligar uma unidade de DVD virtual a um canal primário ou secundário num hospedeiro.
Capturando informações de um CD físico ou unidade de DVD no anfitrião sem especificar uma letra de unidade.
Captura de informação a partir de um ficheiro de imagem (ISO) armazenado na biblioteca VMM.
Capturar "no media" (usado para desligar uma unidade virtual de DVD da unidade do anfitrião ou de um ficheiro ISO).
A única configuração que varia para este cmdlet por plataforma de virtualização é se um ficheiro ISO pode ser usado diretamente a partir da biblioteca VMM:
Hospedeiro hiper-V. Se configurar uma ligação a um ficheiro ISO na biblioteca VMM, pode optar por utilizar o ISO diretamente da biblioteca em vez de o copiar para o anfitrião.
VMware ESX anfitrião. Se configurar uma ligação a um ficheiro ISO na biblioteca VMM, não pode utilizar o ISO diretamente da biblioteca, mas deve, em vez disso, aceitar o predefinido, que copia o ficheiro ISO ao anfitrião.
Citrix XenServer anfitrião. Se configurar uma ligação a um ficheiro ISO na biblioteca VMM, não pode utilizar o ISO diretamente da biblioteca, mas deve, em vez disso, aceitar o predefinido, que copia o ficheiro ISO ao anfitrião. O hospedeiro deve ter pelo menos um repositório ISO disponível com acesso por escrito e espaço de armazenamento suficiente para conter o ficheiro ISO.
Nota: Se a unidade virtual de DVD estiver configurada numa máquina virtual criada utilizando o assistente de Máquina Virtual na Consola Hyper-V Manager e não na consola VMM, deve especificar uma letra de unidade. Esta carta de unidade aparecerá nas propriedades para a máquina virtual na consola VMM.
Exemplos
Exemplo 1: Ligue uma unidade virtual de DVD a uma unidade de DVD físico
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:"
O primeiro comando recebe o objeto da máquina virtual chamado VM01 e armazena o objeto na variável $VM.
O segundo comando obtém o objeto de unidade dvd virtual que está localizado no Canal Secundário 0 (especificado por -Bus 1 e -LUN 0) no ônibus IDE em VM01 e armazena o objeto na variável $DVDDrive.
O último comando liga o objeto de acionamento virtual do DVD armazenado em $DVDDrive a uma unidade física no hospedeiro (o D: unidade). Também elimina qualquer ficheiro ISO que a unidade de DVD virtual utilizada anteriormente se nenhuma outra máquina virtual utilizar atualmente esse ficheiro ISO.
Exemplo 2: Ligue uma unidade de DVD virtual a um local diferente no ônibus 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
O comando obtém o objeto da máquina virtual chamado VM02 e armazena o objeto na variável $VM.
O segundo comando obtém o objeto de unidade virtual de DVD que está localizado no Canal Secundário 0 (especificado por -Bus 1 e -LUN 0) no autocarro IDE em VM02 e, em seguida, armazena o objeto de unidade virtual de DVD em $DVDDrive.
O último comando liga o objeto de acionamento virtual do DVD armazenado em $DVDDrive a uma posição diferente no ônibus IDE, definindo o número da unidade lógica (LUN) para 1.
Exemplo 3: Desligue uma unidade virtual de DVD
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
O primeiro comando recebe o objeto da máquina virtual chamado VM03 e armazena o objeto na variável $VM.
O segundo comando obtém o objeto de unidade de DVD virtual que está localizado no Canal Secundário 0 (especificado por -Bus 1 e -LUN 0) no autocarro IDE em VM03 e, em seguida, armazena o objeto de unidade virtual de DVD em $DVDDrive.
O último comando utiliza o parâmetro NoMedia para desligar o objeto de acionamento dvd virtual armazenado em $DVDDrive de qualquer unidade de hospedeiro ou ISO ao qual está ligado. Também elimina qualquer ficheiro ISO que a unidade de DVD virtual utilizada anteriormente se nenhuma outra máquina virtual utilizar atualmente esse ficheiro ISO.
Exemplo 4: Ligue uma unidade virtual de DVD numa máquina virtual existente a qualquer unidade de DVD físico disponível
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})
O primeiro comando recebe o objeto da máquina virtual chamado VM04 e armazena o objeto na variável $VM.
O último comando obtém o objeto de unidade virtual de DVD que está localizado na primeira ranhura do Canal Secundário (especificado por -Bus 1 e -LUN 0) no autocarro IDE em VM04. O comando utiliza o cmdlet Set-SCVirtualDVDDrive com o parâmetro AnyVMHostDrive para ligar a unidade virtual de DVD a qualquer unidade de DVD físico disponível no anfitrião.
Parâmetros
-AnyVMHostDrive
Indica que um DVD virtual ou uma unidade floppy numa máquina virtual serão ligados a qualquer unidade física correspondente num hospedeiro. Este mapeamento ocorre quando implementa uma máquina virtual armazenada num hospedeiro ou quando utiliza um modelo ou perfil de hardware para criar e implantar uma máquina virtual num anfitrião.
Type: | SwitchParameter |
Aliases: | AnyHostDrive |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Bus
Especifica o ônibus IDE para anexar uma unidade de disco virtual ou unidade de DVD virtual, ou o ônibus SCSI ao qual se pode ligar uma unidade de disco virtual.
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ISO
Especifica um objeto ISO.
Type: | ISO |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-JobGroup
Especifica um identificador para uma série de comandos que funcionarão como um conjunto pouco antes do comando final que inclui o mesmo identificador do grupo de trabalho.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por este parâmetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Link
Indica que um recurso deve ser ligado em vez de copiado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LUN
Especifica o número da unidade lógica (LUN) para um objeto de acionamento de disco virtual ou para um objeto de unidade de DVD virtual num autocarro IDE ou para um objeto de unidade de disco virtual num autocarro SCSI.
- Formato de exemplo:
-IDE -Bus 1 -LUN 0
- Formato de exemplo:
-SCSI -Bus 0 -LUN 1
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoMedia
Desliga uma unidade de DVD virtual da unidade de anfitrião ou ISO à qual foi ligada, ou desliga uma unidade virtual floppy da unidade do anfitrião ou do disco de dissiudo virtual ao qual estava ligado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica um nome de utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceBus
Especifica o ônibus IDE de origem para a unidade.
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceLUN
Especifica o número da unidade lógica de origem (LUN) para um objeto de unidade de DVD virtual num autocarro IDE.
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualDVDDrive
Especifica um objeto de unidade de DVD virtual.
Type: | VirtualDVDDrive |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMHostDrive
Especifica uma unidade num anfitrião de máquina virtual.
Formatos de exemplo:
- Disco rígido de anfitrião Hiper-V:
"C:"
- Unidade floppy do anfitrião hiper-V:
"A:"
- Disco rígido de anfitrião VMware ESX:
"/dev/tools"
- Unidade floppy do anfitrião VMware ESX:
"/dev/sda"
- Citrix XenServer anfitrião disco rígido:
"Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
- Citrix XenServer anfitrião unidade floppy: Não suportado
Type: | String |
Aliases: | HostDrive |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Saídas
VirtualDVDDrive
Este cmdlet devolve um objeto VirtualDVDDrive .
Notas
- Requer um objeto de unidade virtual de DVD VMM, que pode ser recuperado utilizando o cmdlet Get-SCVirtualDVDDrive .