Msvm_ComputerSystem 类

项目
06/13/2023

表示物理计算机系统或虚拟机。

若要检索 VMMS 的信息，请使用 Msvm_VirtualSystemManagementService 类。

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

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ComputerSystem : CIM_ComputerSystem
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  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 = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   CreationClassName;
  string   Name = "GUID";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   Roles[];
  string   NameFormat;
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   Dedicated[];
  string   OtherDedicatedDescriptions[];
  uint16   ResetCapability = 1;
  uint16   PowerManagementCapabilities[];
  uint64   OnTimeInMilliseconds;
  uint32   ProcessID;
  datetime TimeOfLastConfigurationChange;
  uint16   NumberOfNumaNodes;
  uint16   ReplicationState;
  uint16   ReplicationHealth;
  uint16   ReplicationMode;
  uint16   FailedOverReplicationType;
  uint16   LastReplicationType;
  DateTime LastApplicationConsistentReplicationTime;
  DateTime LastReplicationTime;
  DateTime LastSuccessfulBackupTime;
  uint16   EnhancedSessionModeState;
};

成员

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

方法
属性

方法

Msvm_ComputerSystem 类具有这些方法。

方法	说明
InjectNonMaskableInterrupt	将不可屏蔽的中断注入虚拟机。仅表示虚拟机的 Msvm_ComputerSystem 类的实例支持此方法。 Windows 8.1：在Windows 8.1和Windows Server 2012 R2 之前，不支持此方法。
RequestReplicationStateChange	请求将虚拟机的复制状态更改为指定值。仅表示虚拟机的 Msvm_ComputerSystem 类的实例支持此方法。
RequestReplicationStateChangeEx	请求将虚拟机的复制状态更改为指定值。仅表示虚拟机的 Msvm_ComputerSystem 类的实例支持此方法。 Windows 8.1：在Windows 8.1和Windows Server 2012 R2 之前，不支持此方法。
RequestStateChange	请求更改虚拟机的状态。仅表示虚拟机的 Msvm_ComputerSystem 类的实例支持此方法。
SetPowerState	不支持此方法。

属性

Msvm_ComputerSystem 类具有这些属性。

AvailableRequestedStates

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

指示用于启动状态更改的 RequestStateChange 方法的 RequestedState 参数的可能值。列出的值将是CIM_EnabledLogicalElementCapabilities关联实例的 RequestedStatesSupported 属性中包含的值的子集，其中所选值是CIM_EnabledLogicalElement 对象的当前状态的函数。如果实现能够播发可能的值集作为当前状态的函数，则此属性可能为非 Null 。如果实现无法确定作为当前状态函数的可能值集，则此属性将为 Null 。

此属性继承自 CIM_EnabledLogicalElement。

已启用 (2)
禁用 (3)
关闭 (4)
脱机 (6)
测试 (7)
延迟 (8)
静止 (9)
重新启动 (10)
重置 (11)
DMTF 保留 (.)

Caption

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

对象的简短说明。此属性继承自 CIM_ManagedElement 类，它将包含以下值之一。

值	含义
“虚拟机”	实例表示虚拟机。
“托管计算机系统”	实例表示宿主计算机。

CommunicationStatus

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

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

CreationClassName

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

用于创建实例的类或子类的名称。此属性继承自 CIM_System，并且始终设置为“Msvm_ComputerSystem”。

专用

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

指示计算机系统是专用系统 (专用于特定用途) ，还是常规用途系统。此属性继承自 CIM_ComputerSystem，并且始终设置为 0 (Not Dedicated) 。

说明

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

对象的说明。此属性继承自 CIM_ManagedElement，它将包含以下值之一。

值	含义
“Microsoft 虚拟计算机系统”	实例表示虚拟机。
“Microsoft 托管计算机系统”	实例表示宿主计算机。

DetailedStatus

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

使用其他状态详细信息补充 PrimaryStatus 属性。 Null 值表示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

ElementName

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

对象的显示名称。此属性继承自 CIM_ManagedElement，并且始终设置为虚拟机的计算机的显示名称或管理操作系统的 NetBIOS 名称。

EnabledDefault

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

