Msvm_DiskDrive 类

项目
06/13/2023

表示虚拟机内的硬盘驱动器。如果物理硬盘已连接到虚拟机) ，则此硬盘驱动器可以是直通设备 (，也可以是填充了虚拟硬盘媒体的合成设备。由于可以从虚拟机添加和删除虚拟和物理硬盘，因此有两个资源池与此类相关联，一个用于直通硬盘，另一个用于虚拟硬盘。只有在虚拟机处于联机状态时，才能在虚拟 SCSI 控制器中添加或删除硬盘。只有在虚拟机脱机时，才能在虚拟 IDE 控制器中添加或删除磁盘。

以下语法是简化的托管对象格式 (MOF) 代码，它包括所有继承的属性。

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_DiskDrive : CIM_DiskDrive
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   CreationClassName;
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  string   ErrorMethodology = "None";
  string   CompressionMethod = "Not Compressed";
  uint32   NumberOfMediaSupported = 1;
  uint64   MaxMediaSize = 2000000000;
  uint64   DefaultBlockSize = 512;
  uint64   MaxBlockSize;
  uint64   MinBlockSize = 512;
  boolean  NeedsCleaning = False;
  boolean  MediaIsLocked = True;
  uint16   Security = 3;
  datetime LastCleaned;
  uint64   MaxAccessTime = 0;
  uint32   UncompressedDataRate;
  uint64   LoadTime = 0;
  uint64   UnloadTime = 0;
  uint64   MountCount = 0;
  datetime TimeOfLastMount;
  uint64   TotalMountTime = 0;
  string   UnitsDescription;
  uint64   MaxUnitsBeforeCleaning = 0xffffffffffffffff;
  uint64   UnitsUsed = 0;
  uint32   DriveNumber;
};

成员

Msvm_DiskDrive 类具有以下类型的成员：

方法
属性

方法

Msvm_DiskDrive 类具有这些方法。

方法	说明
EnableDevice	不支持此方法。
LockMedia	锁定或释放媒体。
OnlineDevice	不支持此方法。
QuiesceDevice	不支持此方法。
RequestStateChange	请求状态更改。
重置	重置虚拟设备。
RestoreProperties	不支持此方法。
SaveProperties	不支持此方法。
SetPowerState	不支持此方法。

属性

Msvm_DiskDrive 类具有这些属性。

AdditionalAvailability

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

