Msvm_VirtualSystemManagementService 类

项目
06/13/2023

表示单个主机系统上存在的虚拟化服务。 Msvm_VirtualSystemManagementService 用于控制虚拟机的定义、修改和删除。它还具有在虚拟机上执行操作的方法，例如克隆、快照以及导入或导出虚拟机。若要检索每个虚拟机的信息，请使用 Msvm_ComputerSystem。

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

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualSystemManagementService : CIM_VirtualSystemManagementService
{
  string   InstanceID;
  string   Caption = "Virtual System Management Service";
  string   Description = "Service for creating, manipulating, and managing virtual machines";
  string   ElementName = "Hyper-V Virtual System Management Service";
  datetime InstallDate;
  string   Name = "vmms";
  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 = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_VirtualSystemManagementService";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   StartMode;
  boolean  Started = True;
};

成员

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

方法
属性

方法

Msvm_VirtualSystemManagementService 类具有这些方法。

方法	说明
AddBootSourceSettings	在应用于“状态”虚拟系统配置时，将启动源添加到虚拟系统配置。
AddFeatureSettings	将以太网功能设置添加到虚拟机以太网连接的配置中。
AddFibreChannelChap	将 DH-CHAP 参数添加到虚拟机中的合成光纤通道端口。
AddGuestServiceSettings	将来宾服务设置添加到虚拟系统配置。应用于“当前”虚拟系统配置的某些部分时，可能会修改活动虚拟系统的来宾服务。
AddKvpItems	将键值对添加到虚拟机。
AddResourceSettings	将资源添加到虚拟机配置。
AddSystemComponentSettings	将常规设置添加到虚拟系统配置。
DefinePlannedSystem	定义计划的虚拟系统。未完全指定的输入可能使用默认值进行填充。
DefineSystem	创建新的虚拟机定义。
DestroySystem	删除现有的虚拟机定义。
DiagnoseNetworkConnection	诊断 Windows 网络虚拟化环境中 VM 的网络连接。
ExportSystemDefinition	将虚拟机或虚拟机快照导出到文件。
FormatError	返回嵌入 Msvm_Error 实例的指定数组的格式化错误消息字符串。
GenerateWwpn	(WWPN) 生成一组世界范围的端口名称。
GetCurrentWwpnFromGenerator	提供在不保留 WWPN 的情况下预览当前 World Wide Port Name (WWPN) 的功能。
GetDefinitionFileSummaryInformation	返回指定虚拟机定义文件的虚拟机摘要信息。
GetSizeOfSystemFiles	检索虚拟机的系统文件的总大小。
GetSummaryInformation	返回虚拟机摘要信息。
GetVirtualSystemThumbnailImage	检索现有虚拟机的缩略图。
ImportSnapshotDefinitions	在指定文件夹中搜索与指定计划的计算机系统关联的任何快照定义文件，并为此位置中的每个关联定义文件在计划的计算机系统上创建新的快照。
ImportSystemDefinition	基于指定的虚拟机定义创建新的计划内计算机系统。
ModifyDiskMergeSettings	修改磁盘合并设置数据。
ModifyFeatureSettings	修改虚拟机以太网连接的当前功能设置。
ModifyGuestServiceSettings	修改来宾服务设置。应用于“当前”虚拟系统配置的某些部分时，可能会修改活动虚拟系统的来宾服务。
ModifyKvpItems	修改虚拟机上的现有键值对。
ModifyResourceSettings	修改虚拟资源设置。
ModifyServiceSettings	修改服务的设置数据。
ModifySystemComponentSettings	修改通用系统组件设置。
ModifySystemSettings	修改虚拟机设置。
RealizePlannedSystem	验证计划虚拟机的配置，并将其转换为已实现的虚拟机。
RemoveBootSourceSettings	从虚拟系统配置中删除虚拟资源设置。应用于“当前”虚拟系统配置的某些部分时，可能会删除活动虚拟系统的副作用资源。
RemoveFeatureSettings	从虚拟机以太网连接中删除功能设置。
RemoveFibreChannelChap	从虚拟机中的合成光纤通道端口中删除 DH-CHAP 参数。
RemoveGuestServiceSettings	从虚拟系统配置中删除来宾服务设置。应用于“当前”虚拟系统配置的某些部分时，可能会修改活动虚拟系统的来宾服务。
RemoveKvpItems	从虚拟机中删除现有的键值对。
RemoveResourceSettings	从虚拟机配置中删除虚拟资源设置。
RemoveSystemComponentSettings	从虚拟系统配置中删除通用组件设置。
RequestStateChange	不支持此方法。
SetGuestNetworkAdapterConfiguration	在来宾操作系统中配置网络适配器。
SetInitialMachineConfigurationData	设置 VM 的初始计算机配置数据。
StartService	不支持此方法。
StopService	不支持此方法。
TestNetworkConnection	在 Windows 网络虚拟化环境中测试 VM 的网络连接。
UpgradeSystemVersion	升级虚拟系统。应用于“当前”虚拟系统配置的系统设置时
ValidatePlannedSystem	验证指定的计划系统。

