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 类具有这些方法。

方法	说明
重置	请求重置逻辑设备。
SetPowerState	设置逻辑设备的所需电源状态，以及设备何时应进入该状态。

属性

Win32_DiskPartition 类具有以下属性。

访问

数据类型： uint16
访问类型：只读

媒体访问可用。

此属性继承自 CIM_StorageExtent。

未知 (0)

可读 (1)

可写 (2)

可写

支持读/写 (3)

写入一次 (4)

AdditionalAvailability

数据类型： unit16
访问类型：仅写

超出可用性属性中指定的设备的其他可用性和状态。 Availability 属性表示设备的主要状态和可用性。在某些情况下，这不足以表示设备的完整状态。在这些情况下， AdditionalAvailability 属性可用于提供进一步的信息。例如，设备的主要 可用性 可能为 off line (value=8) ，但它也可能处于低功耗状态， (AdditonalAvailability value=14) ，或者设备可能在测试) 中运行诊断 (AdditionalAvailability value=5”。

此属性继承自 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)

可用性

数据类型： 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)

设备无法正常工作，但可以快速通电。

电源周期 (16)

节电 - 警告 (17)

设备处于警告状态，不过也处于节电模式。

暂停 (18)

设备已暂停。

未就绪 (19)

设备未准备就绪。

未配置 (20)

设备未配置。

静止 (21)

设备安静。

BlockSize

数据类型： uint64
访问类型：只读
限定符： MappingStrings (“MIB”。IETF |HOST-RESOURCES-MIB.hrStorageAllocationUnits“) ， Units (”bytes“)

构成此存储区的块的大小（以字节为单位）。如果未知或块概念无效 (例如，对于聚合盘区、内存或逻辑磁盘) ，请输入 1。

有关在脚本中使用 uint64 值的详细信息，请参阅在 WMI 中编写脚本。

此属性继承自 CIM_StorageExtent。

Bootable

数据类型： 布尔值
访问类型：只读

指示计算机是否可以从此分区启动。

此属性继承自 CIM_DiskPartition。

BootPartition

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|文件函数 |ReadFile“)

分区是活动分区。从硬盘启动时，操作系统使用活动分区。

Caption

数据类型： 字符串。
访问类型：只读
限定符： 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

数据类型： 字符串
访问类型：只读
限定符：键、替代 (“DeviceId”) 、 MappingStrings (“WMI”)

磁盘驱动器和分区的唯一标识符，来自系统的其余部分。

DiskIndex

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|文件函数 |ReadFile“)

包含此分区的磁盘的索引号。

示例：0

ErrorCleared

数据类型： 布尔值
访问类型：只读

如果 为 True，则现已清除 LastErrorCode 中报告的错误。

此属性继承自 CIM_LogicalDevice。

ErrorDescription

数据类型： 字符串
访问类型：只读

有关 LastErrorCode 中记录的错误的信息，以及有关可能采取的任何纠正措施的信息。

此属性继承自 CIM_LogicalDevice。

ErrorMethodology

数据类型： string
访问类型：只读

此存储区支持的错误检测和更正的类型。

此属性继承自 CIM_StorageExtent。

HiddenSectors

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API”)

分区中的隐藏扇区数。

示例：63

IdentifyingDescriptions

数据类型： 字符串 数组
访问类型：只读

一个自由格式字符串数组，提供 OtherIdentifyingInfo 数组中条目背后的说明和详细信息。请注意，此数组的每个条目都与位于同一索引处的 OtherIdentifyingInfo 中的条目相关。

此属性继承自 CIM_LogicalDevice。

Index

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“WMI”)

分区的索引号。

示例：1

InstallDate

数据类型： datetime
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)

对象的安装日期。此属性不需要值来指示已安装对象。

此属性继承自 CIM_ManagedSystemElement。

LastErrorCode

数据类型： uint32
访问类型：只读

逻辑设备报告的最后一个错误代码。

此属性继承自 CIM_LogicalDevice。

MaxQuiesceTime

数据类型： uint64
访问类型：只读
限定符： 已取消特权

设备可在静止状态下运行的最长时间（以毫秒为单位）。设备的状态在其可用性和附加可用性属性中定义，其中静止状态由值 21 表示。时间限制结束时发生的情况特定于设备。设备可能会取消服务、脱机或采取其他操作。如果值为 0，则表示设备可以无限期地保持静止状态。

注意

“MaxQuiesceTime 属性已弃用。评估静止的使用时，确定此单个属性不足以描述设备何时自动退出静止状态。事实上，设备退出静止状态的最可能方案是根据排队的未完成请求数确定的，而不是根据最大时间确定的。稍后将重新评估并重新定位。 \n

此属性继承自 CIM_LogicalDevice。

名称

