Partilhar via

Get-SCVirtualDVDDrive

Módulo:
VirtualMachineManager Module

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

All 

Get-SCVirtualDVDDrive
    [-VMMServer <ServerConnection>]
    [-All]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

HardwareProfile 

Get-SCVirtualDVDDrive
    -HardwareProfile <HardwareProfile>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

VM 

Get-SCVirtualDVDDrive
    -VM <VM>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Template 

Get-SCVirtualDVDDrive
    -VMTemplate <Template>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ID 

Get-SCVirtualDVDDrive
    [-ID] <Guid>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

O cmdlet Get-SCVirtualDVDDrive obtém um ou mais objetos de unidade de DVD virtual do Virtual Machine Manager (VMM) 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 virtuais 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 de unidade de DVD no VM01 e exibe informações sobre essas unidades de DVD virtuais para o usuário.

Exemplo 2: Obter unidades de DVD virtuais a partir 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 virtuais a partir 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 em 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 independentes 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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

All
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-HardwareProfile

Especifica um objeto de perfil de hardware.

Propriedades dos parâmetros

Tipo:HardwareProfile
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

HardwareProfile
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ID

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

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ID
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-OnBehalfOfUser

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:UserRole
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VM

Especifica um objeto de máquina virtual.

Propriedades dos parâmetros

Tipo:VM
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMMServer

Especifica um objeto de servidor VMM.

Propriedades dos parâmetros

Tipo:ServerConnection
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMTemplate

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

Propriedades dos parâmetros

Tipo:Template
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Modelo

Conjuntos de parâmetros

Template
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

Este cmdlet retorna um objeto VirtualDVDDrive .

Notas

  • 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 os cmdlets Get-SCVirtualMachine, Get-SCVMTemplate ou Get-SCHardwareProfile , respectivamente.