Msvm_DiskDrive 類別

發行項
06/13/2023

表示虛擬機器內的硬碟。如果實體硬碟已連結至虛擬機器) 或填入虛擬硬碟媒體的綜合裝置，此硬碟可以是傳遞裝置 (。因為可以新增和移除虛擬機器中的虛擬和實體硬碟，所以有兩個與這個類別相關聯的資源集區，一個用於傳遞硬碟，另一個用於虛擬硬碟。只有在虛擬機器上線時，才能將硬碟新增至虛擬 SCSI 控制器或從虛擬 SCSI 控制器中移除。只有在虛擬機器離線時，才能將磁片新增至虛擬 IDE 控制器或從虛擬 IDE 控制器中移除。

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

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_DiskDrive : CIM_DiskDrive
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   CreationClassName;
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  string   ErrorMethodology = "None";
  string   CompressionMethod = "Not Compressed";
  uint32   NumberOfMediaSupported = 1;
  uint64   MaxMediaSize = 2000000000;
  uint64   DefaultBlockSize = 512;
  uint64   MaxBlockSize;
  uint64   MinBlockSize = 512;
  boolean  NeedsCleaning = False;
  boolean  MediaIsLocked = True;
  uint16   Security = 3;
  datetime LastCleaned;
  uint64   MaxAccessTime = 0;
  uint32   UncompressedDataRate;
  uint64   LoadTime = 0;
  uint64   UnloadTime = 0;
  uint64   MountCount = 0;
  datetime TimeOfLastMount;
  uint64   TotalMountTime = 0;
  string   UnitsDescription;
  uint64   MaxUnitsBeforeCleaning = 0xffffffffffffffff;
  uint64   UnitsUsed = 0;
  uint32   DriveNumber;
};

成員

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

方法
屬性

方法

Msvm_DiskDrive類別具有這些方法。

方法	Description
EnableDevice	不支援這個方法。
LockMedia	鎖定或釋放媒體。
OnlineDevice	不支援這個方法。
QuiesceDevice	不支援這個方法。
RequestStateChange	要求狀態變更。
重置	重設虛擬裝置。
RestoreProperties	不支援這個方法。
SaveProperties	不支援這個方法。
SetPowerState	不支援這個方法。

屬性

Msvm_DiskDrive類別具有這些屬性。

AdditionalAvailability

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

這個屬性繼承自 CIM_LogicalDevice，且設定為 6 (不適用) 。

可用性

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

此屬性繼承自 CIM_LogicalDevice。

AvailableRequestedStates

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

指出RequestStateChange方法之 RequestedState參數的可能值。此屬性繼承自 CIM_EnabledLogicalElement。

Capabilities

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

媒體存取裝置的功能。這個屬性繼承自 CIM_MediaAccessDevice，而且它設定為下列值。

值	意義
3	CapabilityDescriptions中的對應專案是「Random Access」。
4	CapabilityDescriptions中的對應專案是「支援撰寫」。

CapabilityDescriptions

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

自由格式字串的陣列，提供功能屬性陣列中所指出之存取裝置功能的詳細說明。此陣列的每個專案都與 Capabilities 屬性陣列中的專案相關，位於相同索引處。此屬性繼承自 CIM_MediaAccessDevice。

標題

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

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

CommunicationStatus

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

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

未知 (0)
無法使用 (1)
通訊確定 (2)
遺失通訊 (3)
沒有連絡人 (4)
DMTF 保留 (。。)
廠商保留 (0x8000。)

CompressionMethod

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

字串，表示用來壓縮邏輯檔案的演算法或工具。如果壓縮配置未知或未描述，請使用「Unknown」。如果已壓縮邏輯檔案，但壓縮配置未知或未描述，請使用「Compressed」。如果未壓縮邏輯檔案，請使用「未壓縮」。這個屬性繼承自 CIM_MediaAccessDevice，而且它設定為「未壓縮」。

CreationClassName

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

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

DefaultBlockSize

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

裝置的預設區塊大小，以位元組為單位。此屬性繼承自 CIM_MediaAccessDevice，且設定為 512。

說明

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

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

DetailedStatus

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

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