元素的启用状态的管理员默认或启动配置。此属性继承自 CIM_EnabledLogicalElement ，将是以下值之一。

已启用 (2)
已禁用 (3)
已启用但脱机 (6)

EnabledState

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

元素的启用和禁用状态。此属性还可以指示这些请求状态之间的转换。此属性继承自 CIM_EnabledLogicalElement 类，对于物理计算机，此属性设置为 2 (Enabled) 或虚拟机的以下值之一。有关这些状态的图形视图，请参阅“备注”。

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

EnhancedSessionModeState

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

指定虚拟机上增强会话模式的当前状态。

每次 Msvm_ComputerSystem 类的 EnhancedSessionModeState 发生更改时，Hyper-V WMI 提供程序都会引发 __InstanceModificationEvent 。如果活动 vmconnection 会话收到 __InstanceModificationEvent，则如果用户启用了该设置，它将尝试切换到增强会话模式。

Windows 8.1：在Windows 8.1和Windows Server 2012 R2 之前，不支持此值。

EnhancedSessionModeState 可以是以下值之一：

允许和可用 (2)

允许在虚拟机上使用增强模式。

不允许 (3)

虚拟机上不允许使用增强模式。

允许但不可用 (6)

增强模式是允许的，但当前在虚拟机上不可用。

FailedOverReplicationType

数据类型： uint16
访问类型：只读
限定符： 已弃用 (“Msvm_ReplicationRelationship。FailedOverReplicationType“)

故障转移操作期间应用的恢复数据点的类型。

注意

从 Windows 8.1 开始，此属性已弃用;而是使用 Msvm_ReplicationRelationship 类中同名的属性来获取主关系或扩展关系的值。

可能的值为：

无 (0)

常规 (1)

应用程序一致性 (2)

计划 (3)

HealthState

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

指定元素的当前运行状况。此属性表示此元素的运行状况，但不一定表示其子组件运行状况。

发生严重错误时，检查事件日志了解详细信息。 EnabledState 属性还可以包含详细信息。例如，当磁盘空间严重不足时， HealthState 设置为 25，虚拟机暂停， EnabledState 设置为 32768 (暂停) 。

此属性继承自 CIM_ManagedSystemElement。

值	含义
确定 5	虚拟机功能齐全，在正常操作参数中运行，且没有错误。
主要故障 20	虚拟机发生重大故障。如果包含虚拟机 VHD 的一个或多个磁盘磁盘空间不足，并且虚拟机已暂停，则使用此值。
严重故障 25	元素不可正常工作，可能无法恢复。这表示虚拟机 (Vmwp.exe) 的工作进程未响应控制或信息请求，或者包含虚拟机 VHD 的一个或多个磁盘磁盘空间不足。

IdentifyingDescriptions

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

此属性继承自 CIM_ComputerSystem，并且始终设置为 Null。

InstallDate

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

为虚拟机创建虚拟机配置的日期和时间，或者为管理操作系统创建 Null。此属性继承自 CIM_ManagedSystemElement。

InstanceID

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

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

在 Windows 8 中，每个计算机系统或虚拟机都有一个 ReplicationSettingData 实例。对于Windows 8.1，恢复虚拟机具有两个 ReplicationSettingData 实例。此更改区分设置数据并将其与复制关系相关联。

属性名称	Windows 8值	Windows 8.1值
InstanceID	Microsoft：<vmguid>\HVR	Microsoft：<vmguid>\HVR\<0/1>

在 Windows 8.1 值中，0 表示主副本，1 表示扩展复制。有关扩展复制的详细信息，请参阅 Msvm_ReplicationRelationship。

LastApplicationConsistentReplicationTime

数据类型： DateTime
访问类型：只读
限定符： 已弃用 (“Msvm_ReplicationRelationship。LastApplicationConsistentReplicationTime“)

收到虚拟机上次应用程序一致性复制的时间。

注意

从 Windows 8.1 开始，此属性已弃用;而是使用 Msvm_ReplicationRelationship 类中同名的属性来获取主要关系或扩展关系的值。

LastReplicationTime

数据类型： DateTime
访问类型：只读
限定符： 已弃用 (“Msvm_ReplicationRelationship。LastReplicationTime“)

虚拟机恢复时收到上次复制的时间。

注意

从 Windows 8.1 开始，此属性已弃用;而是使用 Msvm_ReplicationRelationship 类中同名的属性来获取主要关系或扩展关系的值。

LastReplicationType

数据类型： uint16
访问类型：只读
限定符： 已弃用 (“Msvm_ReplicationRelationship。LastReplicationType“)

为虚拟机接收的最后一个复制的类型。

注意

从 Windows 8.1 开始，此属性已弃用;而是使用 Msvm_ReplicationRelationship 类中同名的属性来获取主要关系或扩展关系的值。

可能的值为：

无 (0)

常规 (1)

应用程序一致性 (2)

计划 (3)

LastSuccessfulBackupTime

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

虚拟机上次成功备份完成的时间。

名称

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

对象的已知标签。此属性继承自 CIM_System，并且始终设置为“GUID”。

NameFormat

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

一个字符串，它使用子类启发法标识系统名称的生成方式。此属性继承自 CIM_ComputerSystem，并且始终设置为 Null。

NumberOfNumaNodes

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

(NUMA) 计算机系统的节点访问的非一元内存访问数。当 Msvm_ComputerSystem 表示宿主计算机系统时，此属性包含物理 NUMA 节点的计数。当 Msvm_ComputerSystem 表示虚拟机时，此属性包含通过 ACPI 系统资源相关性表 (SRAT) 提供给来宾操作系统的虚拟 NUMA 节点数。

OnTimeInMilliseconds

数据类型： uint64
访问类型：只读
限定符：单位 (“MilliSeconds”)

对于虚拟机，此属性指示自上次打开、重置或还原计算机以来的时间（以毫秒为单位）。此时间不包括虚拟机处于暂停状态的时间。对于管理操作系统，此属性设置为 Null。

OperatingStatus

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

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

OperationalStatus

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

包含对象的当前状态的数组。此属性继承自 CIM_ManagedSystemElement。索引 0 (0) 的值是以下值之一。

值	含义
确定 2	虚拟机正常运行并正常运行。
已降级 3	虚拟机仅部分正常运行。这表示不可访问包含配置的存储。处于此状态的虚拟机只能关闭或删除。
预计故障 5	虚拟机正常运行，但将来可能会发生故障。这表示包含虚拟机虚拟硬盘的存储的可用空间不足。如果未提供更多磁盘空间，虚拟机将暂停。
已停止 10	不支持此值。如果虚拟机已停止， EnabledState 属性的值将为 3 (Disabled) 。
服务中 11	虚拟机正在处理请求。
Dormant 15	不支持此值。如果虚拟机已暂停或暂停， EnabledState 属性的值将为 32769 (Suspended) 或 32768 (Paused) 。

索引 1 (1) 的值是可选的，包含辅助状态信息。客户端应使用索引 0 (0) 的主要状态来确定是否可以向虚拟机发出新请求。如果 OperationalStatus[0] 为 2 (正常) ，则 OperationalStatus[1] 指示的操作可能会中断。

OperationalStatus[1] 处的值是以下值之一。

值	含义
创建快照 32768	正在为虚拟机创建快照。
应用快照 32769	快照正在应用于虚拟机。
删除快照 32770	正在从虚拟机中删除快照。
正在等待启动 32771	虚拟机将在自动启动延迟过后启动。
合并磁盘 32772	正在合并以前删除的快照中的虚拟硬盘。
导出虚拟机 32773	正在导出虚拟机。
迁移虚拟机 32774	虚拟机正在从一台物理计算机实时迁移到另一台物理计算机。

OtherDedicatedDescriptions

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

一个字符串，描述当专用数组包含值 2 (Other) 时系统如何或为什么专用。此属性继承自 CIM_ComputerSystem，并且始终设置为 Null。

OtherEnabledState

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

EnabledState 属性设置为 1 时虚拟机的启用或禁用状态， (其他) 。当 EnabledState 为除 1 以外的任何值时，此属性必须设置为 Null。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 Null。

OtherIdentifyingInfo

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

此属性继承自 CIM_ComputerSystem，并且始终设置为 Null。

PowerManagementCapabilities

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

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

PrimaryOwnerContact

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

一个字符串，指示如何联系主系统所有者 (例如电话号码或电子邮件地址) 。此属性继承自 CIM_System，并且始终设置为 Null。

PrimaryOwnerName

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

主系统所有者的名称。此属性继承自 CIM_System，并且始终设置为 Null。

PrimaryStatus

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

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

ProcessID

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

运行此虚拟机的进程标识符。此值可用于唯一标识运行虚拟机的系统上的 Vmwp.exe 实例。

ReplicationHealth

数据类型： uint16
访问类型：只读
限定符： 已弃用 (“Msvm_ReplicationRelationship。ReplicationHealth“)

虚拟机的复制运行状况。

注意

从 Windows 8.1 开始，此属性已弃用;而是使用 Msvm_ReplicationRelationship 类中同名的属性来获取主关系或扩展关系的值。

可能的值为：

不适用 (0)

确定 (1)

警告 (2)

关键 (3)

ReplicationMode

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

指定虚拟机的复制模式。这是以下值之一。

无 (0)

主 (1)

副本 (2)

恢复

测试副本 (3)

副本

扩展副本 (4)

ReplicationState

数据类型： uint16
访问类型：只读
限定符： 已弃用 (“Msvm_ReplicationRelationship。ReplicationState“)

虚拟机的复制状态。

注意

从 Windows 8.1 开始，此属性已弃用;而是使用 Msvm_ReplicationRelationship 类中同名的属性来获取主要关系或扩展关系的值。

可能的值为：

禁用 (0)

准备复制 (1)

等待完成初始复制 (2)

复制 (3)

同步复制完成 (4)

恢复 (5)

提交 (6)

暂停 (7)

关键 (8)

正在等待重新同步 (9)

重新同步 (10)

重新同步挂起 (11)

正在进行故障转移 (12)

进行故障回复 (13)

故障回复完成 (14)

RequestedState

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

传递到 RequestStateChange 方法的虚拟机的最后一个请求或所需状态;如果没有状态更改，则为 12 (不适用) 。元素的实际状态由 EnabledState 表示。提供此属性用于比较上次请求的状态和当前启用或禁用的状态。此属性继承自 CIM_EnabledLogicalElement。

ResetCapability

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

此属性继承自 CIM_ComputerSystem，并且始终设置为 1 (其他) 。

角色

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

描述系统在信息技术环境中所扮演的角色的字符串数组。此属性继承自 CIM_System，并且始终设置为 Null。

Status

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

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

StatusDescriptions

数据类型： 字符串 数组
访问类型：只读
限定符： ArrayType (“Indexed”)

一个数组，其中包含描述相应 OperationalStatus 数组值的字符串。例如，如果 11 (In Service) 是分配给 OperationalStatus[0] 的值，则 StatusDescriptions[0] 可能包含虚拟机处理请求的原因的说明。此属性继承自 CIM_ManagedSystemElement。

TimeOfLastConfigurationChange

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

上次修改虚拟机配置文件的日期和时间。在某些虚拟机操作期间以及添加、修改或删除任何虚拟机或设备设置时，都会修改配置文件。

TimeOfLastStateChange

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

元素的启用状态上次更改的日期和时间。此属性继承自 CIM_EnabledLogicalElement。

TransitioningToState

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

指示实例转换到的目标状态。此属性继承自 CIM_EnabledLogicalElement，但不使用它。

备注

下图显示了 EnabledState 值。

windows Server 2008 r2 的 enabledstate 值的状态图

当 Msvm_ComputerSystem 类的属性更改时，WMI 提供程序指示描述更改 的__InstanceModificationEvent 事件。以前的状态包含在 PreviousInstance 属性中，新状态包含在 TargetInstance 属性中。此事件是异步的;处理 __InstanceModificationEvent 事件时， TargetInstance 属性可能不会反映当前状态。

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

示例

请参阅查询网络对象。

要求

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

另请参阅

CIM_ComputerSystem
__InstanceModificationEvent
CIM_ComputerSystem
Msvm_ComputerSystem (V1)
虚拟系统类

Msvm_ComputerSystem 类

语法

成员

方法

属性

备注

示例

要求

另请参阅

反馈

反馈

其他资源