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

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 .