無法使用 (0)
沒有其他資訊 (1)
壓力 (2)
預測性失敗 (3)
無法復原的錯誤 (4)
錯誤 (5) 支援實體
DMTF 保留 (。。)
廠商保留 (0x8000。)

DeviceID

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

要唯一命名邏輯裝置的位址或其他識別資訊。此屬性繼承自 CIM_LogicalDevice。

DriveNumber

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

主控電腦系統上的實體磁片磁碟機數目。

ElementName

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

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

EnabledDefault

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

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

EnabledState

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

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

值	意義
Unknown 0	無法判斷專案的狀態。
其他 1
Enabled 2	專案正在執行。
停用 3	專案已關閉。
關閉 4	元素正在進入 [已停用] 狀態。
不適用 5	專案不支援啟用或停用。
已啟用但離線 6	元素可能正在完成命令，而且會卸載任何新的要求。
在測試中 7	元素處於測試狀態。
已延期 8	元素可能正在完成命令，但會將任何新要求排入佇列。
靜止 9	元素已啟用，但處於受限制模式。元素的行為類似于 Enabled 狀態 (2) ，但它只會處理一組受限的命令。所有其他要求都會排入佇列。
啟動中 10	元素正在進入已啟用狀態 (2) 。新的要求會排入佇列。

ErrorCleared

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

此屬性繼承自 CIM_LogicalDevice，但不會使用。

ErrorDescription

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

此屬性繼承自 CIM_LogicalDevice，但不會使用。

ErrorMethodology

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

字串，描述此裝置所支援的錯誤偵測和更正類型。此屬性繼承自 CIM_MediaAccessDevice，且設定為「None」。

HealthState

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

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

IdentifyingDescriptions

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

此屬性繼承自 CIM_LogicalDevice，且設定為 Null。

InstallDate

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

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

InstanceID

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

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

LastCleaned

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

上次清除裝置的日期和時間。此屬性繼承自 CIM_MediaAccessDevice，且設定為 Null。

LastErrorCode

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

此屬性繼承自 CIM_LogicalDevice，但不會使用。

LoadTime

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

從載入到能夠讀取或寫入媒體的時間，以毫秒為單位。例如，對於磁片磁碟機，這是磁片未旋轉至磁片報告的間隔，即磁片已準備好進行讀取/寫入 (，也就是磁片會以) 速度旋轉。對於磁帶機，這是從插入媒體到報告它已準備好供應用程式使用的時間。這通常位於磁帶的 BOT 區域。此屬性繼承自 CIM_MediaAccessDevice ，且設定為 0。

MaxAccessTime

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

從媒體的第一個位置移至相對於時間最遠位置的時間，以毫秒為單位。對於磁片磁碟機，這代表完整搜尋和完整旋轉延遲。對於磁帶機，這代表從磁帶開頭到最遠距離點的搜尋。 (磁帶結尾可能位於最遠的距離點，但這不一定成立。) 此屬性繼承自 CIM_MediaAccessDevice，且設定為 0。

MaxBlockSize

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

裝置所存取媒體的最大區塊大小，以位元組為單位。這個屬性繼承自 CIM_MediaAccessDevice，而虛擬硬碟則設定為 512，傳遞磁片磁碟機的變數。

MaxMediaSize

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

此裝置支援的媒體大小上限，以 KB 為單位。 KB 會解譯為位元組數乘以 1000 (而不是位元組數乘以 1024) 。此屬性繼承自 CIM_MediaAccessDevice，而虛擬硬碟的此屬性會設定為 2，000，000，000，000，傳遞磁片磁碟機的變數。

MaxQuiesceTime

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

此屬性繼承自 CIM_LogicalDevice，但不會使用。

MaxUnitsBeforeCleaning

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

應清除裝置之前可使用的最大單位。此屬性繼承自 CIM_MediaAccessDevice，且設定為 0xffffffffffffffff。

MediaIsLocked

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

如果媒體在裝置中鎖定且無法退出，則為 True;否則為 False。此屬性繼承自 CIM_MediaAccessDevice，且設定為 True。

MinBlockSize

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

裝置所存取媒體的最社區塊大小，以位元組為單位。此屬性繼承自 CIM_MediaAccessDevice，且設定為 512。

MountCount

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

