Msvm_LogicalDisk 類別

發行項
06/12/2023

表示存放裝置磁片磁碟機媒體，並用來填入存放裝置磁片磁碟機。支援的媒體類型包括虛擬硬式檔案、虛擬磁碟片檔案、ISO 檔案和實體裝置媒體。

下列語法是簡化 Managed Object Format (MOF) 程式碼，其中包含所有繼承的屬性。

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_LogicalDisk : CIM_LogicalDisk
{
  string   InstanceID;
  string   Caption;
  uint64   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  uint16   CreationClassName = "Msvm_LogicalDisk";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability = 6;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  uint16   DataOrganization = 2;
  string   Purpose;
  uint16   Access;
  string   ErrorMethodology;
  uint64   BlockSize = 512;
  uint64   NumberOfBlocks = 266338304;
  uint64   ConsumableBlocks = 0;
  boolean  IsBasedOnUnderlyingRedundancy = False;
  boolean  SequentialAccess = False;
  uint16   ExtentStatus[] = { 2 };
  boolean  NoSinglePointOfFailure = False;
  uint16   DataRedundancy = 0;
  uint16   PackageRedundancy = 0;
  uint8    DeltaReservation = 0;
  boolean  Primordial = False;
  uint16   NameFormat = 12;
  uint16   NameNamespace = 8;
  string   OtherNameNamespace;
  string   OtherNameFormat;
};

成員

Msvm_LogicalDisk類別具有下列類型的成員：

方法
屬性

方法

Msvm_LogicalDisk類別具有這些方法。

方法	Description
EnableDevice	不支援這個方法。
OnlineDevice	不支援這個方法。
QuiesceDevice	不支援這個方法。
RequestStateChange	要求狀態變更。
重置	重設服務。
RestoreProperties	不支援這個方法。
SaveProperties	不支援這個方法。
SetPowerState	不支援這個方法。

屬性

Msvm_LogicalDisk類別具有這些屬性。

存取

資料類型： uint16
存取類型：唯讀

指出媒體是否為可讀取、可寫入或兩者。此屬性繼承自 CIM_StorageExtent。

值	意義
0	Unknown
1	讀。
2	可寫入。
3	讀取/寫入
4	寫入一次。

AdditionalAvailability

資料類型： uint16 陣列
存取類型：唯讀

裝置的任何其他可用性和狀態。此屬性繼承自 CIM_LogicalDevice。

值	意義
{ 6 }	不適用。

可用性

資料類型： uint16
存取類型：唯讀

裝置的主要可用性和狀態。此屬性繼承自 CIM_LogicalDevice。

值	意義
6	不適用。

AvailableRequestedStates

資料類型： uint16 陣列
存取類型：唯讀

指出用於起始狀態變更之RequestStateChange 方法 RequestedState參數的可能值。列出的值將是CIM_EnabledLogicalElementCapabilities相關聯實例 的 RequestedStatesSupported 屬性中包含的值子 集，其中選取的值是 CIM_EnabledLogicalElement 物件目前狀態的函式。如果實作能夠將一組可能的值公告為目前狀態的函式，這個屬性可以是非Null 。如果實作無法判斷可能值的集合做為目前狀態的函式，這個屬性會是 Null 。

此屬性繼承自 CIM_EnabledLogicalElement。

BlockSize

資料類型： uint64
存取類型：唯讀

構成儲存範圍的區塊大小，以位元組為單位。如果區塊大小是可變的，則應該指定區塊大小上限，以位元組為單位。如果區塊大小未知，或區塊概念無效 (例如匯總範圍、記憶體或邏輯磁片) ，這將會包含 1。此屬性繼承自 CIM_StorageExtent。

標題

資料類型：字串
存取類型：唯讀

物件的簡短描述。此屬性繼承自 CIM_ManagedElement。

「ISO 磁片映射」

「硬碟映射」

「Floppy Disk Image」

「CD/DVD 磁片」

CommunicationStatus

資料類型： uint16
存取類型：唯讀

指出檢測能夠與基礎 Managed 元素通訊。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

