Msvm_PlannedComputerSystem 类

项目
06/12/2023

表示计划的虚拟机。

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

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_PlannedComputerSystem : CIM_ComputerSystem
{
  string   InstanceID;
  string   Caption = "Planned Virtual Machine";
  string   Description = "Microsoft Planned Virtual Machine";
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "The service is running normally" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState = 12;
  string   CreationClassName;
  string   Name;
  string   NameFormat;
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   Roles[];
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   Dedicated[];
  string   OtherDedicatedDescriptions[];
  uint16   ResetCapability;
  uint16   PowerManagementCapabilities[];
  uint16   AssignedNumaNodeList[];
  uint64   OnTimeInMilliseconds;
  uint32   ProcessID;
  datetime TimeOfLastConfigurationChange;
};

成员

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

方法
属性

方法

Msvm_PlannedComputerSystem 类具有这些方法。

方法	说明
RequestStateChange	请求将计划系统的状态更改为指定的值。
SetPowerState	不支持此方法。

属性

Msvm_PlannedComputerSystem 类具有这些属性。

AssignedNumaNodeList

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

当前分配给虚拟机的节点 (NUMA) 节点的非统一内存访问数组。

AvailableRequestedStates

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

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

此属性继承自 CIM_EnabledLogicalElement。

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

Caption

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

对象的简短说明。此属性继承自 CIM_ManagedElement，并且始终设置为“计划虚拟机”。

CommunicationStatus

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

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

CreationClassName

数据类型： string
访问类型：只读
限定符：键、 MaxLen ( 256 )

指示在创建实例时使用的类或子类的名称。与此类的其他关键属性一起使用时，此属性允许唯一标识此类及其子类的所有实例。此属性继承自 CIM_System 类。

专用

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

一个值数组，这些值指示计划系统专用的目的（如果有）以及提供的功能。例如，可以指定系统专用于“打印” (value=11) 或充当“Hub” (value=8) 。还可以指示多种用途。例如，这是一个常规用途系统，指示“非专用” (value=0) 但它也承载“打印” (value=11) 或“移动设备设备” (value=17) 服务。

此属性继承自 CIM_ComputerSystem 类。

值	含义
非专用 0
Unknown 1
其他 2
存储 3
路由器 4
Switch 5
第 3 层交换机 6
中央办公室交换机 7
中心 8
访问服务器 9
防火墙 10
打印 11
I/O 12
Web 缓存 13
Management 14	指示此实例专用于托管系统管理软件。
阻止服务器 15
文件服务器 16
移动设备 17	专用移动用户设备的一个示例是通过无线电频率进行通信的手机或商店中的条形码扫描仪。这些系统在功能和可编程性方面相当有限，不被视为通用计算平台。或者，移动系统的一个示例是常规用途 (即，不是专用) 是手持计算机。尽管其可编程性有限，但用户可以下载新软件并扩展其功能。
中继器 18
Bridge/Extender 19
网关 20
存储虚拟化程序 21
媒体库 22
ExtenderNode 23
NAS 头 24
独立 NAS 25
UPS 26
IP 电话 27
管理控制器 28	指示此实例表示专用于系统管理 (即基板管理控制器 (BMC) 或服务处理器) 。管理控制器的管理范围通常是包含它的单个托管系统。
底盘管理器 29	指示此实例表示专用于管理刀片式机箱及其包含设备的系统。此值将用于表示货架控制器。底盘管理器是用于管理的聚合点，可能依赖于从属管理控制器来管理构成部件。
基于主机的 RAID 控制器 30	指示此实例表示包含在主计算机中的 RAID 存储控制器。
存储设备机箱 31	指示此实例表示包含存储设备的机箱。
桌面 32
笔记本电脑 33
虚拟磁带库 34	虚拟库系统的磁带库仿真。
虚拟库系统 35	使用磁盘存储来模拟磁带库。
网络电脑/瘦客户端 36
FC 交换机 37	指示此实例专用于切换第 2 层光纤通道帧。
以太网交换机 38	指示此实例专用于交换第 2 层以太网帧。
DMTF 保留 39..32567
供应商预留 32568..65535

描述

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

对象的说明。此属性继承自 CIM_ManagedElement，并且始终设置为“Microsoft 计划虚拟机”。

DetailedStatus

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

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

ElementName

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

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

EnabledDefault

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

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

值	含义
已禁用 3	系统已关闭。
已启用但脱机 6	系统已启用，但处于脱机状态。将删除任何新请求。

EnabledState

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

指定计划系统的启用状态。此属性继承自 CIM_EnabledLogicalElement，可以是以下值之一。

值	含义
已禁用 3	系统已关闭。
已启用但脱机 6	系统已启用，但处于脱机状态。将删除任何新请求。

HealthState

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

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

值	含义
5	运行状况正常。

IdentifyingDescriptions

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

