Msvm_KvpExchangeComponent 类

项目
06/13/2023

表示键/值对交换服务的状态，该服务提供一种在虚拟机与管理操作系统上运行的操作系统之间交换数据的机制。

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

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_KvpExchangeComponent : CIM_LogicalDevice
{
  string   InstanceID;
  string   Caption = "Key-Value Pair Exchange";
  string   Description = "Microsoft Key-Value Pair Exchange Service";
  string   ElementName = "Key-Value pair Exchange";
  datetime InstallDate;
  string   Name = "Key-Value Pair Exchange";
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 7;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_KvpExchangeComponent";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability = 6;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  string   GuestExchangeItems[];
  string   GuestIntrinsicExchangeItems[];
};

成员

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

方法
属性

方法

Msvm_KvpExchangeComponent 类具有这些方法。

方法	说明
EnableDevice	不支持此方法。
OnlineDevice	不支持此方法。
QuiesceDevice	不支持此方法。
RequestStateChange	请求状态更改。
重置	重置组件。
RestoreProperties	不支持此方法。
SaveProperties	不支持此方法。
SetPowerState	不支持此方法。

属性

Msvm_KvpExchangeComponent 类具有这些属性。

AdditionalAvailability

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

设备的任何其他可用性和状态。此属性继承自 CIM_LogicalDevice。

值	含义
{ 6 }
6	不适用

可用性

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

设备的主要可用性和状态。此属性继承自 CIM_LogicalDevice。

值	含义
6	不适用

AvailableRequestedStates

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

指示 RequestStateChange 方法的 RequestedState 参数的可能值。此属性继承自 CIM_EnabledLogicalElement，但不使用它。

Caption

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

对象的简短说明。此属性继承自 CIM_ManagedElement。

CommunicationStatus

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

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

未知 (0)
不可用 (1)
通信正常 (2)
丢失通信 (3)
No Contact (4)
DMTF 保留 (。)
供应商预留 (0x8000。)

CreationClassName

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

范围系统的创建类名称。此属性继承自 CIM_LogicalDevice。

说明

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

对象的说明。此属性继承自 CIM_ManagedElement。

DetailedStatus

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

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

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

DeviceID

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

用于唯一命名逻辑设备的地址或其他标识信息。此属性继承自 CIM_LogicalDevice。

ElementName

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

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

EnabledDefault

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

此属性继承自 CIM_EnabledLogicalElement。

值	含义
7	无默认值

EnabledState

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

元素的启用状态。此属性继承自 CIM_EnabledLogicalElement。

已启用 (2)
禁用 (3)

ErrorCleared

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

指示 LastErrorCode 属性中报告的错误现在是否已清除。此属性继承自 CIM_LogicalDevice，但不使用它。

ErrorDescription

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

一个字符串，提供有关 LastErrorCode 属性中记录的错误的详细信息，以及有关可能采取的任何纠正措施的信息。此属性继承自 CIM_LogicalDevice，但不使用它。

GuestExchangeItems

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

嵌入 的Msvm_KvpExchangeDataItem 实例数组，其中包含在来宾操作系统中运行的服务已向上推送的键值对集，可供外部客户端访问。此数组将不包含由集成服务直接推送的任何内部项。

GuestIntrinsicExchangeItems

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

嵌入 的Msvm_KvpExchangeDataItem 实例数组，其中包含来宾操作系统已向上推送的键值对集，可供外部客户端访问。此数组将不包含来宾操作系统中运行的其他服务推送的任何数据项。

HealthState

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

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

IdentifyingDescriptions

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

一个自由格式字符串数组，在 OtherIdentifyingInfo 属性数组中的条目后面提供解释和详细信息。此属性继承自 CIM_LogicalDevice，但不使用它。

InstallDate

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

将集成服务安装到虚拟机中的日期和时间。此属性继承自 CIM_ManagedSystemElement。

InstanceID

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

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

LastErrorCode

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

逻辑设备报告的最后一个错误代码。此属性继承自 CIM_LogicalDevice，但不使用它。

MaxQuiesceTime

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

此属性已弃用。此属性继承自 CIM_LogicalDevice。

名称

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

对象的已知标签。此属性继承自 CIM_ManagedSystemElement。

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。

以下是 OperationalStatus[0] 属性值的可能值。

值	含义
确定 2	该服务正常运行。 OperationalStatus[1] 和 StatusDescriptions[1] 属性值可能包含详细信息。
已降级 3	该服务正常运行，但来宾服务协商了兼容的通信协议版本。 OperationalStatus[1] 和 StatusDescriptions[1] 属性值可能包含详细信息。
不可恢复错误 7	来宾不支持兼容的协议版本。 OperationalStatus[1] 和 StatusDescriptions[1] 属性值可能包含详细信息。
无联系人 12	来宾服务未安装或尚未联系。
通信中断 13	来宾服务不再正常响应。

OtherEnabledState

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

一个字符串，描述 EnabledState 属性设置为 1 时元素的启用或禁用状态 (其他) 。如果 EnabledState 属性是除 1 以外的任何值，则必须将此属性设置为 Null。此属性继承自 CIM_EnabledLogicalElement。

OtherIdentifyingInfo

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

除设备 ID 信息外，可用于标识逻辑设备的任何其他数据。此属性继承自 CIM_LogicalDevice ，始终设置为 Null。

PowerManagementCapabilities

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

设备的电源管理功能。此属性继承自 CIM_LogicalDevice，但不使用它。

PowerManagementSupported

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

指示设备是否可以进行电源管理。此属性继承自 CIM_LogicalDevice，但不使用它。

PowerOnHours

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

此设备自上次电源周期以来已开机的连续小时数。此属性继承自 CIM_LogicalDevice 但不使用。

PrimaryStatus

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

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

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

RequestedState

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

元素的最后一个请求或所需状态。此属性继承自 CIM_EnabledLogicalElement。

值	含义
12	不适用

Status

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

对象的当前状态。此属性继承自 CIM_ManagedSystemElement 但不使用。

StatusDescriptions

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

描述各种 OperationalStatus 数组值的字符串。此属性继承自 CIM_ManagedSystemElement。

StatusInfo

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

逻辑设备的当前状态。此属性继承自 CIM_LogicalDevice，但不使用它。

SystemCreationClassName

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

范围系统的创建类名称。此属性继承自 CIM_LogicalDevice。

SystemName

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

范围系统的名称。此值对应于范围虚拟机的 Msvm_ComputerSystem 类的 Name 属性值。此属性继承自 CIM_LogicalDevice。

TimeOfLastStateChange

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

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

TotalPowerOnHours

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

此设备通电的总小时数。此属性继承自 CIM_LogicalDevice，但不使用它。

TransitioningToState

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

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

备注

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

要求

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

另请参阅

CIM_LogicalDevice
CIM_LogicalDevice

通过

Msvm_KvpExchangeComponent 类

语法

成员

方法

属性

备注

要求

另请参阅

反馈

其他资源