ConsumableBlocks

資料類型： uint64
存取類型：唯讀

區塊數目上限，大小為 BlockSize，可在使用 Msvm_BasedOn 關聯來分層儲存範圍時使用。此屬性繼承自 CIM_StorageExtent。

CreationClassName

資料類型： uint16
存取類型：唯讀

建立實例時所使用的類別或子類別名稱。此屬性繼承自 CIM_LogicalDevice。

DataOrganization

資料類型： uint16
存取類型：唯讀

所使用的資料組織類型。此屬性繼承自 CIM_StorageExtent。

值	意義
2	已修正區塊。

DataRedundancy

資料類型： uint16
存取類型：唯讀

目前維護之資料的完整複本數目。此屬性繼承自 CIM_StorageExtent。

DeltaReservation

資料類型： uint8
存取類型：唯讀

百分比，指定複本中應保留的空間量，以快取變更。此屬性繼承自 CIM_StorageExtent。

說明

資料類型： uint64
存取類型：唯讀

對物件的描述。此屬性繼承自 CIM_ManagedElement。

DetailedStatus

資料類型： uint16
存取類型：唯讀

以其他狀態詳細資料補充 PrimaryStatus 屬性。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

DeviceID

資料類型：字串
存取類型：唯讀

此屬性繼承自CIM_LogicalDevice，且設定為「Microsoft：GUID\device-specific-data」。

ElementName

資料類型：字串
存取類型：唯讀

物件的顯示名稱。此屬性繼承自 CIM_ManagedElement。

「ISO 磁片映射」

「硬碟映射」

「磁碟片映射」

「CD/DVD 磁片」

EnabledDefault

資料類型： uint16
存取類型：唯讀

系統管理員的元素啟用狀態的預設或啟動組態。此屬性繼承自 CIM_EnabledLogicalElement。

EnabledState

資料類型：字串
存取類型：唯讀

專案的啟用和停用狀態。它也可以指出這些要求狀態之間的轉換。此屬性繼承自 CIM_EnabledLogicalElement。

ErrorCleared

資料類型： 布林值
存取類型：唯讀

指出 LastErrorCode 中回報的錯誤現在是否已清除。此屬性繼承自 CIM_LogicalDevice，但不會使用。

ErrorDescription

資料類型：字串
存取類型：唯讀

字串，提供有關 LastErrorCode 中所記錄之錯誤的詳細資訊，以及可採取之任何更正動作的相關資訊。此屬性繼承自 CIM_LogicalDevice，但不會使用。

ErrorMethodology

資料類型：字串
存取類型：唯讀

字串，描述此裝置所支援的錯誤偵測和更正類型。此屬性繼承自 CIM_StorageExtent。

ExtentStatus

資料類型： uint16 陣列
存取類型：唯讀

除了在 OperationalStatus和其他繼承屬性中擷取的其他任何狀態資訊之外。

值	意義
{ 2 }	無/不適用。

HealthState

資料類型： uint16
存取類型：唯讀

專案目前的健全狀況。這個屬性工作表示這個專案的健康情況，但不一定表示其子元件的健全狀況。可能的值為 0 到 30，其中 5 表示元素狀況完全良好，而 30 表示元素完全非功能。此屬性繼承自 CIM_ManagedSystemElement。

IdentifyingDescriptions

資料類型：字串陣列
存取類型：唯讀

自由格式字串的陣列，提供 OtherIdentificationInfo 屬性陣列中專案背後的說明和詳細資料。此屬性繼承自 CIM_LogicalDevice，且設定為 Null。

InstallDate

資料類型： datetime
存取類型：唯讀

建立虛擬機器組態的日期和時間。此屬性繼承自 CIM_ManagedSystemElement。

InstanceID

資料類型：字串
存取類型：唯讀
限定詞：金鑰

唯一識別這個類別的實例。此屬性繼承自 CIM_ManagedElement。

IsBasedOnUnderlyingRedundancy

資料類型： 布林值
存取類型：唯讀

指出基礎儲存體範圍是否參與儲存體備援群組。此屬性繼承自 CIM_StorageExtent。