對於支援卸載式媒體的裝置，已掛接媒體以進行資料傳輸或清除裝置的次數。對於存取不卸除式媒體的裝置，例如硬碟，此屬性不適用，而且應該設定為 0。此屬性繼承自 CIM_MediaAccessDevice，且設定為 0。

名稱

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

已知物件的標籤。此屬性繼承自 CIM_ManagedSystemElement。

NeedsCleaning

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

如果媒體存取裝置需要清除，則為 True;否則為 False。此屬性繼承自 CIM_MediaAccessDevice，且設定為 False。

NumberOfMediaSupported

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

可支援或插入的多個個別媒體數目上限。此屬性繼承自 CIM_MediaAccessDevice，且設定為 1。

OperatingStatus

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

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

未知 (0)
無法使用 (1)
服務 (2)
開始 (3)
停止 (4)
已停止 (5)
中止 (6)
休眠 (7)
已完成 (8)
移轉 (9)
Emigrating (10)
( 11)
快照集 (12)
關閉 (13)
在測試 (14)
轉換 (15)
在 Service (16)
DMTF 保留 (。。)
廠商保留 (0x8000。)

OperationalStatus

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

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

OtherEnabledState

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

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

OtherIdentifyingInfo

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

此屬性繼承自 CIM_LogicalDevice，且設定為 Null。

PowerManagementCapabilities

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

此屬性繼承自 CIM_LogicalDevice，但不會使用。

PowerManagementSupported

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

此屬性繼承自 CIM_LogicalDevice，但不會使用。

PowerOnHours

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

此屬性繼承自 CIM_LogicalDevice，但不會使用。

PrimaryStatus

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

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

未知 (0)
確定 (1)
降級 (2)
錯誤 (3)
DMTF 保留 (。。)
廠商保留 (0x8000。)

RequestedState

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

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

安全性

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

為裝置定義的作業安全性。此屬性繼承自 CIM_MediaAccessDevice，且設定為 [無]) 3 (。

狀態

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

此屬性繼承自 CIM_ManagedSystemElement，但不會使用。

StatusDescriptions

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

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

StatusInfo

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

此屬性繼承自 CIM_LogicalDevice，但不會使用。

SystemCreationClassName

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

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

SystemName

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

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

TimeOfLastMount

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

對於支援卸載式媒體的裝置，媒體掛接在裝置上的最新日期和時間。對於存取不卸除式媒體的裝置，例如硬碟，此屬性沒有意義且不適用。此屬性繼承自 CIM_MediaAccessDevice，且設定為 Null。

TimeOfLastStateChange

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

上次變更專案啟用狀態的日期或時間。此屬性繼承自 CIM_EnabledLogicalElement，而且一律設定為「Null」。

TotalMountTime

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

對於支援卸載式媒體的裝置，) 該媒體已掛接以進行資料傳輸或清除裝置的總時間，以秒為單位 (。對於存取不卸除式媒體的裝置，例如硬碟，此屬性不適用，而且應該設定為 0。此屬性繼承自 CIM_MediaAccessDevice，且設定為 0。

TotalPowerOnHours

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

此屬性繼承自 CIM_LogicalDevice，但不會使用。

TransitioningToState

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

指出實例正在轉換的目標狀態。此屬性繼承自 CIM_EnabledLogicalElement。

UncompressedDataRate

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

裝置可從媒體讀取和寫入的持續資料傳輸速率，以 KB/秒為單位。這是持續的原始資料速率。假設不應該在此屬性中報告壓縮的速率或速率上限。此屬性繼承自 CIM_MediaAccessDevice，且設定為 Null。

UnitsDescription

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

相對於其在 MaxUnitsBeforeCleaning中使用的單位。此屬性繼承自 CIM_MediaAccessDevice，且設定為 Null。

UnitsUsed

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

目前使用的單位數目。此屬性繼承自 CIM_MediaAccessDevice，且設定為 0。

UnloadTime

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

從能夠讀取或寫入媒體到卸載的時間，以毫秒為單位。此屬性繼承自 CIM_MediaAccessDevice，且設定為 0。

備註

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

規格需求

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

另請參閱

CIM_DiskDrive
CIM_DiskDrive
儲存類別

共用方式為

Msvm_DiskDrive 類別

語法

成員

方法

屬性

備註

規格需求

另請參閱

意見反應

其他資源