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.

Syntax

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 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 de 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 se conectou a ela, seja 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 qualquer disco rígido virtual e o caminho da unidade física no host para qualquer disco 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 de 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 armazena esses objetos na matriz $Templates.

O segundo comando passa cada objeto de modelo de máquina virtual armazenado em $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 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 independentemente do objeto pai.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ID

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

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VM

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

Type:VM
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Especifica um objeto de servidor do VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:Template
Aliases:Template
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

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 .