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 (https://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