LastErrorCode

資料類型： uint32
存取類型：唯讀

邏輯裝置報告的最後一個錯誤碼。此屬性繼承自 CIM_LogicalDevice，但不會使用。

MaxQuiesceTime

資料類型： uint64
存取類型：唯讀

這個屬性已被取代。此屬性繼承自 CIM_LogicalDevice，但不會使用。

名稱

資料類型：字串
存取類型：唯讀

已知物件的標籤。此屬性繼承自 CIM_ManagedSystemElement，而且與 ElementName 屬性相同。

NameFormat

資料類型： uint16
存取類型：唯讀

此屬性繼承自 CIM_StorageExtent。

值	意義
1	其他
12	作業系統裝置名稱

NameNamespace

資料類型： uint16
存取類型：唯讀

此屬性繼承自 CIM_StorageExtent。

值	意義
1	其他
8	作業系統裝置命名空間

NoSinglePointOfFailure

資料類型： 布林值
存取類型：唯讀

指出是否有單一失敗點存在。此屬性繼承自 CIM_StorageExtent。

NumberOfBlocks

資料類型： uint64
存取類型：唯讀

連續區塊的數目，每個區塊的大小都包含在 BlockSize 屬性中，形成儲存範圍。儲存範圍的大小總計可以藉由將 BlockSize 屬性的值乘以這個屬性的值來計算。如果 BlockSize 的值是 1，這個屬性是儲存範圍的大小總計。此屬性繼承自 CIM_StorageExtent。

OperatingStatus

資料類型： uint16
存取類型：唯讀

提供元素作業條件的目前狀態資訊，並可用來提供 有關 EnabledState 屬性值的詳細資料。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

OperationalStatus

資料類型： uint16 陣列
存取類型：唯讀
限定詞：覆寫 (「OperationalStatus」) ， ArrayType (「Indexed」)

物件的目前狀態。此屬性繼承自 CIM_ManagedSystemElement。

當無法滿足虛擬磁片所需的 QoS 層級時， (OperationalStatus[0]) 的主要狀態會設定為 [降級] (3) ，而 OperationalStatus 陣列也會包含次要狀態值，指出 QoS 條件的特定原因。根據下表。

值	Description
輸送量不足 (32788)	裝置目前無法使用所要求的最小 IOPS 速率。

注意

OperationalStatus 也可用來報告其他錯誤或警告狀況 (，例如 VSP 與 VSC) 之間的通訊協定不符。如果存在多個條件，則主要狀態會設定為 [已降級]，而且從索引 1 開始的任何順序，就會填入陣列中的一或多個次要狀態值。

確定 (2)

降級 (3)

無法復原的錯誤 (7)

在 Service (11)

注意

已新增Windows 10。

沒有連絡人 (12)

遺失通訊 (13)

支援錯誤中的實體 (16)

注意

已新增Windows 10。

通訊協定不相符 (32775)

通訊逾時 (32783)

注意

已新增Windows 10。

輸送量不足 (32788)

未知的 QoS 原則識別碼 (32791)

不支援 QoS (32792)

注意

已新增Windows 10。

QoS 組態不相符 (32793)

注意

已新增Windows 10。

磁片完整 (32794)

注意

已新增Windows 10。

OtherEnabledState

資料類型：字串
存取類型：唯讀

當 EnabledState屬性設定為 1 (Other) 時，元素的啟用或停用狀態。當EnabledState是 1 以外的任何值時，此屬性必須設定為Null。此屬性繼承自 CIM_EnabledLogicalElement。

OtherIdentifyingInfo

資料類型：字串陣列
存取類型：唯讀

裝置識別碼資訊以外的任何其他資料，可用來識別邏輯裝置。這個屬性繼承自 CIM_LogicalDevice，而且它設定為 Null。

OtherNameFormat

資料類型：字串
存取類型：唯讀

當NameFormat包含值 1 (Other) 時，描述Name屬性的格式字串。此屬性繼承自 CIM_StorageExtent。

OtherNameNamespace

資料類型：字串
存取類型：唯讀

