Get-VHD

Get-VHD

Gets the virtual hard disk object associated with a virtual hard disk.

Синтаксис

Parameter Set: Path
Get-VHD [-Path] <String[]> [-ComputerName <String[]> ] [ <CommonParameters>]

Parameter Set: Disk
Get-VHD [-DiskNumber] <UInt32> [-ComputerName <String[]> ] [ <CommonParameters>]

Parameter Set: VMId
Get-VHD [-VMId] <Guid[]> [-ComputerName <String[]> ] [ <CommonParameters>]

Подробное описание

The Get-VHD cmdlet gets the virtual hard disk object associated with a virtual hard disk.

Параметры

-ComputerName<String[]>

Specifies one or more Hyper-V hosts on which a virtual hard disk is to be retrieved. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer — use “localhost” or a dot (“.”) to specify the local computer explicitly.

Псевдонимы

отсутствуют

Требуется?

false

Указать положение?

named

Значение по умолчанию

.

Принимать входные данные конвейера?

false

Принимать подстановочные знаки?

false

-DiskNumber<UInt32>

Specifies the disk number associated with the virtual hard disk to be retrieved.

Псевдонимы

отсутствуют

Требуется?

true

Указать положение?

1

Значение по умолчанию

отсутствуют

Принимать входные данные конвейера?

true (ByPropertyName)

Принимать подстановочные знаки?

false

-Path<String[]>

Specifies the path to the virtual hard disk file of the virtual hard disk to be retrieved. If a filename or relative path is specified, the path is calculated relative to the current working directory.

Псевдонимы

отсутствуют

Требуется?

true

Указать положение?

1

Значение по умолчанию

отсутствуют

Принимать входные данные конвейера?

true (ByValue, ByPropertyName)

Принимать подстановочные знаки?

true

-VMId<Guid[]>

Specifies the virtual machine identifier of the virtual machine whose virtual hard disks are to be retrieved.

Псевдонимы

отсутствуют

Требуется?

true

Указать положение?

1

Значение по умолчанию

отсутствуют

Принимать входные данные конвейера?

true (ByValue, ByPropertyName)

Принимать подстановочные знаки?

false

<CommonParameters>

Этот командлет поддерживает следующие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, и -OutVariable. Для получения дополнительных сведений см. about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Входные данные

Тип входных данных — это тип объектов, которые можно передать в командлет через конвейер.

Выходные данные

Тип выходных данных — это тип объектов, которые выдает командлет.

  • VHDObject[]

Примеры

Example 1

Gets the virtual hard disk where the path to the virtual hard disk file is c:\test\testvhdx.vhdx.

PS C:\> Get-VHD –Path c:\test\testvhdx.vhdx

Example 2

Gets the virtual hard disk attached to the system with disk number 6.

PS C:\> Get-VHD –DiskNumber 6

Example 3

Gets the virtual hard disk objects associated with virtual machine TestVM, using the pipeline feature for the VMId parameter.

PS C:\> Get-VM -VMName TestVM | Select-Object VMId | Get-VHD

Example 4

Gets the virtual hard disk objects associated with virtual machine testvm using the pipeline feature for the path parameter.

PS C:\> Get-VM –VMName testvm | Select-Object vmid | Get-VHD

Example 5

Gets the virtual hard disk object for all the virtual hard disk files that are contained in the specified directory and its subdirectories.

PS C:\> Get-ChildItem c:\test –Recurse |% {$_.FullName} | Get-VHD –ErrorAction SilentlyContinue