Get-SCVirtualHardDisk

Referência

Módulo:: VirtualMachineManager

Obtém objetos de disco rígido virtual de uma máquina virtual, de um modelo ou como um arquivo autônomo armazenado na biblioteca do VMM.

Syntax

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

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

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

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -Name <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-Release <String>]
   -FamilyName <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

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

Description

O cmdlet Get-SCVirtualHardDisk obtém objetos de disco rígido virtual de uma máquina virtual, de um modelo ou como um arquivo autônomo armazenado na biblioteca do VMM (Virtual Machine Manager).

Um disco rígido virtual pode ser um arquivo .vhd baseado no Windows, um arquivo .vhd baseado em Citrix XenServer ou um arquivo .vmdk baseado em VMware. Um disco rígido virtual pode ser armazenado como um objeto autônomo na biblioteca do VMM, anexado a uma unidade de disco virtual em um modelo ou anexado a uma unidade de disco virtual em uma máquina virtual implantada ou armazenada.

Exemplos

Exemplo 1: Obter um objeto de disco rígido virtual da biblioteca

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }

Esse comando obtém o objeto de disco rígido virtual chamado VHD01.vhd armazenado em LibraryServer01 e armazena o objeto na variável $VHD.

Exemplo 2: Obter um objeto de disco rígido virtual de uma máquina virtual

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }

O primeiro comando se conecta ao VMMServer01.

O segundo comando obtém o objeto de máquina virtual chamado VM01, seleciona todos os discos rígidos virtuais na VM01 cujo nome inclui a cadeia de caracteres "DataDisk" e armazena os objetos de disco rígido virtual retornados na variável $VHD.

Exemplo 3: Obter um objeto de disco rígido virtual de um modelo específico

PS C:\> Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "Template01"} | Get-SCVirtualHardDisk

Esse comando obtém o objeto de modelo chamado Template01 da biblioteca e exibe todos os objetos de disco rígido virtual nesse modelo.

Parâmetros

-All

Indica que esse cmdlet obtém todos os objetos subordinados independentemente 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.

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

-FamilyName

Especifica um nome de família para um recurso físico na biblioteca do VMM. Esse valor é usado em conjunto com a Versão, o Namespace e o Tipo para estabelecer a equivalência entre os recursos da biblioteca.

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

-ID

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

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

-Name

Especifica o nome de um objeto do VMM.

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

-Release

Especifica uma cadeia de caracteres que descreve a versão de um recurso de biblioteca. O VMM cria automaticamente um valor de versão para cada recurso importado para a biblioteca. Depois que o recurso for importado, a cadeia de caracteres poderá ser personalizada.

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

-VM

Especifica um objeto de máquina 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 usado para criar máquinas virtuais.

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

Saídas

VirtualHardDisk

Este cmdlet retorna um objeto VirtualHardDisk .

Observações

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