数据类型： string
访问类型：只读
限定符： 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

数据类型： string
访问类型：只读
限定符：架构 (“Win32”)

Windows 即插即用逻辑设备的设备标识符。

示例：“*PNP030b”

此属性继承自 CIM_LogicalDevice。

PowerManagementCapabilities

数据类型： uint16 数组
访问类型：只读

指示逻辑设备与电源相关的特定功能。数组值 0=“Unknown”、1=“Not Supported”和 2=“Disabled”不言自明。值 3=“Enabled”表示当前已启用电源管理功能，但确切的功能集未知或信息不可用。 “自动输入的节能模式” (4) 描述设备可以根据使用情况或其他条件更改其电源状态。 “Power State Settable” (5) 表示支持 SetPowerState 方法。 “支持电源循环” (6) 指示可以使用 PowerState 输入变量设置为 5 (“Power Cycle”) 调用 SetPowerState 方法。 “支持定时开机” (7) 指示可以使用 PowerState 输入变量设置为 5 (“Power Cycle”) 并将 Time 参数设置为开机的特定日期和时间或间隔来调用 SetPowerState 方法。

此属性继承自 CIM_LogicalDevice。

未知 (0)

不支持 (1)

已禁用 (2)

已启用 (3)

自动输入的节能模式 (4)

Power State Settable (5)

支持电源循环 (6)

支持计时开机 (7)

PowerManagementSupported

数据类型： 布尔值
访问类型：只读

如果 为 True，则设备可以进行电源管理 (可以置于挂起模式，依此) 。属性并不指示当前已启用电源管理功能，仅指示逻辑设备能够进行电源管理。

此属性继承自 CIM_LogicalDevice。

PowerOnHours

数据类型： uint64
访问类型：只读

此设备自上次电源周期以来已供电的连续小时数。

此属性继承自 CIM_LogicalDevice。

主分区

数据类型： 布尔值
访问类型：只读

如果 为 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 中编写脚本。

Status

数据类型： 字符串
访问类型：只读
限定符： MaxLen (10) 、 DisplayName (“Status”)

对象的当前状态。可以定义各种操作和非操作状态。操作状态包括：“正常”、“降级”和“预失败”， (元素（例如已启用 SMART 的硬盘驱动器）可能正常运行，但预测近期) 故障。非操作状态包括：“错误”、“正在启动”、“正在停止”和“服务”。后者“服务”可以在磁盘镜像重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都处于联机状态，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

有效值为：

OK (“OK”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

starting (“Starting”)

停止 (“停止”)

服务 (“服务”)

压力 (“有压力”)

NonRecover (“NonRecover”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

StatusInfo

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |操作状态|003.3“)

逻辑设备的状态。如果此属性不适用于逻辑设备，则应使用值 5 (“Not Applicable”) 。

此属性继承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

已启用 (3)

禁用 (4)

不适用 (5)

SystemCreationClassName

数据类型： 字符串
访问类型：只读
限定符：传播 (“CIM_System。CreationClassName“) ， CIM_Key

范围系统的创建类名称。

此属性继承自 CIM_LogicalDevice。

SystemName

数据类型： 字符串
访问类型：只读
限定符：传播 (“CIM_System。Name“) ， CIM_Key

范围系统的名称。

此属性继承自 CIM_LogicalDevice。

TotalPowerOnHours

数据类型： uint64
访问类型：只读

此设备已启动的总小时数。

此属性继承自 CIM_LogicalDevice。

类型

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|PartitionRecord|dwPartitionType“)

分区的类型。

有效值为：

“未使用”

“12 位 FAT”

“Xenix 类型 1”

“Xenix 类型 2”

“16 位 FAT”

“扩展分区”

“MS-DOS V4 巨大”

“可安装文件系统”

“PowerPC 参考平台”

“UNIX”

“NTFS”

“Win95 w/Extended Int 13”

“Extended w/Extended Int 13”

“逻辑磁盘管理器”

"Unknown"

未使用 (“未使用”)

12 位 FAT (“12 位 FAT”)

Xenix 类型 1 (“Xenix Type 1”)

Xenix Type 2 (“Xenix Type 2”)

16 位 FAT (“16 位 FAT”)

扩展分区 (“扩展分区”)

MS-DOS V4 大型 (“MS-DOS V4 巨大”)

可安装文件系统 (“可安装文件系统”)

PowerPC 参考平台 (“PowerPC 参考平台”)

UNIX (“UNIX”)

NTFS (“NTFS”)

Win95，带扩展 Int 13 (“Win95，带扩展 Int 13”)

Extended 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 任务：磁盘和文件系统

Win32_DiskPartition 类

语法

成员

方法

属性

备注

示例

要求

另请参阅

反馈

反馈

其他资源