Set-SCVirtualDVDDrive

  • Referência
Módulo:
VirtualMachineManager

Altera as propriedades de uma unidade de DVD virtual associada a uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado no 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 em um ambiente do VMM (Virtual Machine Manager).

Você pode usar esse cmdlet para conectar uma unidade de DVD virtual a uma unidade de DVD física em um servidor de host de máquina virtual, a um local diferente no barramento do IDE ou a uma imagem ISO ou pode usá-la para desconectar a unidade de DVD virtual.

A maioria das configurações que você pode configurar para uma unidade de DVD virtual em uma máquina virtual é a mesma, independentemente de a plataforma de virtualização do host ser Hyper-V, VMware ou Citrix XenServer. Todas essas plataformas de virtualização dão suporte ao seguinte:

  • Conectando uma unidade de DVD virtual a um canal primário ou secundário em um host.

  • Capturando informações de uma unidade física de CD ou DVD no host sem especificar uma letra de unidade.

  • Capturando informações de um arquivo ISO (imagem) armazenado na biblioteca do VMM.

  • Capturando "sem mídia" (usado para desconectar uma unidade de DVD virtual da unidade de host ou de um arquivo ISO).

A única configuração que varia para esse cmdlet por plataforma de virtualização é se um arquivo ISO pode ser usado diretamente da biblioteca do VMM:

  • Host Hyper-V. Se você configurar uma conexão com um arquivo ISO na biblioteca do VMM, poderá optar por usar o ISO diretamente da biblioteca em vez de copiá-lo para o host.

  • Host ESX do VMware. Se você configurar uma conexão com um arquivo ISO na biblioteca do VMM, não poderá usar o ISO diretamente da biblioteca, mas deverá aceitar o padrão, que copia o arquivo ISO para o host.

  • Host Citrix XenServer. Se você configurar uma conexão com um arquivo ISO na biblioteca do VMM, não poderá usar o ISO diretamente da biblioteca, mas deverá aceitar o padrão, que copia o arquivo ISO para o host. O host deve ter pelo menos um repositório ISO disponível com acesso de gravação e espaço de armazenamento suficiente para conter o arquivo ISO.

Observação: se a unidade de DVD virtual estiver configurada em uma máquina virtual que foi criada usando o assistente de Máquina Virtual no Console do Gerenciador do Hyper-V em vez de no console do VMM, você deverá especificar uma letra de unidade. Essa letra da unidade aparecerá nas Propriedades dessa máquina virtual no console do VMM.

Exemplos

Exemplo 1: conectar uma unidade de DVD virtual a uma unidade de DVD física

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 obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto de unidade de DVD virtual localizado no Canal Secundário 0 (especificado por -Bus 1 e -LUN 0) no barramento IDE na VM01 e armazena o objeto na variável $DVDDrive.

O último comando conecta o objeto de unidade de DVD virtual armazenado em $DVDDrive a uma unidade física no host (a unidade D:). Ele também exclui qualquer arquivo ISO que a unidade de DVD virtual usou anteriormente se nenhuma outra máquina virtual atualmente usa esse arquivo ISO.

Exemplo 2: conectar uma unidade de DVD virtual a um local diferente no barramento do 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 de máquina virtual chamado VM02 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto de unidade de DVD virtual localizado no Canal Secundário 0 (especificado por -Bus 1 e -LUN 0) no barramento IDE na VM02 e armazena o objeto de unidade de DVD virtual em $DVDDrive.

O último comando conecta o objeto de unidade de DVD virtual armazenado em $DVDDrive a uma posição diferente no barramento IDE definindo o LUN (número de unidade lógica) como 1.

Exemplo 3: desconectar uma unidade de DVD virtual

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 obtém o objeto de 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 localizado no Canal Secundário 0 (especificado por -Bus 1 e -LUN 0) no barramento IDE na VM03 e armazena o objeto de unidade de DVD virtual em $DVDDrive.

O último comando usa o parâmetro NoMedia para desconectar o objeto de unidade de DVD virtual armazenado em $DVDDrive de qualquer unidade de host ou ISO à qual ele está conectado. Ele também exclui qualquer arquivo ISO que a unidade de DVD virtual usou anteriormente se nenhuma outra máquina virtual atualmente usa esse arquivo ISO.

Exemplo 4: conectar uma unidade de DVD virtual em uma máquina virtual existente a qualquer unidade de DVD física 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 obtém o objeto de máquina virtual chamado VM04 e armazena o objeto na variável $VM.

O último comando obtém o objeto de unidade de DVD virtual localizado no primeiro slot do Canal Secundário (especificado por -Bus 1 e -LUN 0) no barramento IDE na VM04. O comando usa o cmdlet Set-SCVirtualDVDDrive com o parâmetro AnyVMHostDrive para conectar a unidade de DVD virtual a qualquer unidade de DVD física disponível no host.

Parâmetros

-AnyVMHostDrive

Indica que um DVD virtual ou uma unidade de disquete em uma máquina virtual será conectado a qualquer unidade física correspondente em um host. Esse mapeamento ocorre quando você implanta uma máquina virtual armazenada em um host ou quando usa um modelo ou perfil de hardware para criar e implantar uma máquina virtual em um host.

Type:SwitchParameter
Aliases:AnyHostDrive
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Bus

Especifica o barramento IDE ao qual anexar uma unidade de disco virtual ou uma unidade de DVD virtual ou o barramento SCSI ao qual anexar 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 serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho executado.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse 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 vinculado em vez de copiado.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LUN

Especifica o LUN (número de unidade lógica) para um objeto de unidade de disco virtual ou para um objeto de unidade de DVD virtual em um barramento IDE ou para um objeto de unidade de disco virtual em um barramento 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

Desconecta uma unidade de DVD virtual da unidade de host ou ISO à qual ela estava conectada ou desconecta uma unidade de disquete virtual da unidade de host ou do disquete virtual ao qual estava conectada.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole . Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceBus

Especifica o barramento 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 LUN (número da unidade lógica de origem) para um objeto de unidade de DVD virtual em um barramento 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 em um host de máquina virtual.

Formatos de exemplo:

  • Disco rígido do host Hyper-V: "C:"
  • Unidade de disquete do host Hyper-V: "A:"
  • Disco rígido do host ESX do VMware: "/dev/tools"
  • Unidade de disquete de host do VMware ESX: "/dev/sda"
  • Disco rígido do host do Citrix XenServer: "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
  • Unidade de disquete do host Citrix XenServer: não há suporte
Type:String
Aliases:HostDrive
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Saídas

VirtualDVDDrive

Esse cmdlet retorna um objeto VirtualDVDDrive .

Observações

  • Requer um objeto de unidade de DVD virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualDVDDrive .