Win32_DiskPartition 類別

發行項
06/12/2023

Win32_DiskPartitionWMI 類別代表執行 Windows 的電腦系統上實體磁片分割區域的功能和管理容量。範例：磁片 #0、磁碟分割 #1。

下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。屬性會依字母順序列出，而非 MOF 順序。

語法

[Dynamic, Provider("CIMWin32"), UUID("{8502C4B8-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_DiskPartition : CIM_DiskPartition
{
  unit16   AdditionalAvailability;
  uint16   Availability;
  uint16   PowerManagementCapabilities[];
  string   IdentifyingDescriptions[1];
  uint64   MaxQuiesceTime;
  uint64   OtherIdentifyingInfo;
  uint16   StatusInfo;
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  uint16   Access;
  uint64   BlockSize;
  boolean  Bootable;
  boolean  BootPartition;
  string.  Caption;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string.  CreationClassName;
  string   Description;
  string   DeviceID;
  uint32   DiskIndex;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   ErrorMethodology;
  uint32   HiddenSectors;
  uint32   Index;
  datetime InstallDate;
  uint32   LastErrorCode;
  string   Name;
  uint64   NumberOfBlocks;
  string   PNPDeviceID;
  boolean  PowerManagementSupported;
  boolean  PrimaryPartition;
  string   Purpose;
  boolean  RewritePartition;
  uint64   Size;
  uint64   StartingOffset;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  string   Type;
};

成員

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

方法
屬性

方法

Win32_DiskPartition類別具有這些方法。

方法	Description
重置	要求重設邏輯裝置。
SetPowerState	設定邏輯裝置所需的電源狀態，以及何時應將裝置放入該狀態。

屬性

Win32_DiskPartition類別具有這些屬性。

存取

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

可用的媒體存取。

此屬性繼承自 CIM_StorageExtent。

未知 (0)

可讀取 (1)

可寫入 (2)

可寫入

支援讀取/寫入 (3)

寫入一次 (4)

AdditionalAvailability

資料類型： unit16
存取類型：僅限寫入

裝置的其他可用性和狀態，超出 Availability 屬性中指定的狀態。 Availability屬性代表裝置的主要狀態和可用性。在某些情況下，這不足以表示裝置的完整狀態。在這些情況下， AdditionalAvailability 屬性可用來提供進一步的資訊。例如，裝置的主要 可用性 可能是離線 (值=8) ，但它也可能處於低電量狀態， (AdditonalAvailability 值=14) ，或者裝置可能正在執行 Diagnostics (AdditionalAvailability value=5，在測試) 中。」

此屬性繼承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

執行/完整 Power (3)

警告 (4)

在測試 (5)

不適用 (6)

關閉電源 (7)

離線 (8)

離職 (9)

降級 (10)

未安裝 (11)

安裝錯誤 (12)

電源儲存 - 未知 (13)

省電 - 低電源模式 (14)

電源儲存 - 待命 (15)

Power Cycle (16)

電源儲存 - 警告 (17)

已暫停 (18)

未就緒 (19)

未設定 (20)

靜止 (21)

可用性

資料類型： uint16
存取類型：唯讀
限定詞： MappingStrings (「MIF。DMTF|操作狀態|003.5「，」MIB.IETF|HOST-RESOURCES-MIB.hrDeviceStatus「)

裝置的可用性和狀態。

此屬性繼承自 CIM_LogicalDevice。

其他 (1)

未知的 (2)

執行/完整電源 (3)

警告 (4)

在測試 (5)

不適用 (6)

關閉電源 (7)

離線 (8)

離職 (9)

降級 (10)

未安裝 (11)

安裝錯誤 (12)

電源儲存 - 未知 (13)

裝置已知處於省電模式，但其確切狀態不明。

省電 - 低電源模式 (14)

裝置處於省電狀態，但仍正常運作，而且可能會呈現效能降低。

電源儲存 - 待命 (15)

裝置無法正常運作，但可能會快速進入完整電源。

Power Cycle (16)

電源儲存 - 警告 (17)

裝置處於警告狀態，但也處於省電模式。

暫停 (18)

裝置已暫停。

未就緒 (19)

裝置未就緒。

未設定 (20)

裝置未設定。

靜止 (21)

裝置是無訊息的。

BlockSize

資料類型： uint64
存取類型：唯讀
限定詞： MappingStrings (「MIB。IETF|HOST-RESOURCES-MIB.hrStorageAllocationUnits「) ， Units (」bytes「)

以位元組為單位的區塊大小，形成此儲存範圍。如果未知或區塊概念無效 (例如，針對匯總範圍、記憶體或邏輯磁片) ，請輸入 1。

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

此屬性繼承自 CIM_StorageExtent。

啟動

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

指出電腦是否可以從這個磁碟分割開機。

此屬性繼承自 CIM_DiskPartition。

BootPartition

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32API|檔案函式 |ReadFile「)

資料分割是使用中的分割區。從硬碟開機時，作業系統會使用使用中的磁碟分割。

標題

資料類型： 字串。
存取類型：唯讀
限定詞： MaxLen (64) 、 DisplayName (「Caption」)

物件的簡短描述。

此屬性繼承自 CIM_ManagedSystemElement。

ConfigManagerErrorCode

資料類型： uint32
存取類型：唯讀
限定詞：架構 (「Win32」)

Windows Configuration Manager錯誤碼。

此屬性繼承自 CIM_LogicalDevice。

此裝置正常運作。 (0)

裝置正常運作。

此裝置未正確設定。 (1)

裝置未正確設定。

Windows 無法載入此裝置的驅動程式。 (2)

此裝置的驅動程式可能已損毀，或者您的系統可能會在記憶體或其他資源上執行不足。 (3)

此裝置無法正常運作。其中一個驅動程式或您的登錄可能已損毀。 (4)

此裝置的驅動程式需要 Windows 無法管理的資源。 (5)

此裝置的開機設定與其他裝置衝突。 (6)

無法篩選。 (7)

遺失裝置的驅動程式載入器。 (8)

此裝置無法正常運作，因為控制韌體未正確報告裝置的資源。 (9)

此裝置無法啟動。 (10)

此裝置失敗。 (11)

此裝置找不到足夠的可用資源可供使用。 (12)

Windows 無法驗證此裝置的資源。 (13)

在您重新開機電腦之前，此裝置無法正常運作。 (14)

此裝置無法正常運作，因為可能有重新列舉問題。 (15)

Windows 無法識別此裝置使用的所有資源。 (16)

此裝置要求未知的資源類型。 (17)

重新安裝此裝置的驅動程式。 (18)

使用 VxD 載入器失敗。 (19)

您的登錄可能已損毀。 (20)

系統失敗：請嘗試變更此裝置的驅動程式。如果無法運作，請參閱您的硬體檔。Windows 正在移除此裝置。 (21)

此裝置已停用。 (22)

系統失敗：請嘗試變更此裝置的驅動程式。如果無法運作，請參閱您的硬體檔。 (23)

此裝置不存在、無法正常運作，或未安裝其所有驅動程式。 (24)

Windows 仍在設定此裝置。 (25)

Windows 仍在設定此裝置。 (26)

此裝置沒有有效的記錄設定。 (27)

未安裝此裝置的驅動程式。 (28)

此裝置已停用，因為裝置的韌體未提供所需的資源。 (29)

此裝置使用另一部裝置所使用的中斷要求 (IRQ) 資源。 (30)

此裝置無法正常運作，因為 Windows 無法載入此裝置所需的驅動程式。 (31)

ConfigManagerUserConfig

資料類型： 布林值
存取類型：唯讀
限定詞：架構 (「Win32」)

如果 為 True，則裝置使用使用者定義的組態。

此屬性繼承自 CIM_LogicalDevice。

CreationClassName

資料類型： 字串。
存取類型：唯讀
限定詞： CIM_Key

要出現在實例建立時所使用之繼承鏈結中之第一個具體類別的名稱。與類別的其他索引鍵屬性搭配使用時，屬性可讓這個類別及其子類別的所有實例唯一識別。

此屬性繼承自 CIM_LogicalDevice。

說明

資料類型：字串
存取類型：唯讀
限定詞： DisplayName (「Description」)

物件的描述。

此屬性繼承自 CIM_ManagedSystemElement。

DeviceID

資料類型：字串
存取類型：唯讀
限定詞： Key、 Override (「DeviceId」) 、 MappingStrings (「WMI」)

磁片磁碟機和磁碟分割的唯一識別碼，來自系統的其餘部分。

DiskIndex

資料類型： uint32
存取類型：唯讀
限定詞： MappingStrings (「Win32API|檔案函式 |ReadFile「)

包含此磁碟分割的磁片索引編號。

範例：0

ErrorCleared

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

如果 為 True，則現在會清除 LastErrorCode 中回報的錯誤。

此屬性繼承自 CIM_LogicalDevice。

ErrorDescription

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

LastErrorCode中記錄之錯誤的相關資訊，以及可能採取之任何更正動作的資訊。

此屬性繼承自 CIM_LogicalDevice。

ErrorMethodology

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

此儲存範圍所支援的錯誤偵測和更正類型。

此屬性繼承自 CIM_StorageExtent。

HiddenSectors

資料類型： uint32
存取類型：唯讀
限定詞： MappingStrings (「Win32API」)

分割區中的隱藏磁區數目。

範例：63

IdentifyingDescriptions

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

自由格式字串陣列，提供 OtherIdentificationInfo 陣列中專案背後的說明和詳細資料。請注意，此陣列的每個專案都與位於相同索引之 OtherIdentificationInfo 中的專案相關。

此屬性繼承自 CIM_LogicalDevice。

Index

資料類型： uint32
存取類型：唯讀
限定詞： MappingStrings (「WMI」)

資料分割的索引編號。

範例：1

InstallDate

資料類型： datetime
存取類型：唯讀
限定詞： MappingStrings (「MIF。DMTF|ComponentID|001.5「) ， DisplayName (」Install Date「)

安裝物件的日期。這個屬性不需要值來指出已安裝物件。

此屬性繼承自 CIM_ManagedSystemElement。

LastErrorCode

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

邏輯裝置回報的最後一個錯誤碼。

此屬性繼承自 CIM_LogicalDevice。

MaxQuiesceTime

資料類型： uint64
存取類型：唯讀
限定詞： 已取消許可權

裝置可以處於靜止狀態的最大時間，以毫秒為單位。裝置的狀態定義在其可用性和 AdditionalAvailability 屬性中，其中 Quiesced 會由值 21 傳達。在時間限制結束時發生的情況是裝置特定的。裝置可能未經查詢、離線或採取其他動作。值為 0 表示裝置可以無限期地停止。

注意

「MaxQuiesceTime 屬性已被取代。評估使用 Quiesce 時，判斷這個單一屬性不足以描述裝置何時會自動結束靜止狀態。事實上，裝置結束靜止狀態的最可能案例是根據排入佇列的未處理要求數目，而不是根據最大時間決定。這會在稍後重新評估並重新置放。 \n

此屬性繼承自 CIM_LogicalDevice。

名稱

資料類型：字串
存取類型：唯讀
限定詞： DisplayName (「Name」)

已知物件的標籤。當子類別化時，屬性可以覆寫為索引鍵屬性。

此屬性繼承自 CIM_ManagedSystemElement。

NumberOfBlocks

資料類型： uint64
存取類型：唯讀
限定詞： MappingStrings (「MIB。IETF|HOST-RESOURCES-MIB.hrStorageSize「)

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

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

此屬性繼承自 CIM_StorageExtent。

OtherIdentifyingInfo

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

擷取 DeviceID 資訊以外的其他資料的陣列，可用來識別 LogicalDevice。其中一個範例是保留此屬性中裝置的作業系統使用者易記名稱。最大長度為 256。

此屬性繼承自 CIM_LogicalDevice。

PNPDeviceID

資料類型：字串
存取類型：唯讀
限定詞：架構 (「Win32」)

Windows 隨插即用邏輯裝置的裝置識別碼。

範例：「*PNP030b」

此屬性繼承自 CIM_LogicalDevice。

PowerManagementCapabilities

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

指出邏輯裝置的特定電源相關功能。陣列值 0=「Unknown」， 1=「Not Supported」和 2=「Disabled」是自我說明。值 3=「Enabled」表示電源管理功能目前已啟用，但確切的功能集未知或資訊無法使用。「自動輸入電源模式」 (4) 說明裝置可以根據使用量或其他準則變更其電源狀態。「Power State Settable」 (5) 表示支援 SetPowerState 方法。「Power Cycle Supported」 (6) 表示可以使用 PowerState 輸入變數設定為 5 (「Power Cycle」) 叫用 SetPowerState 方法。「Timed Power On Supported」 (7) 表示可以使用 PowerState 輸入變數設定為 5 (「Power Cycle」) 叫用 SetPowerState 方法，並將 Time 參數設定為特定日期和時間或開啟電源的間隔。

此屬性繼承自 CIM_LogicalDevice。

未知 (0)

不支援 (1)

已停用 (2)

已啟用 (3)

自動輸入的省電模式 (4)

Power State Settable (5)

(6) 支援電源迴圈

支援的計時電源 (7)

PowerManagementSupported

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

如果 為 True，則裝置可以受電源管理 (可以進入暫停模式，依此類) 。屬性不會指出電源管理功能目前已啟用，只有邏輯裝置能夠進行電源管理。

此屬性繼承自 CIM_LogicalDevice。

PowerOnHours

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

自上次電源週期起，此裝置已啟動的連續時數。

此屬性繼承自 CIM_LogicalDevice。

PrimaryPartition

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

如果 為 True，則為主要分割區。

此屬性繼承自 CIM_DiskPartition。

目的

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

媒體及其使用的描述。

此屬性繼承自 CIM_StorageExtent。

RewritePartition

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32API|裝置輸入和輸出結構 |PARTITION_INFORMATION|RewritePartition「)

如果 為 True，則表示分割區資訊已變更。當您使用 IOCTL_DISK_SET_DRIVE_LAYOUT) 變更資料分割 (時，系統會使用此屬性來判斷哪些分割區已變更，並需要其資訊重寫。如果 為 TRUE，則必須重寫資料分割。

大小

資料類型： uint64
存取類型：唯讀
限定詞： MappingStrings (「Win32API|檔案函式 |ReadFile「) ，單位 (」bytes「)

資料分割的大小總計。

範例：1059045376

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

StartingOffset

資料類型： uint64
存取類型：唯讀
限定詞： MappingStrings (「Win32API|檔案函式 |ReadFile「) ，單位 (」bytes「)

開始位移 (以位元組為單位的資料分割) 。

範例：32256

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

狀態

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (10) 、 DisplayName (「Status」)

物件的目前狀態。您可以定義各種作業和非操作狀態。作業狀態包括：「確定」、「已降級」和「預先失敗」 (啟用 SMART 功能的硬碟等元素可能正常運作，但預測近期) 失敗。非操作狀態包括：「Error」、「Starting」、「Stopping」和「Service」。後者「服務」可能會在磁片的鏡像重新處理期間套用、重載使用者權限清單或其他系統管理工作。並非所有這類工作都在線上，但 Managed 元素既不是「確定」，也不是處於其他狀態之一。

此屬性繼承自 CIM_ManagedSystemElement。

值如下：

OK (「OK」)

錯誤 (「錯誤」)

降級 (「已降級」)

未知 (「未知」)

預先失敗 (「預先失敗」)

開始 (「開始」)

停止 (「停止」)

服務 (「服務」)

壓力 (「壓力」)

NonRecover (「NonRecover」)

沒有連絡人 (「沒有連絡人」)

Lost Comm (「Lost Comm」)

StatusInfo

資料類型： uint16
存取類型：唯讀
限定詞： MappingStrings (「MIF。DMTF|操作狀態|003.3「)

邏輯裝置的狀態。如果此屬性不適用於邏輯裝置，則應該使用值 5 (「不適用」) 。

此屬性繼承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

已啟用 (3)

已停用 (4)

不適用 (5)

SystemCreationClassName

資料類型：字串
存取類型：唯讀
限定詞：傳播 (「CIM_System。CreationClassName「) ， CIM_Key

建立範圍系統的類別名稱。

此屬性繼承自 CIM_LogicalDevice。

SystemName

資料類型：字串
存取類型：唯讀
限定詞：傳播 (「CIM_System。名稱「) ， CIM_Key

範圍系統的名稱。

此屬性繼承自 CIM_LogicalDevice。

TotalPowerOnHours

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

此裝置已啟動的總時數。

此屬性繼承自 CIM_LogicalDevice。

類型

資料類型：字串
存取類型：唯讀
限定詞： MappingStrings (「Win32API|PartitionRecord|dwPartitionType「)

資料分割的類型。

值如下：

「未使用」

「12 位 FAT」

「Xenix Type 1」

「Xenix Type 2」

「16 位 FAT」

「擴充分割區」

「MS-DOS V4 Huge」

「可安裝檔案系統」

「PowerPC 參考平臺」

「UNIX」

「NTFS」

「Win95 w/Extended Int 13」

「Extended w/Extended Int 13」

「邏輯磁片管理員」

「未知」

未使用的 (「未使用」)

12 位 FAT (「12 位 FAT」)

Xenix Type 1 (「Xenix Type 1」)

Xenix Type 2 (「Xenix Type 2」)

16 位 FAT (「16 位 FAT」)

擴充分割 區 (「擴充分割區」)

MS-DOS V4 大型 (「MS-DOS V4 Huge」)

可安裝的檔案系統 (「可安裝檔案系統」)

PowerPC 參考平臺 (「PowerPC 參考平臺」)

UNIX (「UNIX」)

NTFS (「NTFS」)

Win95 w/Extended Int 13 (「Win95 w/Extended Int 13」)

擴充 w/Extended Int 13 (「Extended w/Extended Int 13」)

邏輯磁片管理員 (「邏輯磁片管理員」)

未知 (「未知」)

備註

Win32_DiskPartition類別衍生自CIM_DiskPartition。

磁碟分割是實體磁片磁碟機的結構分割。雖然磁片磁碟機可以包含單一磁碟分割，但較大的磁片區通常分成多個分割區。這就是為什麼即使您的電腦只有單一實體硬碟，您還是可能會有 C、D 和 E 磁片磁碟機。

Windows 支援下列資料分割類型：

主要分割區。這是可安裝作業系統的唯一分割區類型。每個磁片磁碟機可以有多達四個主要磁碟分割，每個磁碟分割都會指派不同的磁碟機號。
擴充分割區。可細分為多個邏輯磁片磁碟機的額外分割區，每個磁碟分割都會指派唯一的磁碟機號。磁片磁碟機只能有一個擴充磁碟分割;不過，您可以將此分割區分割成多個邏輯磁片磁碟機。這可讓磁片擁有超過四個允許的主要分割區。
系統分割區。包含作業系統的任何主要分割區。

磁碟分割可以告訴您實際使用實體磁片磁碟機的方式。藉由檢查磁片上的實體磁碟分割，您可以判斷下列類型的專案：

磁片如何分割成邏輯磁片磁碟機。
如果磁片上有未分割的空間。這可藉由從磁片本身的大小減去磁片上所有分割區的大小來決定。
如果您可以從該磁片 (將電腦開機，磁片是否包含開機磁碟分割) 。

所有這些問題都可以使用 Win32_DiskPartition 類別來解決。

範例

下列 PowerShell 程式碼範例會檢查電腦上的磁片對齊方式：如果位移為小數，則磁片未正確對齊。

$wql = "SELECT DiskIndex,Index,StartingOffset FROM Win32_DiskPartition"
Get-WmiObject -Query $wql -ComputerName '.' | Select-Object DiskIndex,Index,@{Name='Offset (KB)';Expression={$_.StartingOffset / 1024}} | Format-Table -AutoSize

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
命名空間	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另請參閱

CIM_DiskPartition
作業系統類別
WMI 工作：磁片和檔案系統

Share via

Win32_DiskPartition 類別

語法

成員

方法

屬性

備註

範例

規格需求

另請參閱

意見反應

意見反應

其他資源