MSFT_VirtualDisk 類別
表示子系統儲存磁碟區。
下列語法是從 Managed 物件格式 （MOF） 程式代碼簡化。
語法
class MSFT_VirtualDisk : MSFT_StorageObject
{
String FriendlyName;
String Name;
UInt16 NameFormat;
UInt16 UniqueIdFormat;
String UniqueIdFormatDescription;
UInt16 Usage;
String OtherUsageDescription;
UInt16 HealthStatus;
UInt16 OperationalStatus[];
String OtherOperationalStatusDescription;
String ResiliencySettingName;
UInt64 Size;
UInt64 AllocatedSize;
UInt64 LogicalSectorSize;
UInt64 PhysicalSectorSize;
UInt64 FootprintOnPool;
UInt16 ProvisioningType;
UInt16 NumberOfDataCopies;
UInt16 PhysicalDiskRedundancy;
UInt16 ParityLayout;
UInt16 NumberOfColumns;
UInt64 Interleave;
Boolean RequestNoSinglePointOfFailure;
UInt16 Access;
Boolean IsSnapshot;
Boolean IsManualAttach;
Boolean IsDeduplicationEnabled;
Boolean IsEnclosureAware;
UInt16 NumberOfAvailableCopies;
UInt16 DetachedReason;
UInt64 WriteCacheSize;
};
成員
MSFT_VirtualDisk類別具有下列類型的成員：
方法
MSFT_VirtualDisk 類別具有這些方法。
| 方法 | 描述 |
|---|---|
| AddPhysicalDisk | 新增一或多個實體磁碟以進行手動配置。 |
| 附加 | 連接虛擬磁碟。 |
| CreateClone | 建立新的虛擬磁碟，這是現有虛擬磁碟的複製品。 |
| CreateReplica | 建立虛擬磁碟之間的復寫關聯性。 |
| CreateSnapshot | 建立虛擬磁碟的複製品，產生新的虛擬磁碟，其數據與原始虛擬磁碟的數據相同。 |
| DeleteObject | 刪除虛擬磁碟。 |
| 卸離 | 中斷鏈接虛擬磁碟。 |
| GetSecurityDescriptor | 擷取控制虛擬磁碟物件實例存取權的安全性描述項。 |
| 隱藏 | 隱藏虛擬磁碟。 |
| RemovePhysicalDisk | 從手動配置中移除一或多個實體磁碟。 |
| Repair | 起始虛擬磁碟的修復，將數據和備援還原到存放集區內的不同（或新）實體磁碟。 |
| 調整 | 調整虛擬磁碟的大小。 |
| SetAttributes | 設定或更新虛擬磁碟的各種屬性。 |
| SetFriendlyName | 設定虛擬磁碟的易記名稱。 |
| SetReplicationRelationship | 設定虛擬磁碟之間的復寫關聯性。 |
| SetSecurityDescriptor | 設定控制虛擬磁碟物件實例存取權的安全性描述項。 |
| SetUsage | 設定虛擬磁碟的預期使用量。 |
| 顯示 | 公開虛擬磁碟。 |
屬性
MSFT_VirtualDisk 類別具有這些屬性。
存取權限
數據類型： UInt16
存取類型：唯讀
指出虛擬磁碟是否可供讀取和寫入存取。
未知 （0）
可 讀 （1）
可 寫入 （2）
讀取/寫入 （3）
寫入一次 （4）
AllocatedSize
數據類型： UInt64
存取類型：唯讀
限定符：必要單位 （“位元組”）
目前配置的虛擬磁碟大小。 如果虛擬磁碟的 ProvisioningType 是固定的，AllocatedSize 應該等於 Size。 如果 ProvisioningType 是 Thin，此值就是實際配置的空間量（必須小於 Size）。
DetachedReason
數據類型： UInt16
存取類型：唯讀
卸離此虛擬磁碟的原因。 只有當虛擬磁碟的 OperationalStatus 包含 已中斷連結時，才會設定這個屬性。 請注意，此欄位專屬於儲存空間。
未知 （0）
無 （1）
依原則 （2）
多數磁碟狀況不良 （3）
不完整 （4）
FootprintOnPool
數據類型： UInt64
存取類型：唯讀
限定元： 單位 （「位元組」）
此虛擬磁碟所耗用的總存放集區容量，以位元組為單位。 例如，如果是大小為 1 GB 的雙向鏡像虛擬磁碟，集區中的使用量約為 2 GB。
FriendlyName
數據類型： 字串
存取類型：唯讀
限定符： 必要
用戶可設定的顯示導向字串，其中包含虛擬磁碟的名稱。
HealthStatus
數據類型： UInt16
存取類型：唯讀
限定符： 必要
虛擬磁碟的健康情況狀態。
虛擬磁碟的健康情況衍生自支持實體磁碟的健康情況，以及虛擬磁碟是否可以維護所需的復原層級。
| 值 | 意義 |
|---|---|
| 狀況良好 0 | 所有實體磁碟都存在且處於狀況良好狀態。 |
| 警告 1 | 大部分的實體磁碟狀況良好，但一或多個實體磁碟可能會失敗 I/O 要求。 |
| 狀況不良 2 | 大部分的實體磁碟狀況不良或處於失敗狀態，且虛擬磁碟不再具有數據完整性。 |
| 未知 5 | 健康情況狀態未知。 |
交織
數據類型： UInt64
存取類型：唯讀
在一般等量型復原設定中形成等量帶的位元元組數目。 等量定義為位於一個實體磁碟上的等量部分大小。 因此，Interleave * NumberOfColumns 將產生一個用戶數據等量的大小。
IsDeduplicationEnabled
數據類型： 布爾值
存取類型：讀取/寫入
如果虛擬磁碟已啟用重複數據刪除，則為TRUE 。
IsEnclosureAware
數據類型： 布爾值
存取類型：唯讀
此虛擬磁碟目前的配置行為。 機箱感知虛擬磁碟會以智慧方式挑選要用於備援的實體磁碟。 如果 為 TRUE，虛擬磁碟會嘗試使用來自不同機箱的實體磁碟，以平衡兩個或多個實體機箱之間的容錯。
IsManualAttach
數據類型： 布爾值
存取類型：讀取/寫入
如果只有在對 Attach 方法進行明確呼叫時，才會將此虛擬磁碟附加至系統，則為 TRUE。 請注意，此屬性專屬於儲存空間。
IsSnapshot
數據類型： 布爾值
存取類型：唯讀
如果此虛擬磁碟是另一個虛擬磁碟的陰影複製，則為TRUE 。
LogicalSectorSize
數據類型： UInt64
存取類型：唯讀
限定元： 單位 （「位元組」）
虛擬磁碟的邏輯扇區大小，以位元組為單位。
名稱
數據類型： 字串
存取類型：唯讀
限定符： 必要
半唯一的 （範圍設定為擁有的儲存子系統），用來識別虛擬磁碟的人類可讀取字串。
NameFormat
數據類型： UInt16
存取類型：唯讀
限定符： 必要
Name 屬性的格式。
未知 （0）
其他 （1）
VPD83NAA6 （2）
VPD83NAA5 （3）
VPD83Type2 （4）
VPD83Type1 （5）
VPD83Type0 （6）
SNVM （7）
NodeWWN （8）
NAA （9）
EUI64 （10）
T10VID （11）
NumberOfAvailableCopies
數據類型： UInt16
存取類型：唯讀
可用的數據一致複本數目。
NumberOfColumns
數據類型： UInt16
存取類型：唯讀
此虛擬磁碟的數據被等量分割所在的基礎實體磁碟數目。
NumberOfDataCopies
數據類型： UInt16
存取類型：唯讀
為虛擬磁碟維護的完整數據復本數目。 例如，RAID 5 會維護一份數據，而RAID 1則至少會維護兩個複本。
OperationalStatus
數據類型： UInt16 陣列
存取類型：唯讀
值陣列，表示虛擬磁碟的目前作業條件。 不同於 HealthStatus，這個屬性指出與此虛擬磁碟相關的硬體、軟體和基礎結構問題狀態，而且可以包含多個值。
| 值 | 意義 |
|---|---|
| 未知 0 | 操作狀態未知。 |
| 其他 1 | 已藉由設定 OtherOperationalStatusDescription 屬性來指定廠商特定的 OperationalStatus。 |
| 確定 2 | 虛擬磁碟會回應命令，且處於正常作業狀態。 |
| 降級 3 | 虛擬磁碟會回應命令，但未以最佳作業狀態執行。 |
| 壓力 4 | |
| 預測性失敗 5 | |
| 錯誤 6 | |
| 無法復原的錯誤 7 | |
| 從8開始 | |
| 停止 9 | |
| 已停止 10 | 虛擬磁碟會回應命令，但未以最佳作業狀態執行。 |
| 在服務 11 中 | 正在設定、維護、清除或管理虛擬磁碟。 |
| 無連絡人 12 | |
| 遺失通訊 13 | |
| 中止 14 | |
| 休眠 15 | |
| 錯誤16中的支持實體 | |
| 已完成 17 | |
| 電源模式 18 | |
| 重新放置 19 | |
| 中斷連結0xD002 | 此值保留給 Windows。 主機系統可看見但沒有磁碟裝置對象的虛擬磁碟。 |
| 不完整的0xD003 | 虛擬磁碟沒有足夠的備援，無法成功修復或重新產生其數據。 |
OtherOperationalStatusDescription
數據類型： 字串
存取類型：唯讀
如果 OperationalStatus 包含 Other，則此屬性是包含廠商定義作業狀態的字串。 如果 OperationalStatus 不包含 Other，這個屬性必須是 NULL。
OtherUsageDescription
數據類型： 字串
存取類型：唯讀
如果虛擬磁碟的 Usage 屬性設定為 [其他]，這個屬性必須包含廠商或使用者定義使用量的描述。 如果未 將Usage 設定為 [其他]，這個屬性必須是 NULL。
ParityLayout
數據類型： UInt16
存取類型：唯讀
用於同位型復原設定的同位配置類型。 如果虛擬磁碟不使用同位型復原設定，則此屬性應該是 NULL 。
非旋轉同位 （1）
旋轉同位 （2）
PhysicalDiskRedundancy
數據類型： UInt16
存取類型：唯讀
備份實體磁碟的數目，這些實體磁碟可能會失敗，而不會影響數據備援。 例如：RAID 0 無法容許任何失敗，RAID 5 可以容許單一磁碟驅動器失敗，而RAID 6可以容許兩個失敗。
PhysicalSectorSize
數據類型： UInt64
存取類型：唯讀
限定元： 單位 （「位元組」）
虛擬磁碟的實體扇區大小，以位元組為單位。
ProvisioningType
數據類型： UInt16
存取類型：唯讀
限定符： 必要
虛擬磁碟的布建配置。
| 值 | 意義 |
|---|---|
| 未知 0 | 布建配置未知。 |
| 細 1 | 虛擬磁碟的容量會視需要配置。 |
| 已修正 2 | 虛擬磁碟的容量會在建立時完全配置。 |
RequestNoSinglePointOfFailure
數據類型： 布爾值
存取類型：唯讀
設定為 TRUE 以要求沒有單一失敗點。
ResiliencySettingName
數據類型： 字串
存取類型：唯讀
限定符： 必要， ModelCorrespondence {“MSFT_ResiliencySetting.Name”}
虛擬磁碟的復原設定名稱。
大小
數據類型： UInt64
存取類型：唯讀
限定符：必要單位 （“位元組”）
虛擬磁碟的邏輯大小，以位元組為單位。
UniqueIdFormat
數據類型： UInt16
存取類型：唯讀
限定符：必要值 （“廠商特定”、“廠商標識符”、“EUI64”、“FCPH 名稱”、“SCSI 名稱字符串”）、ValueMap （“0”、“1”、“2”、“3”、“8”），ModelCorrespondence {“MSFT_StorageObject.UniqueId”}
這個類別繼承自 MSFT_StorageObject 類別之 UniqueId 屬性中使用的標識碼類型。 此標識碼必須是使用下列喜好設定順序的最高可用標識碼：8（最高）、3、2、1、0（最低）。
例如，如果虛擬磁碟裝置公開類型為 0、1 和 3 的標識碼， UniqueId 必須是類型 3 識別符， 而 UniqueIdFormat 應該設定為 3。
UniqueIdFormatDescription
數據類型： 字串
存取類型：唯讀
限定符： ModelCorrespondence {“MSFT_StorageObject.UniqueId”}， ModelCorrespondence {“MSFT_VirtualDisk.UniqueIdFormat”}
UniqueIdFormat 的某些值可能包含各種子格式。 此屬性是自由格式字串，用來描述 UniqueId 中使用的特定格式。
使用方式
數據類型： UInt16
存取類型：讀取/寫入
限定符： 必要
此虛擬磁碟的預期用法。
未知 （0）
其他 （1）
不受限制 （2）
保留給 ComputerSystem （區塊伺服器） （3）
複寫服務 保留 （4）
移轉服務 保留 （5）
本機複本來源 （6）
遠端復本來源 （7）
本機複本目標 （8）
遠端複本目標 （9）
本機複本來源或目標 （10）
遠端復本來源或目標 （11）
差異複本目標 （12）
元素元件 （13）
保留為集區參與者 （14）
複合量成員 （15）
複合 VirtualDisk 成員 （16）
保留給疏散 （17）
WriteCacheSize
數據類型： UInt64
存取類型：唯讀
虛擬磁碟的寫入快取大小。
備註
相較於實體磁碟，虛擬磁碟是具有擴充屬性集的可用記憶體單位。 其他屬性的範例包括復原和動態容量擴充功能。
LUN 和儲存空間是虛擬磁碟的範例。
當公開至 Windows 時，虛擬磁碟會顯示為 Windows 堆疊其餘部分的 [Windows] 磁碟。
需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |