Msvm_VirtualSystemManagementService类

表示单个主机系统上存在的虚拟化服务。 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 将启动源添加到虚拟系统配置(应用于“state”虚拟系统配置时)。
AddFeatureSettings 将以太网功能设置添加到虚拟机以太网连接的配置。
AddFibreChannelChap 将 DH-CHAP 参数添加到虚拟机中的合成光纤通道端口。
AddGuestServiceSettings 将来宾服务设置添加到虚拟系统配置。
应用于“当前”虚拟系统配置的各个部分时,可能会修改活动虚拟系统的副作用来宾服务。
AddKvpItems 将键值对添加到虚拟机。
AddResourceSettings 将资源添加到虚拟机配置。
AddSystemComponentSettings 将通用设置添加到虚拟系统配置。
DefinePlannedSystem 定义计划的虚拟系统。
未完全指定的输入可能用默认值填充。
DefineSystem 创建新的虚拟机定义。
DestroySystem 删除现有虚拟机定义。
DiagnoseNetworkConnection 诊断Windows网络虚拟化环境中 VM 的网络连接。
ExportSystemDefinition 将虚拟机或虚拟机的快照导出到文件。
FormatError 为嵌入 Msvm_Error 实例的指定数组返回格式化的错误消息字符串。
GenerateWwpn (WWPN) 生成一组万维端口名称。
GetCurrentWwpnFromGenerator 提供预览当前万维网名称 (WWPN) 而不保留 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

数据类型: 字符串

访问类型:只读

限定符: KeyMaxLen ( 256 )

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

说明

数据类型: 字符串

访问类型:只读

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

DetailedStatus

数据类型: uint16

访问类型:只读

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

不可用 (0)

无其他信息 (1)

压力 (2)

预测故障 (3)

不可恢复的错误 (4)

错误 (5) 支持实体

DMTF 保留 (。。)

供应商保留 (0x8000。。)

ElementName

数据类型: 字符串

访问类型:只读

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

EnabledDefault

数据类型: uint16

访问类型:只读

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

含义
2
已启用

EnabledState

数据类型: uint16

访问类型:只读

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

含义
2
已启用

HealthState

数据类型: uint16

访问类型:只读

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

含义
5
运行状况正常。

InstallDate

数据类型: datetime

访问类型:只读

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

InstanceID

数据类型: 字符串

访问类型:只读

限定符: 密钥

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

名称

数据类型: 字符串

访问类型:只读

限定符: KeyMaxLen ( 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)

在服务 (16)

DMTF 保留 (。。)

供应商保留 (0x8000。。)

OperationalStatus

数据类型: uint16 数组

访问类型:只读

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

OtherEnabledState

数据类型: 字符串

访问类型:只读

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

PrimaryOwnerContact

数据类型: 字符串

访问类型:只读

限定符: MaxLen ( 256 )

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

PrimaryOwnerName

数据类型: 字符串

访问类型:只读

限定符: MaxLen ( 64 )

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

PrimaryStatus

数据类型: uint16

访问类型:只读

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

未知 (0)

正常 (1)

降级 (2)

错误 3 (3)

DMTF 保留 (。。)

供应商保留 (0x8000。。)

RequestedState

数据类型: uint16

访问类型:只读

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

含义
12
不适用。

已开始

数据类型: 布尔值

访问类型:只读

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

StartMode

数据类型: 字符串

访问类型:只读

限定符: MaxLen ( 10 )

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

Status

数据类型: 字符串

访问类型:只读

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

StatusDescriptions

数据类型: 字符串 数组

访问类型:只读

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

SystemCreationClassName

数据类型: 字符串

访问类型:只读

限定符: KeyMaxLen ( 256 )

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

SystemName

数据类型: 字符串

访问类型:只读

限定符: KeyMaxLen ( 256 )

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

TimeOfLastStateChange

数据类型: datetime

访问类型:只读

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

TransitioningToState

数据类型: uint16

访问类型:只读

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

备注

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

要求

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

另请参阅

CIM_VirtualSystemManagementService

CIM_VirtualSystemManagementService

Msvm_VirtualSystemManagementService (V1)

虚拟系统管理类