Partilhar 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 ficheiro autónomo armazenado na biblioteca 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, a partir de um modelo ou como um ficheiro autónomo armazenado na biblioteca Virtual Machine Manager (VMM).

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

Exemplos

Exemplo 1: Obtenha 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" }

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

Exemplo 2: Obtenha um objeto de disco rígido virtual a partir 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 liga-se ao VMMServer01.

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

Exemplo 3: Obtenha um objeto de disco rígido virtual a partir de um modelo específico

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

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

Parâmetros

-All

Indica que este cmdlet obtém todos os objetos subordinados independentemente do objeto principal. 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 com o qual cada objeto de unidade de disco virtual esteja 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 VMM. Este valor é usado em conjunto com Release, Namespace e Type para estabelecer 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 globalmente único, 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 VMM.

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

-OnBehalfOfUser

Especifica um nome de utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.

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

-OnBehalfOfUserRole

Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.

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

-Release

Especifica uma cadeia que descreve a libertação de um recurso de biblioteca. A VMM cria automaticamente um valor de libertação para cada recurso importado para a biblioteca. Depois de importado o recurso, a cadeia pode 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 VMM.

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

-VMTemplate

Especifica um objeto de modelo 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 devolve um objeto VirtualHardDisk .

Notas

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