通过

Get-SCVirtualHardDisk

  • 参考
模块:
VirtualMachineManager

从虚拟机、模板或作为存储在 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 来检索该对象。