MSFT_VirtualDisk 类
表示子系统存储卷。
以下语法由托管对象格式 (MOF) 代码简化而来。
语法
class MSFT_VirtualDisk : MSFT_StorageObject
{
String FriendlyName;
String Name;
UInt16 NameFormat;
UInt16 UniqueIdFormat;
String UniqueIdFormatDescription;
UInt16 Usage;
String OtherUsageDescription;
UInt16 HealthStatus;
UInt16 OperationalStatus[];
String OtherOperationalStatusDescription;
String ResiliencySettingName;
UInt64 Size;
UInt64 AllocatedSize;
UInt64 LogicalSectorSize;
UInt64 PhysicalSectorSize;
UInt64 FootprintOnPool;
UInt16 ProvisioningType;
UInt16 NumberOfDataCopies;
UInt16 PhysicalDiskRedundancy;
UInt16 ParityLayout;
UInt16 NumberOfColumns;
UInt64 Interleave;
Boolean RequestNoSinglePointOfFailure;
UInt16 Access;
Boolean IsSnapshot;
Boolean IsManualAttach;
Boolean IsDeduplicationEnabled;
Boolean IsEnclosureAware;
UInt16 NumberOfAvailableCopies;
UInt16 DetachedReason;
UInt64 WriteCacheSize;
};
成员
MSFT_VirtualDisk类具有以下类型的成员：
方法
MSFT_VirtualDisk类具有这些方法。
| 方法 | 说明 |
|---|---|
| AddPhysicalDisk | 为手动分配添加一个或多个物理磁盘。 |
| 附加 | 附加虚拟磁盘。 |
| CreateClone | 创建一个新的虚拟磁盘，该虚拟磁盘是现有虚拟磁盘的克隆。 |
| CreateReplica | 在虚拟磁盘之间创建复制关系。 |
| CreateSnapshot | 创建虚拟磁盘的克隆，从而生成一个新的虚拟磁盘，其数据与原始虚拟磁盘的数据相同。 |
| DeleteObject | 删除虚拟磁盘。 |
| 分离 | 分离虚拟磁盘。 |
| GetSecurityDescriptor | 检索控制对虚拟磁盘对象实例的访问的安全描述符。 |
| 隐藏 | 隐藏虚拟磁盘。 |
| RemovePhysicalDisk | 从手动分配中删除一个或多个物理磁盘。 |
| Repair | 启动虚拟磁盘的修复，将数据和冗余还原到存储池中的不同（或新）物理磁盘。 |
| 调整大小 | 调整虚拟磁盘的大小。 |
| SetAttributes | 设置或更新虚拟磁盘的各种属性。 |
| SetFriendlyName | 设置虚拟磁盘的友好名称。 |
| SetReplicationRelationship | 设置虚拟磁盘之间的复制关系。 |
| SetSecurityDescriptor | 设置控制对虚拟磁盘对象实例的访问的安全描述符。 |
| SetUsage | 设置虚拟磁盘的预期用途。 |
| 显示 | 公开虚拟磁盘。 |
属性
MSFT_VirtualDisk类具有以下属性。
Access
数据类型：UInt16
访问类型：只读
指示虚拟磁盘是否可用于读取和写入访问。
未知 (0)
可 读 （1）
可 写 （2）
读/写 （3）
写入一次 （4）
AllocatedSize
数据类型：UInt64
访问类型：只读
虚拟磁盘当前分配的大小。 如果虚拟磁盘的 ProvisioningType 是固定的，则 AllocatedSize 应等于 Size。 如果 ProvisioningType 为 Thin，则此值是实际分配的空间量（必须小于大小）。
DetachedReason
数据类型：UInt16
访问类型：只读
此虚拟磁盘分离的原因。 仅当虚拟磁盘的 OperationalStatus 包含 “已分离”时，才会设置此属性。 请注意，此字段特定于存储空间。
未知 (0)
无 （1）
按策略 （2）
大多数磁盘运行不正常 （3）
不完整 （4）
FootprintOnPool
数据类型：UInt64
访问类型：只读
限定符：单位（字节）
此虚拟磁盘正在使用的总存储池容量（以字节为单位）。 例如，对于大小为 1 GB 的 2 向镜像虚拟磁盘，池中的占用空间约为 2 GB。
FriendlyName
数据类型： 字符串
访问类型：只读
限定符：Required
用户可设置的面向显示的字符串，其中包含虚拟磁盘的名称。
HealthStatus
数据类型：UInt16
访问类型：只读
限定符：Required
虚拟磁盘的运行状况。
虚拟磁盘的运行状况派生自支持物理磁盘的运行状况，以及虚拟磁盘能否维持所需的复原能力级别。
| 值 | 含义 |
|---|---|
| 正常 0 | 所有物理磁盘都存在，且处于正常状态。 |
| 警告 1 | 大部分物理磁盘都运行正常，但一个或多个磁盘可能会出现 I/O 请求失败。 |
| 不正常 2 | 大多数物理磁盘不正常或处于故障状态，并且虚拟磁盘不再具有数据完整性。 |
| 未知 5 | 运行状况未知。 |
交织
数据类型：UInt64
访问类型：只读
将在基于条带化的常见复原设置中形成条带的字节数。 条带定义为位于一个物理磁盘上的条带部分的大小。 因此，Interleave * NumberOfColumns 将产生一条用户数据条带的大小。
IsDeduplicationEnabled
数据类型： 布尔值
访问类型：读/写
如果为虚拟磁盘启用了重复数据删除，则为 TRUE 。
IsEnclosureAware
数据类型： 布尔值
访问类型：只读
此虚拟磁盘的当前分配行为。 机箱感知虚拟磁盘将智能地选取用于其冗余的物理磁盘。 如果 为 TRUE，虚拟磁盘将尝试使用不同的机箱中的物理磁盘来平衡两个或多个物理机箱之间的容错能力。
IsManualAttach
数据类型： 布尔值
访问类型：读/写
如此 如果此虚拟磁盘仅在对 Attach 方法进行显式调用时才会附加到系统。 请注意，此属性特定于存储空间。
IsSnapshot
数据类型： 布尔值
访问类型：只读
如果此虚拟磁盘是另一个虚拟磁盘的卷影副本，则为 TRUE 。
LogicalSectorSize
数据类型：UInt64
访问类型：只读
限定符：单位（字节）
虚拟磁盘的逻辑扇区大小（以字节为单位）。
Name
数据类型：String
访问类型：只读
限定符：Required
一个半唯一（作用域为拥有的存储子系统），用于标识虚拟磁盘的人类可读字符串。
NameFormat
数据类型：UInt16
访问类型：只读
限定符：Required
Name 属性的格式。
未知 (0)
其他 (1)
VPD83NAA6 （2）
VPD83NAA5 （3）
VPD83Type2 （4）
VPD83Type1 （5）
VPD83Type0 （6）
SNVM （7）
NodeWWN （8）
NAA （9）
EUI64 （10）
T10VID （11）
NumberOfAvailableCopies
数据类型：UInt16
访问类型：只读
可用数据的一致副本数。
NumberOfColumns
数据类型：UInt16
访问类型：只读
在其中对此虚拟磁盘的数据进行条带化的基础物理磁盘数。
NumberOfDataCopies
数据类型：UInt16
访问类型：只读
正在为虚拟磁盘维护的完整数据副本数。 例如，RAID 5 维护一个数据副本，而 RAID 1 至少维护两个副本。
OperationalStatus
数据类型：UInt16 数组
访问类型：只读
一个值数组，指示虚拟磁盘的当前操作条件。 与 HealthStatus 不同，此属性指示与此虚拟磁盘相关的硬件、软件和基础结构问题的状态，并且可以包含多个值。
| 值 | 含义 |
|---|---|
| 未知 0 | 运行状态未知。 |
| 其他 1 | 通过设置 OtherOperationalStatusDescription 属性，指定了特定于供应商的 OperationalStatus。 |
| 确定 2 | 虚拟磁盘正在响应命令，并且处于正常操作状态。 |
| 降级 3 | 虚拟磁盘正在响应命令，但未处于最佳运行状态。 |
| 压力 4 | |
| 预测失败 5 | |
| 错误 6 | |
| 不可恢复的错误 7 | |
| 起始时间 8 | |
| 停止 9 | |
| 已停止 10 | 虚拟磁盘正在响应命令，但未处于最佳运行状态。 |
| 在服务 11 中 | 正在配置、维护、清理或管理虚拟磁盘。 |
| 无联系人 12 | |
| 丢失通信 13 | |
| 中止 14 | |
| 休眠 15 | |
| 错误 16 中的支持实体 | |
| 已完成 17 | |
| 电源模式 18 | |
| 重定位 19 | |
| 分离0xD002 | 此值是为 Windows 保留的。 对主机系统可见但没有磁盘设备对象的虚拟磁盘。 |
| 不完整的0xD003 | 虚拟磁盘没有足够的冗余来成功修复或重新生成其数据。 |
OtherOperationalStatusDescription
数据类型：String
访问类型：只读
如果 OperationalStatus 包含 Other，则此属性是包含供应商定义的操作状态的字符串。 如果 OperationalStatus 不包含其他属性，则该属性必须为 NULL。
OtherUsageDescription
数据类型：String
访问类型：只读
如果虚拟磁盘的 Usage 属性设置为 “其他”，则此属性必须包含供应商或用户定义的使用情况的说明。 如果未 将 Usage 设置为 Other，则此属性必须为 NULL。
ParityLayout
数据类型：UInt16
访问类型：只读
用于基于奇偶校验的复原设置的奇偶校验布局的类型。 如果虚拟磁盘不使用基于奇偶校验的复原设置，则此属性应为 NULL 。
非旋转奇偶校验 （1）
旋转奇偶 校验 （2）
PhysicalDiskRedundancy
数据类型：UInt16
访问类型：只读
支持物理磁盘的数量，这些磁盘可能会失败，而不会影响数据冗余。 例如：RAID 0 不能容忍任何故障，RAID 5 可以容忍单个驱动器故障，RAID 6 可以容忍两次故障。
PhysicalSectorSize
数据类型：UInt64
访问类型：只读
限定符：单位（字节）
虚拟磁盘的物理扇区大小（以字节为单位）。
ProvisioningType
数据类型：UInt16
访问类型：只读
限定符：Required
虚拟磁盘的预配方案。
| 值 | 含义 |
|---|---|
| 未知 0 | 预配方案未知。 |
| 瘦 1 | 虚拟磁盘的容量是按需分配的。 |
| 已修复 2 | 虚拟磁盘的容量在创建时完全分配。 |
RequestNoSinglePointOfFailure
数据类型： 布尔值
访问类型：只读
设置为 TRUE 以请求无单一故障点。
ResiliencySettingName
数据类型： 字符串
访问类型：只读
限定符：必填，ModelCorrespondence {"MSFT_ResiliencySetting.Name"}
虚拟磁盘的复原设置的名称。
大小
数据类型：UInt64
访问类型：只读
虚拟磁盘的逻辑大小（以字节为单位）。
UniqueIdFormat
数据类型：UInt16
访问类型：只读
限定符：必需、值（“供应商特定”、“供应商 ID”、“EUI64”、“FCPH 名称”、“SCSI 名称字符串”）、ValueMap （“0”、“1”、“2”、“3”、“8”），ModelCorrespondence {“MSFT_StorageObject.UniqueId”}
此类继承自 MSFT_StorageObject 类的 UniqueId 属性中使用的标识符类型。 此标识符必须是使用以下首选项顺序的最高可用标识符：8（最高）、3、2、1、0（最低）。
例如，如果虚拟磁盘设备公开类型为 0、1 和 3 的标识符， UniqueId 必须是类型 3 标识符， 并且 UniqueIdFormat 应设置为 3。
UniqueIdFormatDescription
数据类型： 字符串
访问类型：只读
限定符：ModelCorrespondence {“MSFT_StorageObject.UniqueId”}， ModelCorrespondence {“MSFT_VirtualDisk.UniqueIdFormat”}
UniqueIdFormat 的某些值可能包含各种子格式。 此属性是一个自由格式字符串，用于描述 UniqueId 中使用的特定格式。
使用情况
数据类型：UInt16
访问类型：读/写
限定符：Required
此虚拟磁盘的预期用途。
未知 (0)
其他 (1)
非受限 (2)
为 ComputerSystem（块服务器）保留 (3)
复制服务 保留 （4）
迁移服务 保留 （5）
本地副本源 （6）
远程副本源 （7）
本地副本目标 （8）
远程副本目标 （9）
本地副本源或目标 （10）
远程副本源或目标 （11）
增量副本目标 （12）
元素组件 （13）
保留为池参与者 （14）
复合卷成员 （15）
复合 VirtualDisk 成员 （16）
保留为稀疏 （17）
WriteCacheSize
数据类型：UInt64
访问类型：只读
虚拟磁盘的写入缓存的大小。
注解
与物理磁盘相比，虚拟磁盘是具有扩展的属性集的可用存储单位。 其他属性的示例包括复原能力和动态容量扩展。
LUN 和存储空间是虚拟磁盘的示例。
向 Windows 公开时，虚拟磁盘显示为 Windows 堆栈的其余部分（Windows）磁盘。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
| 命名空间 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |