Get-SCVirtualHardDisk
从虚拟机、模板或作为存储在 VMM 库中的独立文件获取虚拟机中的虚拟硬盘对象。
语法
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>] 说明
Get-SCVirtualHardDisk cmdlet 从虚拟机、模板或作为存储在 Virtual Machine Manager (VMM) 库中的独立文件获取虚拟硬盘对象。
虚拟硬盘可以是基于 Windows 的 .vhd 文件、基于 Citrix XenServer 的 .vhd 文件或基于 VMware 的.vmdk 文件。 虚拟硬盘可以存储为 VMM 库中的独立对象、附加到模板上的虚拟磁盘驱动器或附加到已部署或存储的虚拟机上的虚拟磁盘驱动器。
示例
示例 1：从库获取虚拟硬盘对象
PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }此命令获取存储在 LibraryServer01 上的名为 VHD01.vhd 的虚拟硬盘对象，然后将该对象存储在$VHD变量中。
示例 2：从虚拟机获取虚拟硬盘对象
PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }第一个命令连接到 VMMServer01。
第二个命令获取名为 VM01 的虚拟机对象，选择其名称包括字符串“DataDisk”的 VM01 上的所有虚拟硬盘，然后将返回的虚拟硬盘对象存储在$VHD变量中。
示例 3：从特定模板获取虚拟硬盘对象
PS C:\> Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "Template01"} | Get-SCVirtualHardDisk此命令从库获取名为 Template01 的模板对象，并在该模板上显示所有虚拟硬盘对象。
参数
-All
指示此 cmdlet 获取与父对象无关的所有从属对象。
例如，该命令 Get-SCVirtualDiskDrive -All 获取所有虚拟磁盘驱动器对象，而不考虑每个虚拟磁盘驱动器对象关联的虚拟机对象或模板对象。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FamilyName
指定 VMM 库中物理资源的系列名称。 此值与 Release、Namespace 和 Type 结合使用，在库资源之间建立等效性。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
将数字标识符指定为特定对象的全局唯一标识符或 GUID。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定 VMM 对象的名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
指定用户名。 此 cmdlet 代表此参数指定的用户运行。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
指定用户角色。 若要获取用户角色，请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色运行。
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Release
指定描述库资源的发布的字符串。 VMM 会自动为导入库的每个资源创建发布值。 导入资源后，可以自定义字符串。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
指定一个虚拟机对象。
| Type: | VM |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
指定VMM 服务器对象。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMTemplate
指定一个用于创建虚拟机的 VMM 模板对象。
| Type: | Template |
| Aliases: | Template |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
输出
VirtualHardDisk
此 cmdlet 返回 VirtualHardDisk 对象。
备注
- 需要 VMM 虚拟机对象或 VMM 模板对象，可以使用 Get-SCVirtualMachine cmdlet 或 Get-SCVMTemplate cmdlet 来检索该对象。