Msvm_VirtualHardDiskSettingData 類別
提供虛擬硬碟的設定資料。
下列語法是簡化 Managed Object Format (MOF) 程式碼，其中包含所有繼承的屬性。
語法
[AMENDMENT]
class Msvm_VirtualHardDiskSettingData : CIM_SettingData
{
string InstanceID;
string Caption = "Virtual Hard Disk Setting Data";
string Description = "Setting Data for a Virtual Hard Disk";
string ElementName;
uint16 Type;
uint16 Format;
string Path;
string ParentPath;
DATETIME ParentTimestamp;
string ParentIdentifier;
uint64 MaxInternalSize;
uint32 BlockSize;
uint32 LogicalSectorSize;
uint32 PhysicalSectorSize;
string VirtualDiskId;
uint64 DataAlignment;
uint16 PmemAddressAbstractionType;
boolean IsPmemCompatible;
};
成員
Msvm_VirtualHardDiskSettingData類別具有下列類型的成員：
屬性
Msvm_VirtualHardDiskSettingData類別具有這些屬性。
-
BlockSize
-
-
資料類型： uint32
-
存取類型：讀取/寫入
虛擬硬碟所使用的區塊大小，以位元組為單位。
-
-
標題
-
-
資料類型： 字串
-
存取類型：唯讀
物件的簡短描述。 此屬性繼承自 CIM_ManagedElement，而且一律會設定為「虛擬硬碟設定資料」。
-
-
DataAlignment
-
-
資料類型： uint64
-
存取類型：讀取/寫入
指定虛擬磁片資料承載所需的對齊方式，以位元組為單位
注意
已在 Windows 10 1709 版中新增。
-
-
說明
-
-
資料類型： 字串
-
存取類型：唯讀
對物件的描述。 此屬性繼承自 CIM_ManagedElement，而且一律會設定為「設定虛擬硬碟的資料」。
-
-
ElementName
-
-
資料類型： 字串
-
存取類型：唯讀
物件的顯示名稱。 此屬性繼承自 CIM_ManagedElement。
-
-
格式
-
-
資料類型： uint16
-
存取類型：讀取/寫入
虛擬硬碟的格式。 這會是下列其中一個值。
-
-
VHD (2)
-
VHDX (3)
-
VHDSet (4)
-
注意
已新增至 Windows 10 和 Windows Server 2016。
InstanceID
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 金鑰
唯一識別這個類別的實例。 此屬性繼承自 CIM_SettingData。
IsPmemCompatible
-
資料類型： 布林值
-
存取類型：讀取/寫入
指定虛擬磁片是否可以當做永續性記憶體裝置的備份存放區使用。
注意
已在 Windows 10 1709 版中新增。
LogicalSectorSize
-
資料類型： uint32
-
存取類型：讀取/寫入
虛擬硬碟所使用的邏輯磁區大小，以位元組為單位。
MaxInternalSize
-
資料類型： uint64
-
存取類型：讀取/寫入
虛擬機器可檢視的虛擬硬碟大小上限，以位元組為單位。 此大小會四捨五入到磁區大小的下一個最大倍數。
ParentIdentifier
-
資料類型： 字串
-
存取類型：唯讀
用來唯一識別虛擬硬碟父代的 GUID。 如果虛擬硬碟沒有父系，則此欄位是空的。
注意
已新增至 Windows 10 和 Windows Server 2016。
ParentPath
-
資料類型： 字串
-
存取類型：讀取/寫入
虛擬硬碟的父代。 如果虛擬硬碟沒有父系，則此屬性是空的。
ParentTimestamp
-
資料類型： DATETIME
-
存取類型：唯讀
虛擬硬碟父系的時間戳記。 如果虛擬硬碟沒有父系，則此欄位是空的。
注意
已新增至 Windows 10 和 Windows Server 2016。
路徑
-
資料類型： 字串
-
存取類型：讀取/寫入
虛擬硬碟的完整路徑。
PhysicalSectorSize
-
資料類型： uint32
-
存取類型：讀取/寫入
虛擬硬碟所使用的實體磁區大小，以位元組為單位。
PmemAddressAbstractionType
-
資料類型： uint16
-
存取類型：讀取/寫入
要與這個虛擬磁片搭配使用的永續性記憶體位址抽象方法。
注意
已在 Windows 10 1709 版中新增。
無 (0)
BTT (1)
未知 (65535)
類型
-
資料類型： uint16
-
存取類型：讀取/寫入
虛擬硬碟的類型。 這會是下列其中一個值。
已 修正 (2)
動態 (3)
差異 (4)
VirtualDiskId
-
資料類型： 字串
-
存取類型：讀取/寫入
用來唯一識別虛擬磁片的 GUID。
當 Msvm_ImageManagementService.GetVirtualHardDiskSettingData 方法傳回 Msvm_VirtualHardDiskSettingData的實例時，用戶端可以使用此屬性來取得 VHD 的唯一磁片識別碼。
在衝突偵測或其他情況下，用戶端可以將 VirtualDiskId 值設定為新的 GUID，並將這個 Msvm_VirtualHardDiskSettingData 實例傳遞至 Msvm_ImageManagementService.SetVirtualHardDiskSettingData 方法，以變更 VHD 的磁片識別碼。 如果 VHD 不是 VHDX VHD，或連結 VHD，則作業會失敗。 如果傳遞的值格式不正確，也就是不是 GUID 或具有所有 0，作業也會失敗。 如果傳遞的值與目前的磁片識別碼相同，則作業會以無訊息方式成功。
SetVirtualDiskInformation函式所產生的錯誤會透過這個屬性反升。 用戶端也可以使用相同的機制，透過相同命名空間中的Msvm_ImageManagementService.CreateVirtualHardDisk方法，在 VHD 建立時提供VirtualDiskId值。 這可用來建立 VHD1 或 VHD2 VHD。
Windows 8.1：在 Windows 8.1 和 Windows Server 2012 R2 之前，不支援此值。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2012 [僅限傳統型應用程式] |
| 命名空間 |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|