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 启动虚拟磁盘的修复，将数据和冗余还原到存储池中的不同 (或新的) 物理磁盘。
Resize 调整虚拟磁盘的大小。
SetAttributes 设置或更新虚拟磁盘的各种属性。
SetFriendlyName 设置虚拟磁盘的友好名称。
SetReplicationRelationship 设置虚拟磁盘之间的复制关系。
SetSecurityDescriptor 设置控制对虚拟磁盘对象实例的访问的安全描述符。
SetUsage 设置虚拟磁盘的预期用途。
显示 公开虚拟磁盘。

属性

MSFT_VirtualDisk 类具有这些属性。

Access

数据类型： UInt16

访问类型：只读

指示虚拟磁盘是否可用于读取和写入访问。

未知 (0)

可读 (1)

可写 (2)

读/写 (3)

写入一次 (4)

AllocatedSize

数据类型： UInt64

访问类型：只读

限定符： 必需， 单位 (“字节”)

虚拟磁盘的当前分配大小。 如果虚拟磁盘的 ProvisioningType 为 Fixed， 则 AllocatedSize 应等于 Size。 如果 ProvisioningType 为 Thin，则此值为实际分配的空间量 (必须小于 Size) 。

DetachedReason

数据类型： UInt16

访问类型：只读

分离此虚拟磁盘的原因。 仅当虚拟磁盘的 OperationalStatus 包含 Detached 时，才会设置此属性。 请注意，此字段特定于存储空间。

未知 (0)

无 (1)

按策略 (2)

多数磁盘运行不正常 (3)

未完成 (4)

FootprintOnPool

数据类型： UInt64

访问类型：只读

限定符： 单位 (“字节”)

此虚拟磁盘消耗的总存储池容量（以字节为单位）。 例如，对于大小为 1 GB 的双向镜像虚拟磁盘，池中的占用空间大约为 2 GB。

FriendlyName

数据类型： 字符串

访问类型：只读

限定符： 必需

一个面向用户设置的、面向显示的字符串，其中包含虚拟磁盘的名称。

HealthStatus

数据类型： UInt16

访问类型：只读

限定符： 必需

虚拟磁盘的运行状况。

虚拟磁盘的运行状况派生自后备物理磁盘的运行状况，以及虚拟磁盘是否可以保持所需的复原级别。

值 含义
正常 0 所有物理磁盘都存在且处于正常状态。
警告 1 大多数物理磁盘运行正常，但一个或多个可能正在失败的 I/O 请求。
不正常 2 大多数物理磁盘不正常或处于故障状态，虚拟磁盘不再具有数据完整性。
未知 5 运行状况未知。

交织

数据类型： UInt64

访问类型：只读

将在基于条带化的常见复原设置中形成条带的字节数。 条带定义为位于一个物理磁盘上的条带部分的大小。 因此 ，Interleave * NumberOfColumns 将产生用户数据条带的大小。

IsDeduplicationEnabled

数据类型： 布尔值

访问类型：读/写

如果为虚拟磁盘启用了重复数据删除，则为 TRUE。

IsEnclosureAware

数据类型： 布尔值

访问类型：只读

此虚拟磁盘的当前分配行为。 机箱感知虚拟磁盘将智能地选取用于冗余的物理磁盘。 如果 为 TRUE，虚拟磁盘将尝试使用不同机箱中的物理磁盘来平衡两个或多个物理机箱之间的容错能力。

IsManualAttach

数据类型： 布尔值

访问类型：读/写

如果仅当对 Attach 方法进行显式调用时，此虚拟磁盘才会附加到系统，则为 TRUE。 请注意，此属性特定于存储空间。

IsSnapshot

数据类型： 布尔值

访问类型：只读

如果此虚拟磁盘是另一个虚拟磁盘的卷影副本，则为 TRUE。

LogicalSectorSize

数据类型： UInt64

访问类型：只读

限定符： 单位 (“Bytes”)

虚拟磁盘的逻辑扇区大小（以字节为单位）。

名称

数据类型： 字符串

访问类型：只读

限定符： 必需

一个半唯一 (范围限定为拥有的存储子系统，) 用于标识虚拟磁盘的可读字符串。

NameFormat

数据类型： UInt16

访问类型：只读

限定符： 必需

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

数据类型： 字符串

访问类型：只读

如果 OperationalStatus 包含 Other，则此属性是包含供应商定义的操作状态的字符串。 如果 OperationalStatus 不包含 Other，则此属性必须为 NULL。

OtherUsageDescription

数据类型： 字符串

访问类型：只读

如果虚拟磁盘的 Usage 属性设置为 Other，则此属性必须包含供应商或用户定义的使用情况的说明。 如果未将 Usage 设置为 Other，则此属性必须为 NULL。

ParityLayout

数据类型： UInt16

访问类型：只读

用于基于奇偶校验的复原设置的奇偶校验布局的类型。 如果虚拟磁盘不使用基于奇偶校验的复原设置，则此属性应为 NULL 。

非旋转奇偶校验 (1)

旋转奇偶校验 (2)

PhysicalDiskRedundancy

数据类型： UInt16

访问类型：只读

可以在不影响数据冗余的情况下发生故障的后备物理磁盘的数量。 例如：RAID 0 不能容忍任何故障，RAID 5 可以容忍单个驱动器故障，RAID 6 可以容忍两次故障。

PhysicalSectorSize

数据类型： UInt64

访问类型：只读

限定符： 单位 (“字节”)

虚拟磁盘的物理扇区大小（以字节为单位）。

ProvisioningType

数据类型： UInt16

访问类型：只读

限定符： 必需

虚拟磁盘的预配方案。

值 含义
未知 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

访问类型：读/写

限定符： 必需

此虚拟磁盘的预期用途。

未知 (0)

其他 (1)

无限制 (2)

保留给计算机系统 (块服务器) (3)

由复制服务保留 (4)

由迁移服务保留 (5)

本地副本源 (6)

远程副本源 (7)

本地副本目标 (8)

远程副本目标 (9)

本地副本源或目标 (10)

远程副本源或目标 (11)

增量副本目标 (12)

元素组件 (13)

保留为池参与者 (14)

复合卷成员 (15)

Composite VirtualDisk 成员 (16)

保留用于 17 (17)

WriteCacheSize

数据类型： UInt64

访问类型：只读

虚拟磁盘的写入缓存的大小。

注解

与物理磁盘相比，虚拟磁盘是具有一组扩展属性的可用存储单元。 其他属性的示例包括复原能力和动态容量扩展。

LUN 和存储空间是虚拟磁盘的示例。

虚拟磁盘在向 Windows 公开时显示为 (Windows) Windows 堆栈其余部分的磁盘。

要求

要求 值
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
命名空间 Root\Microsoft\Windows\Storage
MOF Storagewmi.mof