MSFT_PhysicalDisk 类
表示子系统驱动器或主轴。
托管对象格式 (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 类具有这些方法。
| 方法 | 说明 |
|---|---|
| 维护 | 允许在具体池中对物理磁盘执行维护操作，例如固件更新。 |
| 重 置 | 重置物理磁盘。 |
| 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) |
| MAX 14 | 该值已预留供系统使用。 |
| 文件支持的虚拟 15 | File-Backed Virtual |
| 存储空间 16 | 存储空间 |
| NVMe 17 | |
| Microsoft Reserved 18.. | 该值已预留供系统使用。 |
CannotPoolReason
数据类型： UInt16 数组
访问类型：只读
限定符： 必需
一个值数组，指定此物理磁盘无法添加到具体池的原因。 仅当 CanPool 属性为 FALSE 时，此属性才有效。
未知 (0)
其他 (1)
在池 (2)
不正常 (3)
可移动媒体 (4)
按群集使用 (5)
脱机 (6)
容量不足 (7)
备用磁盘 (8)
由子系统 保留 (9)
从 (10)
Microsoft Reserved (.)
供应商预留 (0x8000。)
CanPool
数据类型： 布尔值
访问类型：只读
限定符： 必需
如果此物理磁盘可以添加到具体池，则为 TRUE。
说明
数据类型： 字符串
访问类型：只读
用户可设置的物理磁盘说明。
DeviceId
数据类型： 字符串
访问类型：只读
唯一命名物理磁盘的地址或其他标识符。
EnclosureNumber
数据类型： UInt16
访问类型：只读
磁盘实际驻留的机箱数。
FirmwareVersion
数据类型： 字符串
访问类型：只读
限定符： 必需
固件修订版的字符串表示形式。
FriendlyName
数据类型： 字符串
访问类型：只读
限定符： 必需
物理磁盘的用户友好显示名称。 初始值应由存储提供程序或子系统设置，用户可以在对象生存期内的任何时间点进行修改。
HealthStatus
数据类型： UInt16
访问类型：只读
设备运行状况的高级指示。
| 值 | 含义 |
|---|---|
| 0 | 正常 |
| 1 | 警告 |
| 2 | 不正常 |
| 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
数据类型： 字符串
访问类型：只读
限定符： 必需
软件版本号的字符串表示形式。
SpindleSpeed
数据类型： UInt32
访问类型：只读
基于主轴的物理磁盘的旋转速度。 对于 (SSD) 或其他非旋转介质的固态设备，应将此成员设置为 0。 对于速度未知的旋转媒体，应将此成员设置为 0xFFFFFFFF (UINT32_MAX) 。
SupportedUsages
数据类型： UInt16 数组
访问类型：只读
限定符： 必需
一个值数组，这些值指定此物理磁盘的受支持用法。
| 值 | 含义 |
|---|---|
| 未知 0 | 未指定预期用法。 |
| 自动选择 1 | 此物理磁盘应仅用于数据存储。 |
| 手动选择 2 | 仅当管理员在创建虚拟磁盘时手动选择时，才应使用此物理磁盘。 使用 PhysicalDisksToUse 参数为 CreateVirtualDisk 选择手动选择磁盘。 |
| 热备用 3 | 此物理磁盘应用作热备用磁盘。 |
| 已停用 4 | 此物理磁盘应停用，不再使用。 至少不应将新的分配转到此磁盘。 如果修复了驻留在此磁盘上的虚拟磁盘，则应将数据移动到另一个活动物理磁盘。 |
| 日记 5 | 此物理磁盘应用作包含虚拟磁盘的其他设备的缓存。 它将备份虚拟磁盘的写回缓存（如果已配置）。 |
UniqueIdFormat
数据类型： UInt16
访问类型：只读
限定符： 必需
指示 uniqueId 字段中使用的标识符类型， (继承自 MSFT_StorageObject) 。 UniqueId 中使用的标识符必须是按以下优先顺序排列的最高可用标识符：8 (最高) 、3、2、1、0 (最低) 。 例如，如果物理磁盘设备公开类型为 0、1 和 3 的标识符， 则 UniqueId 必须是类型 3 的标识符，而 UniqueIdFormat 应设置为 3。
供应商特定 (0)
供应商 ID (1)
EUI64 (2)
FCPH 名称 (3)
SCSI 名称字符串 (8)
使用情况
数据类型： UInt16
访问类型：只读
限定符： 必需
此物理磁盘在具体池中的预期用途。
存储池需要遵循为物理磁盘分配的策略。
| 值 | 含义 |
|---|---|
| 未知 0 | 未指定预期用法。 |
| 自动选择 1 | 此物理磁盘应仅用于数据存储。 |
| 手动选择 2 | 仅当管理员在创建虚拟磁盘时手动选择时，才应使用此物理磁盘。 使用 PhysicalDisksToUse 参数为 CreateVirtualDisk 选择手动选择磁盘。 |
| 热备用 3 | 此物理磁盘应用作热备用磁盘。 |
| 已停用 4 | 此物理磁盘应停用，不再使用。 至少不应将新的分配转到此磁盘。 如果修复了驻留在此磁盘上的虚拟磁盘，则应将数据移动到另一个活动物理磁盘。 |
| 日记 5 | 此物理磁盘应用作包含虚拟磁盘的其他设备的缓存。 它将备份虚拟磁盘的写回缓存（如果已配置）。 |
VirtualDiskFootprint
数据类型： UInt16
访问类型：只读
此字段指示此物理磁盘上虚拟磁盘的用户数据占用量的大小（以字节为单位）。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
| 命名空间 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |