Get-SCVirtualHardDisk
從虛擬機器、範本或儲存在 VMM 程式庫中的獨立檔案，取得虛擬硬碟物件。
Syntax
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>] Description
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 分別擷取。