Partilhar via

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.

Sintaxe

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 Virtual Machine Manager (VMM).

Você pode usar esse cmdlet para conectar uma unidade de DVD virtual a uma unidade de DVD física em um servidor host de máquina virtual, a um local diferente no barramento IDE ou a uma imagem ISO, ou pode usá-lo 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 são as mesmas, independentemente de a plataforma de virtualização do host ser Hyper-V, VMware ou Citrix XenServer. Todas essas plataformas de virtualização suportam o seguinte:

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

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

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

  • Captura "sem mídia" (usado para desconectar uma unidade de DVD virtual da unidade 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:

  • Hyper-V anfitrião. 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 VMware ESX. 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.

Nota: Se a unidade de DVD virtual estiver configurada numa máquina virtual que foi criada utilizando o assistente de Máquina Virtual na Consola do Gestor de Hyper-V em vez de na consola do VMM, tem de especificar uma letra de unidade. Essa letra de 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 que está localizado no Canal Secundário 0 (especificado pelos -Bus 1 e -LUN 0) no barramento IDE no VM01 e armazena o objeto na variável $DVDDrive.

O último comando conecta o objeto de unidade de DVD virtual armazenado no $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 usa atualmente esse arquivo ISO.

Exemplo 2: Conectar uma unidade de DVD virtual a um local diferente no barramento 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 que está localizado no Canal Secundário 0 (especificado pelos -Bus 1 e -LUN 0) no barramento IDE no VM02 e, em seguida, armazena o objeto de unidade de DVD virtual em $DVDDrive.

O último comando conecta o objeto de unidade de DVD virtual armazenado no $DVDDrive a uma posição diferente no barramento IDE definindo o número da unidade lógica (LUN) 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 que está localizado no Canal Secundário 0 (especificado pelos -Bus 1 e -LUN 0) no barramento IDE no VM03 e, em seguida, 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 host ou ISO à qual ele esteja conectado. Ele também exclui qualquer arquivo ISO que a unidade de DVD virtual usou anteriormente se nenhuma outra máquina virtual usa atualmente 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 da unidade de DVD virtual que está localizado no primeiro slot do Canal Secundário (especificado pelos -Bus 1 e -LUN 0) no barramento IDE no 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 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.

Tipo:SwitchParameter
Aliases:AnyHostDrive
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Bus

Especifica o barramento IDE ao qual anexar uma unidade de disco virtual ou unidade de DVD virtual ou o barramento SCSI ao qual anexar uma unidade de disco virtual.

Tipo:Byte
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ISO

Especifica um objeto ISO.

Tipo:ISO
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.

Tipo:Guid
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Link

Indica que um recurso deve ser vinculado em vez de copiado.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LUN

Especifica o número da unidade lógica (LUN) 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.

  • Exemplo de formato: -IDE -Bus 1 -LUN 0
  • Exemplo de formato: -SCSI -Bus 0 -LUN 1
Tipo:Byte
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NoMedia

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUser

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUserRole

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

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SourceBus

Especifica o barramento IDE de origem para a unidade.

Tipo:Byte
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SourceLUN

Especifica o número da unidade lógica (LUN) de origem para um objeto de unidade de DVD virtual em um barramento IDE.

Tipo:Byte
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VirtualDVDDrive

Especifica um objeto de unidade de DVD virtual.

Tipo:VirtualDVDDrive
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VMHostDrive

Especifica uma unidade em um host de máquina virtual.

Exemplos de formatos:

  • Hyper-V disco rígido do host: "C:"
  • Hyper-V unidade de disquete do host: "A:"
  • Disco rígido host VMware ESX: "/dev/tools"
  • Unidade de disquete host VMware ESX: "/dev/sda"
  • Disco rígido host Citrix XenServer: "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
  • Unidade de disquete host Citrix XenServer: não suportada
Tipo:String
Aliases:HostDrive
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

VirtualDVDDrive

Este cmdlet retorna um objeto VirtualDVDDrive.

Notas

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