Compartilhar via


Get-SCVirtualDiskDrive

Obtém unidades de disco virtual em um modelo de máquina virtual ou em uma máquina virtual.

Sintaxe

All

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

VM

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

Template

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

ID

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

Description

O cmdlet Get-SCVirtualDiskDrive obtém objetos de unidade de disco virtual do VMM (Virtual Machine Manager). Essas unidades de disco virtual podem ser configuradas em modelos de máquina virtual armazenados na biblioteca ou em máquinas virtuais implantadas em um host ou armazenadas na biblioteca.

Exemplos

Exemplo 1: Obter todas as unidades de disco virtual em seu ambiente do VMM

PS C:\> Get-SCVirtualDiskDrive -VMMServer "VMMServer01.Contoso.com" -All

Esse comando obtém todas as unidades de disco virtual associadas a todas as máquinas virtuais registradas no VMM no VMMServer01. O comando exibe informações sobre cada unidade de disco virtual.

Exemplo 2: Obter unidades de disco virtual para uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Where-Object {$_.Name -Eq "VM02"}
PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM $VM
PS C:\> $VirtDiskDrive

O primeiro comando obtém o objeto de máquina virtual chamado VM02 usando o cmdlet Get-SCVirtualMachine . O comando armazena esse objeto na variável $VM.

O segundo comando obtém todos os objetos da unidade de disco virtual na VM02 e armazena esses objetos em $VirtDiskDrive. Se, como este exemplo pressupõe, uma máquina virtual contiver várias unidades de disco virtual, cada unidade de disco virtual terá conectado a ela um disco rígido virtual ou um disco de passagem.

O último comando exibe as propriedades de cada unidade de disco virtual na VM02. Essas informações incluem o nome de todos os discos rígidos virtuais e o caminho da unidade física no host para todos os discos de passagem.

Exemplo 3: Contar unidades de disco virtual, exceto discos de passagem

PS C:\> $VirtDiskDrive = @(Get-SCVirtualDiskDrive -All | Where-Object {$_.BusType -Eq "IDE" -And $_.PassThroughDisk -Eq $Null -And $_.LUN -Eq 1 -And ($_.Bus -Eq 0 -Or $_.Bus -Eq 1)})
PS C:\> $VirtDiskDrive.Count

O primeiro comando obtém os objetos da unidade de disco virtual, excluindo os discos de passagem, que estão conectados ao segundo slot de qualquer canal IDE. O uso do símbolo @ e dos parênteses garante que o comando armazene os resultados em uma matriz, mesmo que o comando retorne um único objeto ou um valor $Null.

O segundo comando exibe o número de objetos de unidade de disco virtual que correspondem aos critérios de filtro.

Exemplo 4: Obter unidades de disco virtual para todos os modelos de máquina virtual

PS C:\> $Templates = @(Get-SCVMTemplate)
PS C:\> $Templates | ForEach-Object {Get-SCVirtualDiskDrive -Template $_ | Where-Object {$_.BusType -Eq "IDE"}} | Format-List Name,BusType,Bus,LUN

O primeiro comando obtém todos os modelos de máquina virtual e, em seguida, armazena esses objetos na matriz $Templates.

O segundo comando passa cada objeto de modelo de máquina virtual armazenado no $Templates para o cmdlet ForEach-Object. Esse cmdlet obtém todos os objetos de unidade de disco para cada modelo. Em seguida, o comando seleciona apenas os objetos de unidade de disco virtual que usam um tipo de barramento IDE e passa esses objetos para o cmdlet Format-List, que exibe o Nome, o Tipo de Barramento, o Barramento e o LUN de cada objeto de unidade de disco virtual.

Parâmetros

-All

Indica que esse cmdlet recupera uma lista completa de todos os objetos de unidade de disco virtual independentemente do objeto pai.

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:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ID

Especifica a ID exclusiva da unidade de disco virtual que esse cmdlet obtém.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ID
Cargo:0
Obrigatório:True
Valor do pipeline:True
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

-VM

Especifica um objeto de máquina virtual do qual esse cmdlet obtém unidades de disco virtual.

Propriedades do parâmetro

Tipo:VM
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

VM
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMMServer

Especifica um objeto de servidor do VMM.

Propriedades do parâmetro

Tipo:ServerConnection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMTemplate

Especifica um objeto de modelo do VMM que é usado para criar máquinas virtuais que contêm unidades de disco virtual que esse cmdlet obtém.

Propriedades do parâmetro

Tipo:Template
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Modelo

Conjuntos de parâmetros

Template
Cargo:Named
Obrigatório:True
Valor do pipeline:True
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

VirtualDiskDrive

Esse cmdlet retorna um objeto VirtualDiskDrive .

Observações

  • Esse cmdlet requer um objeto de modelo de máquina virtual do VMM ou um objeto de máquina virtual, que pode ser recuperado usando o cmdlet Get-SCVMTemplate ou o cmdlet Get-SCVirtualMachine .