一个字符串数组，提供 OtherIdentifyingInfo 数组中条目背后的说明和详细信息。此数组的每个条目都与位于同一索引处 的 OtherIdentifyingInfo 中的条目相关。此属性继承自 CIM_System 类。

InstallDate

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

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

InstanceID

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

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

名称

数据类型： string
访问类型：只读
限定符： Key、 Override、 MaxLen ( 256 )

继承的名称用作企业环境中系统实例的键。此属性继承自 CIM_System 类。

NameFormat

数据类型： string
访问类型：只读
限定符： MaxLen ( 64 )

使用子类的启发法标识系统名称的生成方式。系统对象及其派生是 CIM 的顶级对象。它们为许多组件提供了范围。必须具有唯一的系统密钥。可以在单个系统子类中定义启发式方法，以尝试始终生成相同的系统名称键。此属性继承自 CIM_System 类。

OnTimeInMilliseconds

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

自上次打开、重置或还原虚拟机以来的总时间（以毫秒为单位）。此时间不包括虚拟机处于暂停状态的时间。

OperatingStatus

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

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

OperationalStatus

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

对象的当前状态。此属性继承自 CIM_ManagedSystemElement，每个数组元素始终设置为 2 (正常) 。

OtherDedicatedDescriptions

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

一个字符串，描述在 Dedicated 数组包含值 2“Other”时系统如何或为何专用。此属性继承自 CIM_ComputerSystem 类。

OtherEnabledState

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

一个字符串，描述 EnabledState 属性设置为 1 时元素的启用或禁用状态 (“Other”) 。当 EnabledState 为除 1 以外的任何值时，此属性必须设置为 Null。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 Null。

OtherIdentifyingInfo

数据类型： 字符串 数组
访问类型：只读
限定符：键、 MaxLen ( 256 )

包含除系统名称信息之外可用于标识 ComputerSystem 的其他数据。一个示例是保留节点的光纤通道全球名称 (WWN) 。如果只有光纤通道名称可用且唯一 (可用作系统键) ，则此属性将为 Null ，WWN 将成为系统键，其数据放置在 Name 属性中。此属性继承自 CIM_System 类。

PowerManagementCapabilities

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

此属性继承自 CIM_ComputerSystem 类，但不受支持。

PrimaryOwnerContact

数据类型： string
访问类型：读/写
限定符： MaxLen ( 256 )

一个字符串，提供有关如何联系主系统所有者的信息， (例如电话号码、电子邮件地址等) 。此属性继承自 CIM_System 类。

PrimaryOwnerName

数据类型： 字符串
访问类型：读/写
限定符： MaxLen ( 64 )

主系统所有者的名称。系统所有者是系统的主要用户。此属性继承自 CIM_System 类。

PrimaryStatus

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

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

ProcessID

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

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

RequestedState

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

元素的最后一个请求或所需状态。元素的实际状态由 EnabledState 表示。提供此属性是为了比较元素的上次请求状态和当前状态。 CIM_EnabledLogicalElement 类的特定实例可能不支持 RequestedState 属性。如果发生这种情况，则使用值 12 (“不适用”) 。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 12 (不适用) 。

值	含义
12	不适用。

ResetCapability

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

指定计算机系统的重置功能。此属性继承自 CIM_ComputerSystem 类。

值	含义
其他 1
Unknown 2
已禁用 3	不允许硬件重置。
已启用 4	可以使用硬件 (重置计算机系统，例如，电源和重置按钮) 。
未实现 5

角色

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

字符串数组，指定此系统在托管环境中所扮演的管理员定义角色。示例可能是“生成 8 打印服务器”或“Boise 用户目录”。单个系统可以执行多个角色。系统角色的检测视图是通过实例化系统的特定子类或按子类中的属性（或两者）定义的。例如，ComputerSystem 的用途是使用 Dedicated 和 OtherDedicatedDescription 属性定义的。此属性继承自 CIM_System 类。

Status

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

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

StatusDescriptions

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

描述各种 OperationalStatus 数组值的字符串。此属性继承自 CIM_ManagedSystemElement，并且每个数组元素始终设置为“服务正常运行”。

TimeOfLastConfigurationChange

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

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

TimeOfLastStateChange

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

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

TransitioningToState

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

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

值	含义
Unknown 0
已启用 2
已禁用 3
关闭 4
无更改 5	没有转换正在进行中。
Offline 6
测试 7
延迟 8
Quiesce 9
重新启动 10
重置 11
不适用 12	实现不支持表示正在进行的转换。
DMTF 保留 ..

要求

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

另请参阅

CIM_ComputerSystem
Msvm_VirtualSystemManagementService 。ImportSystemDefinition 方法

通过

Msvm_PlannedComputerSystem 类

语法

成员

方法

属性

要求

另请参阅

反馈

其他资源