Get-VHD

Get-VHD

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

语法

Parameter Set: Path
Get-VHD [-Path] <String[]> [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [ <CommonParameters>]

Parameter Set: Disk
Get-VHD [-DiskNumber] <UInt32> [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [ <CommonParameters>]

Parameter Set: VMId
Get-VHD [-VMId] <Guid[]> [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [ <CommonParameters>]

详细说明

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

参数

-CimSession<Microsoft.Management.Infrastructure.CimSession[]>

在远程会话中或远程计算机上运行该 cmdlet。输入计算机名或会话对象，如 New-cimsession 或 Get-cimsession cmdlet 的输出。默认为本地计算机上的当前会话。

别名	none
是否必需？	false
在哪里？	named
默认值	none
是否接受管道输入？	false
是否接受通配符？	false

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

别名	none
是否必需？	false
在哪里？	named
默认值	none
是否接受管道输入？	false
是否接受通配符？	false

-Credential<System.Management.Automation.PSCredential[]>

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

别名	none
是否必需？	false
在哪里？	named
默认值	none
是否接受管道输入？	false
是否接受通配符？	false

-DiskNumber<UInt32>

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

别名	Number
是否必需？	true
在哪里？	1
默认值	none
是否接受管道输入？	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.

别名	FullName
是否必需？	true
在哪里？	1
默认值	none
是否接受管道输入？	true (ByValue, ByPropertyName)
是否接受通配符？	false

-VMId<Guid[]>

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

别名	Id
是否必需？	true
在哪里？	1
默认值	none
是否接受管道输入？	true (ByValue, ByPropertyName)
是否接受通配符？	false

<CommonParameters>

此 cmdlet 支持常见的参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 TechNet 上的 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

输入

输入类型是可以传送到 cmdlet 的对象的类型。

输出

输出类型是 cmdlet 发出的对象的类型。

• 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