属性

Msvm_VirtualSystemManagementService 类具有以下属性。

AvailableRequestedStates

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

指示 RequestStateChange 方法的 RequestedState 参数的可能值。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 Null。

Caption

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

对象的简短说明。此属性继承自 CIM_ManagedElement，并且始终设置为“Hyper-V 虚拟系统管理服务”。

CommunicationStatus

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

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

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

CreationClassName

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

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

说明

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

对象的说明。此属性继承自 CIM_ManagedElement，并且始终设置为“用于创建、操作和管理虚拟机的服务”。

DetailedStatus

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

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

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

ElementName

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

对象的显示名称。此属性继承自 CIM_ManagedElement，并且始终设置为“Hyper-V 虚拟系统管理服务”。

EnabledDefault

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

元素的已启用状态的管理员默认或启动配置。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 2 (Enabled) 。

值	含义
2	Enabled

EnabledState

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

元素的启用和禁用状态。此属性还可以指示这些请求状态之间的转换。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 2 (Enabled) 。

值	含义
2	Enabled

HealthState

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

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

值	含义
5	运行状况正常。

InstallDate

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

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

InstanceID

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

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

名称

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

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

OperatingStatus

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

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

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

OperationalStatus

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

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

OtherEnabledState

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

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

PrimaryOwnerContact

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

有关如何联系服务的主要所有者的任何信息 (例如电话号码、电子邮件地址等) 。此属性继承自 CIM_Service，并且始终设置为 Null。

PrimaryOwnerName

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

服务的主要所有者的名称（如果已定义）。主要所有者是该服务的初始支持联系人。此属性继承自 CIM_Service，并且始终设置为 Null。

PrimaryStatus

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

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

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

RequestedState

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

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

值	含义
12	不适用。

已开始

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

指示服务当前是否正在运行。此属性继承自 CIM_Service，并且始终设置为 True。

StartMode

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

一个字符串值，该值指示服务是由系统、操作系统自动启动还是仅在请求时启动。此属性继承自 CIM_Service，并且始终设置为 Null。

Status

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

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

StatusDescriptions

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

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

SystemCreationClassName

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

范围系统的创建类名称。此属性继承自 CIM_Service，并且始终设置为“Msvm_ComputerSystem”。

SystemName

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

托管计算机系统的 NetBIOS 名称。此属性继承自 CIM_Service。

TimeOfLastStateChange

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

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

TransitioningToState

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

指示实例转换到的目标状态。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 Null。

备注

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

要求

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

另请参阅

CIM_VirtualSystemManagementService
CIM_VirtualSystemManagementService
Msvm_VirtualSystemManagementService (V1)
虚拟系统管理类

通过

Msvm_VirtualSystemManagementService 类

语法

成员

方法

属性

备注

要求

另请参阅

反馈

其他资源