當NameNamespace包含值 1 (Other) 時，描述Name屬性的命名空間字串。此屬性繼承自 CIM_StorageExtent。

PackageRedundancy

資料類型： uint16
存取類型：唯讀

目前可能會失敗的實體套件數目，而不會遺失資料。此屬性繼承自 CIM_StorageExtent。

PowerManagementCapabilities

資料類型： uint16 陣列
存取類型：唯讀

裝置的電源管理功能。此屬性繼承自 CIM_LogicalDevice，但不會使用。

PowerManagementSupported

資料類型： 布林值
存取類型：唯讀

指出裝置是否可以進行電源管理。此屬性繼承自 CIM_LogicalDevice，但不會使用。

PowerOnHours

資料類型： uint64
存取類型：唯讀

自上次電源週期以來，此裝置已開啟的連續時數。此屬性繼承自 CIM_LogicalDevice，但不會使用。

PrimaryStatus

資料類型： uint16
存取類型：唯讀

提供高階狀態資訊。此屬性應該與 DetailedStatus 屬性搭配使用，以提供元素及其子元件的高階和詳細健康狀態資訊。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

原始

資料類型： 布林值
存取類型：唯讀

指出包含的系統是否能夠建立或刪除此操作專案。這個屬性繼承自 CIM_StorageExtent，而且會針對檔案型媒體設定為 False ，而傳遞媒體則設定為 True 。

目的

資料類型：字串
存取類型：唯讀

描述媒體和/或其用法的字串。此屬性繼承自 CIM_StorageExtent。

RequestedState

資料類型： uint16
存取類型：唯讀

專案的最後一個要求或所需狀態。專案的實際狀態是由 EnabledState表示。提供這個屬性來比較上次要求和目前啟用或停用的狀態。 CIM_EnabledLogicalElement的特定實例可能不支援RequestStateChange方法。如果發生這種情況，則會使用值 12 (不適用) 。此屬性繼承自 CIM_EnabledLogicalElement。

SequentialAccess

資料類型： 布林值
存取類型：唯讀

指出媒體存取裝置是否循序存取儲存體。傳遞磁帶媒體是循序存取儲存範圍的範例。此屬性繼承自 CIM_StorageExtent。

狀態

資料類型：字串
存取類型：唯讀

物件的目前狀態。此屬性繼承自 CIM_ManagedSystemElement，但不會使用。

StatusDescriptions

資料類型：字串陣列
存取類型：唯讀

描述各種 OperationalStatus 陣列值的字串。此屬性繼承自 CIM_ManagedSystemElement。

StatusInfo

資料類型： uint16
存取類型：唯讀

邏輯裝置的目前狀態。此屬性繼承自 CIM_LogicalDevice，但不會使用。

SystemCreationClassName

資料類型：字串
存取類型：唯讀

界定系統的建立類別名稱。此屬性繼承自 CIM_LogicalDevice。

SystemName

資料類型：字串
存取類型：唯讀

範圍虛擬機器的唯一識別碼。此屬性繼承自 CIM_LogicalDevice。

TimeOfLastStateChange

資料類型： datetime
存取類型：唯讀

上次變更專案啟用狀態的日期或時間。此屬性繼承自 CIM_EnabledLogicalElement。

TotalPowerOnHours

資料類型： uint64
存取類型：唯讀

此裝置已啟動的總時數。此屬性繼承自 CIM_LogicalDevice，但不會使用。

TransitioningToState

資料類型： uint16
存取類型：唯讀

指出實例正在轉換的目標狀態。此屬性繼承自 CIM_EnabledLogicalElement，但不會使用。

備註

UAC 篩選可能會限制 對Msvm_LogicalDisk 類別的存取。如需詳細資訊，請參閱使用者帳戶控制和 WMI。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
命名空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

另請參閱

CIM_LogicalDisk
CIM_LogicalDisk
Msvm_StorageAlert
儲存類別

共用方式為

Msvm_LogicalDisk 類別

語法

成員

方法

屬性

備註

規格需求

另請參閱

意見反應

其他資源