此属性继承自 CIM_LogicalDevice，) 设置为 6 (不适用。

可用性

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

此属性继承自 CIM_LogicalDevice。

AvailableRequestedStates

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

指示 RequestStateChange 方法的 RequestedState 参数的可能值。此属性继承自 CIM_EnabledLogicalElement。

功能

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

媒体访问设备的功能。此属性继承自 CIM_MediaAccessDevice，并设置为以下值。

Value	含义
3	CapabilityDescriptions 中的相应条目是“随机访问”。
4	CapabilityDescriptions 中的相应条目是“支持写入”。

CapabilityDescriptions

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

一个自由格式的字符串数组，提供有关 Capabilities 属性数组中指示的访问设备功能的详细说明。此数组的每个条目都与位于同一索引的 Capabilities 属性数组中的条目相关。此属性继承自 CIM_MediaAccessDevice。

Caption

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

对象的简短说明。此属性继承自 CIM_ManagedElement。

CommunicationStatus

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

指示检测与基础托管元素通信的能力。 Null 值表示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

未知 (0)
不可用 (1)
通信正常 (2)
丢失通信 (3)
无联系人 (4)
DMTF 保留 (.)
供应商预留 (0x8000。)

CompressionMethod

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

一个字符串，指示用于压缩逻辑文件的算法或工具。如果压缩方案未知或未描述，请使用“未知”。如果逻辑文件已压缩，但压缩方案未知或未描述，请使用“Compressed”。如果逻辑文件未压缩，请使用“未压缩”。此属性继承自 CIM_MediaAccessDevice，并设置为“未压缩”。

CreationClassName

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

创建实例时使用的类或子类的名称。此属性继承自 CIM_LogicalDevice。

DefaultBlockSize

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

设备的默认块大小（以字节为单位）。此属性继承自 CIM_MediaAccessDevice，并且设置为 512。

说明

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

对象的说明。此属性继承自 CIM_ManagedElement。

DetailedStatus

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

Compliment the PrimaryStatus property with additional status detail. Null 值表示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

不可用 (0)
无其他信息 (1)
压力 (2)
预测故障 (3)
不可恢复的错误 (4)
错误 (5) 中的支持实体
DMTF 保留 (.)
供应商预留 (0x8000。)

DeviceID

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

用于唯一命名逻辑设备的地址或其他标识信息。此属性继承自 CIM_LogicalDevice。

DriveNumber

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

托管计算机系统上的物理驱动器数。

ElementName

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

对象的显示名称。此属性继承自 CIM_ManagedElement。

EnabledDefault

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

元素的已启用状态的管理员默认或启动配置。此属性继承自 CIM_EnabledLogicalElement。

EnabledState

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

元素的启用和禁用状态。它还可以指示这些请求状态之间的转换。此属性继承自 CIM_EnabledLogicalElement。

值	含义
Unknown 0	无法确定元素的状态。
其他 1
已启用 2	元素正在运行。
已禁用 3	元素已关闭。
关闭 4	元素正在进入“已禁用”状态。
不适用 5	元素不支持启用或禁用。
已启用但脱机 6	元素可能正在完成命令，并且它将删除任何新请求。
测试中 7	元素处于测试状态。
递延 8	元素可能正在完成命令，但它会将任何新请求排队。
Quiesce 9	元素已启用，但它处于受限模式。元素的行为类似于“已启用”状态 (2) ，但它只处理一组受限的命令。所有其他请求已排队。
正在启动 10	元素正在进入 Enabled 状态 (2) 。新请求已排队。

ErrorCleared

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

此属性继承自 CIM_LogicalDevice，但不使用它。

ErrorDescription

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

此属性继承自 CIM_LogicalDevice，但不使用它。

ErrorMethodology

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

描述此设备支持的错误检测和更正类型的字符串。此属性继承自 CIM_MediaAccessDevice，并设置为“None”。

HealthState

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

元素的当前运行状况。此属性表示此元素的运行状况，但不一定表示其子组件的运行状况。可能的值为 0 到 30，其中 5 表示元素完全正常运行，30 表示元素完全无功能。此属性继承自 CIM_ManagedSystemElement，并且始终设置为 5。

IdentifyingDescriptions

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

此属性继承自 CIM_LogicalDevice，并设置为 Null。

InstallDate

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

创建虚拟机配置的日期和时间。此属性继承自 CIM_ManagedSystemElement。

InstanceID

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

唯一标识此类的实例。此属性继承自 CIM_ManagedElement。

LastCleaned

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

上次清理设备的日期和时间。此属性继承自 CIM_MediaAccessDevice，并设置为 Null。

LastErrorCode

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

此属性继承自 CIM_LogicalDevice，但不使用它。

LoadTime

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

从加载到能够读取或写入媒体的时间（以毫秒为单位）。例如，对于磁盘驱动器，这是磁盘未旋转到磁盘报告它已准备好读/写 (即磁盘以名义速度旋转) 之间的间隔。对于磁带驱动器，这是从注入介质到报告它已准备好用于应用程序的时间。这通常位于磁带的 BOT 区域。此属性继承自 CIM_MediaAccessDevice ，并且设置为 0。

MaxAccessTime

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

从媒体上的第一个位置移动到相对于时间最远的位置的时间（以毫秒为单位）。对于磁盘驱动器，这表示完全查找和完全旋转延迟。对于磁带驱动器，这表示从磁带开始到最远物理点的搜索。 (磁带的末尾可能位于其最远的物理点，但这不一定是正确的。) 此属性继承自 CIM_MediaAccessDevice，并且设置为 0。

MaxBlockSize

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

设备访问的媒体的最大块大小（以字节为单位）。此属性继承自 CIM_MediaAccessDevice，对于虚拟硬盘驱动器，此属性设置为 512，对于直通驱动器，该属性设置为变量。

MaxMediaSize

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

此设备支持的媒体的最大大小（以 KB 为单位）。千字节数被解释为字节数乘以 1000 (而不是字节数乘以 1024) 。此属性继承自 CIM_MediaAccessDevice，对于虚拟硬盘驱动器，此属性设置为 2，000，000，000，000，000，对于直通驱动器，变量。

MaxQuiesceTime

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

此属性继承自 CIM_LogicalDevice，但不使用它。

MaxUnitsBeforeCleaning

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

在清理设备之前可以使用的最大单位数。此属性继承自 CIM_MediaAccessDevice，并设置为 0xffffffffffffffff。

MediaIsLocked

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

如果媒体在设备中锁定且无法弹出，则其值为 True;否则为 False。此属性继承自 CIM_MediaAccessDevice，并设置为 True。

MinBlockSize

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

设备访问的媒体的最小块大小（以字节为单位）。此属性继承自 CIM_MediaAccessDevice，并且设置为 512。

MountCount

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

对于支持可移动媒体的设备，为数据传输或清理设备装载媒体的次数。对于访问不可移动媒体（如硬盘）的设备，此属性不适用，应设置为 0。此属性继承自 CIM_MediaAccessDevice，并且设置为 0。

名称

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

对象的已知标签。此属性继承自 CIM_ManagedSystemElement。

NeedsCleaning

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

如果媒体访问设备需要清洁，则为 True;否则为 False。此属性继承自 CIM_MediaAccessDevice，并设置为 False。

NumberOfMediaSupported

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

可支持或插入的多个单个媒体的最大数目。此属性继承自 CIM_MediaAccessDevice，并且设置为 1。

OperatingStatus

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

提供元素操作条件的当前状态信息，并可用于提供有关 EnabledState 属性值的更多详细信息。 Null 值表示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

未知 (0)
不可用 (1)
服务 (2)
从 (3)
停止 (4)
已停止 (5)
已中止 (6)
休眠 (7)
已完成 (8)
迁移 (9)
移民 (10)
移民 (11)
快照 (12)
关闭 (13)
在测试 (14)
转换 (15)
在服务 (16)
DMTF 保留 (.)
供应商预留 (0x8000。)

OperationalStatus

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

对象的当前状态。此属性继承自 CIM_ManagedSystemElement。

OtherEnabledState

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

EnabledState 属性设置为 1 时元素的启用或禁用状态， (其他) 。 如果 EnabledState 为除 1 以外的任何值，则必须将此属性设置为 Null。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 Null。

OtherIdentifyingInfo

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

此属性继承自 CIM_LogicalDevice，并设置为 Null。

PowerManagementCapabilities

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

此属性继承自 CIM_LogicalDevice，但不使用它。

PowerManagementSupported

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

此属性继承自 CIM_LogicalDevice，但不使用它。

PowerOnHours

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

此属性继承自 CIM_LogicalDevice，但不使用它。

PrimaryStatus

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

提供高级状态信息。此属性应与 DetailedStatus 属性结合使用，以提供元素及其子组件的高级和详细的运行状况状态。 Null 值表示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

未知 (0)
正常 (1)
降级 (2)
错误 (3)
DMTF 保留 (.)
供应商预留 (0x8000。)

RequestedState

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

元素的最后一个请求或所需状态。元素的实际状态由 EnabledState 表示。提供此属性用于比较上次请求的状态和当前启用或禁用的状态。 CIM_EnabledLogicalElement 的特定实例可能不支持 RequestStateChange 方法。如果发生这种情况，则使用值 12 (不适用) 。此属性继承自 CIM_EnabledLogicalElement。

安全性

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

为设备定义的操作安全性。此属性继承自 CIM_MediaAccessDevice，) 设置为 3 (None。

Status

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

此属性继承自 CIM_ManagedSystemElement，但不使用它。

StatusDescriptions

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

描述各种 OperationalStatus 数组值的字符串。此属性继承自 CIM_ManagedSystemElement。

StatusInfo

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

此属性继承自 CIM_LogicalDevice，但不使用它。

SystemCreationClassName

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

范围系统的创建类名称。此属性继承自 CIM_LogicalDevice。

SystemName

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

范围虚拟机的唯一标识符。此属性继承自 CIM_LogicalDevice。

TimeOfLastMount

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

对于支持可移动媒体的设备，为媒体在设备上装载的最新日期和时间。对于访问不可移动媒体（如硬盘）的设备，此属性没有任何意义，也不适用。此属性继承自 CIM_MediaAccessDevice，并设置为 Null。

TimeOfLastStateChange

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

元素的启用状态上次更改的日期或时间。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为“NULL”。

TotalMountTime

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

对于支持可移动媒体的设备，) 装载媒体进行数据传输或清理设备的总时间 (秒。对于访问不可移动媒体（如硬盘）的设备，此属性不适用，应设置为 0。此属性继承自 CIM_MediaAccessDevice，并且设置为 0。

TotalPowerOnHours

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

此属性继承自 CIM_LogicalDevice，但不使用它。

TransitioningToState

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

指示实例转换到的目标状态。此属性继承自 CIM_EnabledLogicalElement。

UncompressedDataRate

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

设备可以读取和写入媒体的持续数据传输速率（以 KB/秒为单位）。这是一个持续的原始数据速率。不应在此属性中报告假定压缩的最大速率或速率。此属性继承自 CIM_MediaAccessDevice，并设置为 Null。

UnitsDescription

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

与其在 MaxUnitsBeforeCleaning 中的用法相关的单位。此属性继承自 CIM_MediaAccessDevice，并设置为 Null。

UnitsUsed

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

当前使用的单位数。此属性继承自 CIM_MediaAccessDevice，并且设置为 0。

UnloadTime

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

从能够读取或写入媒体到其卸载的时间（以毫秒为单位）。此属性继承自 CIM_MediaAccessDevice，并且设置为 0。

备注

UAC 筛选可能会限制对 Msvm_DiskDrive 类的访问。有关详细信息，请参阅用户帐户控制和 WMI。

要求

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

另请参阅

CIM_DiskDrive
CIM_DiskDrive
存储类

Msvm_DiskDrive 类

语法

成员

方法

属性

备注

要求

另请参阅

反馈

反馈

其他资源