Compartilhar via

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.

Sintaxe

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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FamilyName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ID

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

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUser

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 tiver sido importado, a cadeia de caracteres poderá ser personalizada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VM

Especifica um objeto de máquina virtual.

Tipo:VM
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMTemplate

Especifica um objeto de modelo do VMM usado para criar máquinas virtuais.

Tipo:Template
Aliases:Template
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

VirtualHardDisk

Esse 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.