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 |