Msvm_ComputerSystem 类

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

若要检索 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 (为物理计算机启用) 或虚拟机的以下值之一。 有关这些状态的图形视图,请参阅“备注”。

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

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

备注

此属性从 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_ReplicationRelationshipLastApplicationConsistentReplicationTime“)

为虚拟机接收最后一个应用程序一致性复制的时间。

注意

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

LastReplicationTime

数据类型: DateTime

访问类型:只读

限定符: 已弃用 (“Msvm_ReplicationRelationshipLastReplicationTime“)

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

注意

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

LastReplicationType

数据类型: uint16

访问类型:只读

限定符: 已弃用 (“Msvm_ReplicationRelationshipLastReplicationType“)

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

注意

此属性从 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 系统资源相关性表向来宾操作系统显示的虚拟 NUMA 节点数, (SRAT) 。

OnTimeInMilliseconds

数据类型: uint64

访问类型:只读

限定符: 单位 (“MilliSeconds”)

对于虚拟机,此属性指示上次打开、重置或还原计算机的时间(以毫秒为单位)。 这一次排除虚拟机处于暂停状态的时间。 对于管理操作系统,此属性设置为 Null

OperatingStatus

数据类型: uint16

访问类型:只读

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

OperationalStatus

数据类型: uint16 数组

访问类型:只读

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

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

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

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

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

OtherDedicatedDescriptions

数据类型: 字符串 数组

访问类型:只读

描述 专用 数组包含值 2 (Other) 时系统专用的字符串。 此属性继承自 CIM_ComputerSystem,并且始终设置为 Null

OtherEnabledState

数据类型: 字符串

访问类型:只读

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

OtherIdentifyingInfo

数据类型: 字符串 数组

访问类型:只读

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

PowerManagementCapabilities

数据类型: uint16 数组

访问类型:只读

此属性继承自 CIM_ComputerSystem,但不使用该属性。

PrimaryOwnerContact

数据类型: 字符串

访问类型:只读

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

PrimaryOwnerName

数据类型: 字符串

访问类型:只读

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

PrimaryStatus

数据类型: uint16

访问类型:只读

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

ProcessID

数据类型: uint32

访问类型:只读

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

ReplicationHealth

数据类型: uint16

访问类型:只读

限定符: 已弃用 (“Msvm_ReplicationRelationshipReplicationHealth“)

虚拟机的复制运行状况。

备注

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

可能的值为:

不适用 (0)

正常 (1)

警告 (2)

关键 (3)

ReplicationMode

数据类型: uint16

访问类型:只读

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

(0)

(1)

副本 (2)

恢复

测试副本 (3)

副本

扩展副本 (4)

ReplicationState

数据类型: uint16

访问类型:只读

限定符: 已弃用 (“Msvm_ReplicationRelationshipReplicationState“)

虚拟机的复制状态。

注意

此属性从 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 个 (是分配给 OperationalStatus[0] 的值,则 StatusDescriptions[0] 可能包含有关虚拟机处理请求的原因的说明。 此属性继承自 CIM_ManagedSystemElement

TimeOfLastConfigurationChange

数据类型: datetime

访问类型:只读

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

TimeOfLastStateChange

数据类型: datetime

访问类型:只读

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

TransitioningToState

数据类型: uint16

访问类型:只读

指示实例正在转换的目标状态。 此属性继承自 CIM_EnabledLogicalElement,但不使用该属性。

注解

下图显示了 EnabledState 值。

state diagram for enabledstate values for windows server 2008 r2

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

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

示例

请参阅 查询网络对象

要求

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

另请参阅

CIM_ComputerSystem

__InstanceModificationEvent

CIM_ComputerSystem

Msvm_ComputerSystem (V1)

虚拟系统类