Partilhar 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 Virtual Machine Manager (VMM). 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 no ambiente do VMM

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

Este comando obtém todas as unidades de disco virtual vinculadas 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 de unidade de disco virtual no VM02 e armazena esses objetos em $VirtDiskDrive. Se, como este exemplo assume, uma máquina virtual contém várias unidades de disco virtual, cada unidade de disco virtual se conectou a ela um disco rígido virtual ou um disco de passagem.

O último comando exibe as propriedades de cada unidade de disco virtual no VM02. Essas informações incluem o nome de quaisquer discos rígidos virtuais e o caminho da unidade física no host para quaisquer 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 discos de passagem, que estão conectados ao segundo slot de qualquer canal IDE. Usar o símbolo @ e 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, Tipo de barramento, Barramento e LUN para 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 independentes do objeto pai.

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

-ID

Especifica a ID exclusiva da unidade de disco virtual obtida por esse cmdlet.

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 do qual esse cmdlet obtém unidades de disco 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 que é usado para criar máquinas virtuais que contêm unidades de disco virtual obtidas por esse cmdlet.

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

VirtualDiskDrive

Este cmdlet retorna um objeto VirtualDiskDrive .

Notas

  • Este 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 .