Compartilhar via


Get-SCVirtualDVDDrive

Obtém um objeto de unidade de DVD virtual do VMM de uma máquina virtual, um modelo de máquina virtual ou um perfil de hardware.

Sintaxe

Get-SCVirtualDVDDrive
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDVDDrive
   [-VMMServer <ServerConnection>]
   -HardwareProfile <HardwareProfile>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDVDDrive
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDVDDrive
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDVDDrive
   [-VMMServer <ServerConnection>]
   [-ID] <Guid>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Get-SCVirtualDVDDrive obtém um ou mais objetos de unidade de DVD virtual do VMM (Virtual Machine Manager) de um objeto de máquina virtual, um objeto de modelo de máquina virtual ou um objeto de perfil de hardware.

Exemplos

Exemplo 1: Obter unidades de DVD virtual de uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualDVDDrive -VM $VM

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 todos os objetos da unidade de DVD na VM01 e exibe informações sobre essas unidades de DVD virtuais para o usuário.

Exemplo 2: Obter unidades de DVD virtual de um modelo

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualDVDDrive -Template $VMTemplate

O primeiro comando obtém todos os objetos de modelo de máquina virtual armazenados na biblioteca do VMM, seleciona o objeto de modelo chamado VMTemplate01 e armazena o objeto na variável $Template.

O segundo comando obtém todos os objetos de unidade de DVD virtual no VMTemplate01 e exibe informações sobre essas unidades de DVD virtuais para o usuário.

Exemplo 3: Obter unidades de DVD virtual de um perfil de hardware

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualDVDDrive -HardwareProfile $HWProfile

O primeiro comando obtém todos os objetos de perfil de hardware na biblioteca do VMM, seleciona o objeto de perfil chamado NewHWProfile01 e armazena o objeto na variável $HWProfile.

O segundo comando obtém todos os objetos de unidade de DVD virtual no NewHHWProfile01 e exibe informações sobre essas unidades de DVD virtuais para o usuário.

Parâmetros

-All

Indica que esse cmdlet obtém todos os objetos subordinados independentemente do objeto pai. Por exemplo, o comando Get-SCVirtualDiskDrive -All obtém todos os objetos de unidade de disco virtual, independentemente do objeto de máquina virtual ou objeto de modelo ao qual cada objeto de unidade de disco virtual está associado.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-HardwareProfile

Especifica um objeto de perfil de hardware.

Tipo:HardwareProfile
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ID

Especifica o identificador numérico como um identificador global exclusivo, ou GUID, para um objeto específico.

Tipo:Guid
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-OnBehalfOfUser

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VM

Especifica um objeto de máquina virtual.

Tipo:VM
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMTemplate

Especifica um objeto de modelo do VMM usado para criar máquinas virtuais.

Tipo:Template
Aliases:Template
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

VirtualDVDDrive

Esse cmdlet retorna um objeto VirtualDVDDrive.

Observações

  • Requer um objeto de máquina virtual do VMM, um objeto de modelo de máquina virtual ou um objeto de perfil de hardware. Você pode recuperar esses objetos usando o Get-SCVirtualMachine, Get-SCVMTemplateou cmdlets Get-SCHardwareProfile, respectivamente.