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)
通信 OK (2)
失われた通信 (3)
連絡先なし (4)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

CreationClassName

データ型: string
アクセスの種類: 読み取り専用

スコープシステムの作成クラス名。このプロパティは、 CIM_LogicalDeviceから継承されます。

説明

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの説明。このプロパティは、 CIM_ManagedElementから継承されます。

DetailedStatus

データ型: uint16
アクセスの種類: 読み取り専用

PrimaryStatus プロパティに追加の状態の詳細を補完します。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは、 CIM_ManagedSystemElementから継承されます。

使用できません (0)
追加情報なし (1)
ストレス ( 2)
予測エラー (3)
回復できないエラー (4)
エラーのサポートエンティティ (5)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

DeviceID

データ型: string
アクセスの種類: 読み取り専用

論理デバイスに一意の名前を付けるアドレスまたはその他の識別情報。このプロパティは 、CIM_LogicalDeviceから継承されます。

ElementName

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの表示名。このプロパティは、 CIM_ManagedElementから継承されます。

EnabledDefault

データ型: uint16
アクセスの種類: 読み取り専用

このプロパティは、 CIM_EnabledLogicalElementから継承されます。

値	説明
7	既定値なし

EnabledState

データ型: uint16
アクセスの種類: 読み取り専用

要素の有効な状態。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

有効 (2)
無効 (3)

ErrorCleared

データ型: boolean
アクセスの種類: 読み取り専用

LastErrorCode プロパティで報告されたエラーがクリアされたかどうかを示します。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

ErrorDescription

データ型: string
アクセスの種類: 読み取り専用

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

データ型: string
アクセスの種類: 読み取り専用
修飾子: キー

このクラスのインスタンスを一意に識別します。このプロパティは、 CIM_ManagedElementから継承されます。

LastErrorCode

データ型: uint32
アクセスの種類: 読み取り専用

論理デバイスによって報告された最後のエラーコード。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

MaxQuiesceTime

データ型: uint64
アクセスの種類: 読み取り専用

このプロパティは非推奨とされました。このプロパティは 、CIM_LogicalDeviceから継承されます。

名前

データ型: string
アクセスの種類: 読み取り専用

オブジェクトが認識されるラベル。このプロパティは 、CIM_ManagedSystemElementから継承されます。

OperatingStatus

データ型: uint16
アクセスの種類: 読み取り専用

要素の操作条件の現在の状態情報を提供し、 EnabledState プロパティの値に関してより詳細な情報を提供するために使用できます。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは 、CIM_ManagedSystemElementから継承されます。

不明 (0)
使用できません (1)
サービス (2)
開始 (3)
停止中 (4)
停止 ( 5)
中止 ( 6)
休止状態 (7)
完了 (8)
移行 ( 9)
Emigrating (10)
未移行 (11)
スナップショット処理 (12)
シャットダウン (13)
In Test (14)
移行中 (15)
In Service (16)
DMTF 予約済み (..)
ベンダー予約 済み (0x8000.. )

OperationalStatus

データ型: uint16 配列
アクセスの種類: 読み取り専用

要素の現在の状態。このプロパティは 、CIM_ManagedSystemElementから継承されます。

OperationalStatus[0] プロパティ値に使用できる値を次に示します。

値	説明
[OK] 2	サービスは正常に動作しています。 OperationalStatus[1] プロパティと StatusDescriptions[1] プロパティの値には、詳細情報が含まれている場合があります。
デグレード 3	サービスは正常に動作していますが、ゲストサービスは互換性のある通信プロトコルバージョンをネゴシエートしました。 OperationalStatus[1] プロパティと StatusDescriptions[1] プロパティの値には、詳細情報が含まれている場合があります。
回復不可能なエラー 7	ゲストは、互換性のあるプロトコルバージョンをサポートしていません。 OperationalStatus[1] プロパティと StatusDescriptions[1] プロパティの値には、詳細情報が含まれている場合があります。
連絡先なし 12	ゲストサービスがインストールされていないか、まだ接続されていません。
失われた通信 13	ゲストサービスが正常に応答しなくなりました。

OtherEnabledState

データ型: string
アクセスの種類: 読み取り専用

EnabledState プロパティが 1 (Other) に設定されている場合の要素の有効または無効の状態を表す文字列。 EnabledState プロパティが 1 以外の値である場合、このプロパティは Null に設定する必要があります。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

OtherIdentifyingInfo

データ型: 文字列 配列
アクセスの種類: 読み取り専用

論理デバイスを識別するために使用できる、デバイス ID 情報以外の追加データ。このプロパティは CIM_LogicalDevice から継承され、常に Null に設定 されます。

PowerManagementCapabilities

データ型: uint16 配列
アクセスの種類: 読み取り専用

デバイスの電源管理機能。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

PowerManagementSupported

データ型: boolean
アクセスの種類: 読み取り専用

デバイスを電源管理できるかどうかを示します。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

PowerOnHours

データ型: uint64
アクセスの種類: 読み取り専用

最後の電源サイクル以降にこのデバイスの電源がオンになっている連続した時間数。このプロパティは CIM_LogicalDevice から継承されますが、使用されません。

PrimaryStatus

データ型: uint16
アクセスの種類: 読み取り専用

高レベルの状態情報を提供します。このプロパティは、要素とそのサブコンポーネントの高レベルで詳細な正常性状態を提供するために 、DetailedStatus プロパティと組み合わせて使用する必要があります。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは 、CIM_ManagedSystemElementから継承されます。

不明 (0)
OK (1)
機能低下 (2)
エラー (3)
DMTF 予約済み (..)
ベンダー予約 済み (0x8000.. )

RequestedState

データ型: uint16
アクセスの種類: 読み取り専用

要素に対して最後に要求された状態または目的の状態。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

値	説明
12	適用しない

状態

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの現在の状態。このプロパティは CIM_ManagedSystemElement から継承されますが、使用されません。

StatusDescriptions

データ型: 文字列 配列
アクセスの種類: 読み取り専用

さまざまな OperationalStatus 配列値を記述する文字列。このプロパティは 、CIM_ManagedSystemElementから継承されます。

StatusInfo

データ型: uint16
アクセスの種類: 読み取り専用

論理デバイスの現在の状態。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

SystemCreationClassName

データ型: string
アクセスの種類: 読み取り専用

スコープシステムの作成クラス名。このプロパティは、 CIM_LogicalDeviceから継承されます。

Systemname

データ型: string
アクセスの種類: 読み取り専用

スコープシステムの名前。この値は、スコープ仮想マシンのMsvm_ComputerSystem クラスの Name プロパティの値に対応します。このプロパティは、 CIM_LogicalDeviceから継承されます。

TimeOfLastStateChange

データ型: datetime
アクセスの種類: 読み取り専用

要素の有効な状態が最後に変更された日時。このプロパティは CIM_EnabledLogicalElementから継承されますが、使用されません。

TotalPowerOnHours

データ型: uint64
アクセスの種類: 読み取り専用

このデバイスの電源が入っている合計時間数。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

TransitioningToState

データ型: uint16
アクセスの種類: 読み取り専用

インスタンスが遷移しているターゲットの状態を示します。このプロパティは CIM_EnabledLogicalElementから継承されますが、使用されません。

注釈

MSVM_KVPEXCHANGECOMPONENT クラスへのアクセスは、UAC フィルター処理によって制限される場合があります。詳細については、「ユーザーアカウント制御と WMI」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
名前空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
[DLL]	Vmms.exe

次の方法で共有

Msvm_KvpExchangeComponent クラス

構文

メンバー

メソッド

プロパティ

注釈

要件

関連項目

フィードバック

その他のリソース