Partilhar via

Get-SCVirtualDiskDrive

  • Referência
Módulo:
VirtualMachineManager

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

Sintaxe

Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   [-ID] <Guid>
   [-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.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ID

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

Tipo:Guid
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-OnBehalfOfUser

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VM

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

Tipo:VM
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:Template
Aliases:Template
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

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.