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 definir 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.
Capturar 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 de imagem (ISO) armazenado na biblioteca do VMM.
Capturando "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.
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 de Hyper-V em vez de no console do VMM, você deverá 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
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 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 usar esse arquivo ISO no momento.
Exemplo 2: Conectar uma unidade de DVD virtual a um local diferente no barramento IDE
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, 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.
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, 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 no $DVDDrive de qualquer unidade de host ou ISO ao 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 usar esse arquivo ISO no momento.
Exemplo 4: Conectar uma unidade de DVD virtual em uma máquina virtual existente a qualquer unidade de DVD física disponível
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 pelos -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 uma unidade virtual de DVD ou disquete em uma máquina virtual será conectada 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 você usa um modelo ou perfil de hardware para criar e implantar uma máquina virtual em um host.
Propriedades do parâmetro
Tipo:
SwitchParameter
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Aliases:
AnyHostDrive
Conjuntos de parâmetros
AnyHostDriveWithVirtualDVDDriveSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
AnyHostDriveWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
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.
Propriedades do parâmetro
Tipo:
Byte
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-ISO
Especifica um objeto ISO.
Propriedades do parâmetro
Tipo:
ISO
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
ISOWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ISOWithVirtualDVDDriveSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
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 ser executado.
Propriedades do parâmetro
Tipo:
Guid
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
BusChangesWithVirtualDVDDriveSpecified
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
HostDriveWithVirtualDVDDriveSpecified
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
NoMediaWithVirtualDVDDriveSpecified
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
AnyHostDriveWithVirtualDVDDriveSpecified
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ISOWithVirtualDVDDriveSpecified
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-JobVariable
Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por esse parâmetro.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-Link
Indica que um recurso deve ser vinculado em vez de copiado.
Propriedades do parâmetro
Tipo:
SwitchParameter
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
ISOWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ISOWithVirtualDVDDriveSpecified
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
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.
Formato de exemplo: -IDE -Bus 1 -LUN 0
Formato de exemplo: -SCSI -Bus 0 -LUN 1
Propriedades do parâmetro
Tipo:
Byte
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-NoMedia
Desconecta uma unidade de DVD virtual da unidade host ou ISO à qual ela estava conectada ou desconecta uma unidade de disquete virtual da unidade host ou disquete virtual à qual ela estava conectada.
Propriedades do parâmetro
Tipo:
SwitchParameter
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
NoMediaWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
NoMediaWithVirtualDVDDriveSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-OnBehalfOfUser
Especifica um nome de usuário.
Esse cmdlet opera em nome do usuário especificado por esse parâmetro.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
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.
Propriedades do parâmetro
Tipo:
UserRole
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-PROTipID
Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação.
Esse parâmetro permite que você audite dicas pro.
Propriedades do parâmetro
Tipo:
Guid
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
Propriedades do parâmetro
Tipo:
SwitchParameter
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-SourceBus
Especifica o barramento IDE de origem para a unidade.
Propriedades do parâmetro
Tipo:
Byte
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
NoMediaWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ISOWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
HostDriveWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
AnyHostDriveWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
BusChangesWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
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.
Propriedades do parâmetro
Tipo:
Byte
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
NoMediaWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ISOWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
HostDriveWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
AnyHostDriveWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
BusChangesWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-VirtualDVDDrive
Especifica um objeto de unidade de DVD virtual.
Propriedades do parâmetro
Tipo:
VirtualDVDDrive
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
BusChangesWithVirtualDVDDriveSpecified
Cargo:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
HostDriveWithVirtualDVDDriveSpecified
Cargo:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
NoMediaWithVirtualDVDDriveSpecified
Cargo:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
AnyHostDriveWithVirtualDVDDriveSpecified
Cargo:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ISOWithVirtualDVDDriveSpecified
Cargo:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-VMHostDrive
Especifica uma unidade em um host de máquina virtual.
Formatos de exemplo:
Hyper-V disco rígido do host: "C:"
Hyper-V unidade de disquete do host: "A:"
Disco rígido do host VMware ESX: "/dev/tools"
Unidade de disquete do host VMware ESX: "/dev/sda"
Disco rígido do host Citrix XenServer: "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
Unidade de disquete do host Citrix XenServer: Não suportado
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Aliases:
HostDrive
Conjuntos de parâmetros
HostDriveWithVirtualDVDDriveSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
HostDriveWithSourceBusAndLunSpecified
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
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 .