MSFT_PhysicalDisk 類別
表示子系統磁碟驅動器或軸。
下列語法是從 Managed 物件格式簡化， (MOF) 程式代碼。
語法
class MSFT_PhysicalDisk : MSFT_StorageFaultDomain
{
UInt16 UniqueIdFormat;
String DeviceId;
String FriendlyName;
UInt16 HealthStatus;
UInt16 OperationalStatus[];
String OperationalDetails[];
String PhysicalLocation;
UInt16 VirtualDiskFootprint;
UInt16 Usage;
UInt16 SupportedUsages[];
String Description;
String PartNumber;
String FirmwareVersion;
String SoftwareVersion;
UInt64 Size;
UInt64 AllocatedSize;
UInt16 BusType;
Boolean IsWriteCacheEnabled;
Boolean IsPowerProtected;
UInt64 PhysicalSectorSize;
UInt64 LogicalSectorSize;
UInt32 SpindleSpeed;
Boolean IsIndicationEnabled;
UInt16 EnclosureNumber;
UInt16 SlotNumber;
Boolean CanPool;
UInt16 CannotPoolReason[];
String OtherCannotPoolReasonDescription;
Boolean IsPartial;
UInt16 MediaType;
};
成員
MSFT_PhysicalDisk類別具有下列類型的成員：
方法
MSFT_PhysicalDisk 類別具有這些方法。
| 方法 | Description |
|---|---|
| 維護 | 允許在實體磁碟上執行維護作業，同時在具體集區中執行，例如韌體更新。 |
| 重設 | 重設實體磁碟。 |
| SetAttributes | 匯報 實體磁碟的屬性。 |
| SetDescription | 設定或變更實體磁碟的描述。 |
| SetFriendlyName | 設定或變更實體磁碟的易記名稱。 |
| SetUsage | 設定或變更實體集區內實體磁碟的預期使用量。 |
| SetWriteCache | 允許啟用或停用實體磁碟的寫入快取。 |
屬性
MSFT_PhysicalDisk類別具有這些屬性。
AllocatedSize
數據類型： UInt64
存取類型：唯讀
限定符： 單位 (“Bytes”)
此實體磁碟上的已使用空間總數。 這應該包括來自所有存放集區的使用量，以及其他儲存在磁碟上的數據。
BusType
數據類型： UInt16
存取類型：唯讀
限定符： 必要
實體磁碟的儲存總線類型。
| 值 | 意義 |
|---|---|
| 未知 的 0 | 總線類型未知。 |
| SCSI 1 | SCSI |
| ATAPI 2 | ATAPI |
| ATA 3 | ATA |
| 1394 4 | IEEE 1394 |
| SSA 5 | Ssa |
| 光纖通道 6 | 光纖通道 |
| USB 7 | USB |
| RAID 8 | RAID |
| iSCSI 9 | iSCSI |
| SAS 10 | 序列連結 SCSI (SAS) |
| SATA 11 | 序列 ATA (SATA) |
| SD 12 | 安全數位 (SD) |
| MMC 13 | 多媒體卡片 (MMC) |
| 最大值 14 | 此值會保留供系統使用。 |
| 檔案支持的虛擬 15 | File-Backed 虛擬 |
| 儲存空間 16 | 儲存空間 |
| NVMe 17 | |
| Microsoft 保留 18.. | 此值會保留供系統使用。 |
CannotPoolReason
數據類型： UInt16 陣列
存取類型：唯讀
限定符： 必要
值的陣列，指定此實體磁碟無法新增至具體集區的原因。 只有當 CanPool 屬性為 FALSE 時，這個屬性才有效。
未知 (0)
其他 (1)
在集 區 (2)
狀況不良 (3)
卸除式媒體 (4)
在叢集使用 中 (5)
離線 (6)
容量不足 (7)
備用磁碟 (8)
由子系統 保留 (9)
開始 (10)
Microsoft 保留 (。。)
廠商保留 (0x8000。)
CanPool
數據類型： 布爾值
存取類型：唯讀
限定符： 必要
如果 這個實體磁碟可以新增至具體集區，則為TRUE。
描述
數據類型： 字串
存取類型：唯讀
實體磁碟的用戶可設定描述。
DeviceId
數據類型： 字串
存取類型：唯讀
可唯一命名實體磁碟的位址或其他標識符。
EnclosureNumber
數據類型： UInt16
存取類型：唯讀
磁碟實際所在的機箱數目。
FirmwareVersion
數據類型： 字串
存取類型：唯讀
限定符： 必要
韌體修訂的字串表示。
FriendlyName
數據類型： 字串
存取類型：唯讀
限定符： 必要
實體磁碟的使用者易記顯示名稱。 初始值應該由記憶體提供者或子系統設定，而且可由使用者修改物件存留期的任何時間點。
HealthStatus
數據類型： UInt16
存取類型：唯讀
裝置健康情況的高階指示。
| 值 | 意義 |
|---|---|
| 0 | Healthy |
| 1 | 警告 |
| 2 | Unhealthy |
| 5 | Unknown |
IsIndicationEnabled
數據類型： 布爾值
存取類型：唯讀
指出實體磁碟的識別 LED 是否作用中。 這通常用於維護作業。
IsPartial
數據類型： 布爾值
存取類型：唯讀
如果 系統或服務在一般存放集區作業之外部分取用此實體磁碟，則為TRUE。
IsPowerProtected
數據類型： 布爾值
存取類型：唯讀
指出此實體磁碟是否能夠容忍電源遺失，而不會遺失數據。
IsWriteCacheEnabled
數據類型： 布爾值
存取類型：唯讀
指出是否在此實體磁碟上啟用寫入快取。
LogicalSectorSize
數據類型： UInt64
存取類型：唯讀
實體磁碟的邏輯扇區大小，以位元組為單位。 例如：4K 原生磁碟應該報告 4096，而 512 位元組仿真的磁碟應該回報 512。
MediaType
數據類型： UInt16
存取類型：唯讀
實體磁碟的媒體類型。
| 值 | 意義 |
|---|---|
| 0 | [未指定] |
| 3 | HDD |
| 4 | SSD |
| 5 | SCM |
OperationalDetails
數據類型： 字串 陣列
存取類型：唯讀
字串數位，提供指定作業狀態的進一步資訊。
OperationalStatus
數據類型： UInt16 陣列
存取類型：唯讀
操作狀態值的陣列，進一步說明指定的健全狀況狀態。
OtherCannotPoolReasonDescription
數據類型： 字串
存取類型：唯讀
字串，其中包含此實體磁碟無法新增至具體集區的原因。 如果 CannotPoolReason 屬性的值不是 Other，這個屬性必須是 NULL。
PartNumber
數據類型： 字串
存取類型：唯讀
限定符： 必要
實體磁碟部分編號或 SKU 的字串表示。
PhysicalLocation
數據類型： 字串
存取類型：唯讀
此欄位是自由格式字串，表示硬體所在的位置。
PhysicalSectorSize
數據類型： UInt64
存取類型：唯讀
實體磁碟的實體扇區大小，以位元組為單位。 例如：針對 4K 原生和 512 位元組模擬磁碟，此屬性的值應該是 4096。
大小
數據類型： UInt64
存取類型：唯讀
限定符： 單位 (“Bytes”)
磁碟的實體記憶體大小總計，以位元組為單位。
SlotNumber
數據類型： UInt16
存取類型：唯讀
磁碟實際所在的機箱插槽數目。
SoftwareVersion
數據類型： 字串
存取類型：唯讀
限定符： 必要
軟體版本號碼的字串表示。
柱形軸
數據類型： UInt32
存取類型：唯讀
以軸為基礎的實體磁碟的旋轉速度。 對於 (SSD) 或其他非旋轉媒體的固態裝置，此成員應設定為 0。 對於具有未知速度的旋轉媒體，此成員應該設定為0xFFFFFFFF (UINT32_MAX) 。
SupportedUsages
數據類型： UInt16 陣列
存取類型：唯讀
限定符： 必要
值的陣列，指定這個實體磁碟的支援使用方式。
| 值 | 意義 |
|---|---|
| 未知 的 0 | 未指定預定的使用方式。 |
| 自動選取 1 | 此實體磁碟只能用於數據記憶體。 |
| 手動選取 2 | 只有當系統管理員在建立虛擬磁碟時手動選取時，才應該使用此實體磁碟。 使用 PhysicalDisksToUse 參數來選取手動選取的磁碟，以 建立VirtualDisk。 |
| 熱備援 3 | 此實體磁碟應作為熱備援使用。 |
| 已淘汰 4 | 此實體磁碟應該已淘汰，不要使用。 至少不應該有新的配置移至此磁碟。 如果修復此磁碟上的虛擬磁碟，數據應移至另一個作用中的實體磁碟。 |
| 日誌 5 | 此實體磁碟應作為組成虛擬磁碟之其他裝置的快取。 如果已設定，它會備份虛擬磁碟的回寫快取。 |
UniqueIdFormat
數據類型： UInt16
存取類型：唯讀
限定符： 必要
指出 UniqueId 字段中所使用的識別碼類型， (繼承自 MSFT_StorageObject) 。 UniqueId 中使用的標識碼必須是使用下列喜好設定順序的最高可用標識碼：8 (最高) 、3、2、1、0 (最低) 。 例如，如果實體磁碟裝置公開類型為 0、1 和 3 的標識碼， UniqueId 必須是類型 3 的識別符，且 UniqueIdFormat 應設定為 3。
廠商特定 (0)
廠商標識碼 (1)
EUI64 (2)
FCPH 名稱 (3)
SCSI 名稱字串 (8)
使用方式
數據類型： UInt16
存取類型：唯讀
限定符： 必要
實體集區內此實體磁碟的預期用法。
需要存放集區，才能遵循實體磁碟的指派原則。
| 值 | 意義 |
|---|---|
| 未知 的 0 | 未指定預定的使用方式。 |
| 自動選取 1 | 此實體磁碟只能用於數據記憶體。 |
| 手動選取 2 | 只有當系統管理員在建立虛擬磁碟時手動選取時，才應該使用此實體磁碟。 使用 PhysicalDisksToUse 參數來選取手動選取的磁碟，以 建立VirtualDisk。 |
| 熱備援 3 | 此實體磁碟應作為熱備援使用。 |
| 已淘汰 4 | 此實體磁碟應該已淘汰，不要使用。 至少不應該有新的配置移至此磁碟。 如果修復此磁碟上的虛擬磁碟，數據應移至另一個作用中的實體磁碟。 |
| 日誌 5 | 此實體磁碟應作為組成虛擬磁碟之其他裝置的快取。 如果已設定，它會備份虛擬磁碟的回寫快取。 |
VirtualDiskFootprint
數據類型： UInt16
存取類型：唯讀
此欄位指出此實體磁碟上虛擬磁碟的用戶數據使用量位元組大小。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 命名空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應