Msvm_SummaryInformation クラス
仮想マシンまたはスナップショットに関連する一般的な情報をすばやく取得するために、Msvm_VirtualSystemManagementService クラスの GetSummaryInformation メソッドと GetDefinitionFileSummaryInformation メソッドで使用されます。
次の構文は、簡略化されたマネージ オブジェクト形式 (MOF) コードです。
構文
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SummaryInformation : Msvm_SummaryInformationBase
{
string InstanceID;
string AllocatedGPU;
boolean Shielded;
CIM_ConcreteJob AsynchronousTasks[];
DateTime CreationTime;
string ElementName;
uint16 EnabledState;
string OtherEnabledState;
string GuestOperatingSystem;
uint16 HealthState;
uint16 Heartbeat;
uint64 MemoryUsage;
sint32 MemoryAvailable;
sint32 AvailableMemoryBuffer;
boolean SwapFilesInUse;
string Name;
string Notes;
string Version;
uint16 NumberOfProcessors;
uint16 OperationalStatus[];
uint16 ProcessorLoad;
uint16 ProcessorLoadHistory[];
CIM_VirtualSystemSettingData Snapshots[];
string StatusDescriptions[];
uint8 ThumbnailImage[];
uint16 ThumbnailImageHeight;
uint16 ThumbnailImageWidth;
uint64 UpTime;
uint16 ReplicationState;
uint16 ReplicationStateEx[];
uint16 ReplicationHealth;
uint16 ReplicationHealthEx[];
uint16 ReplicationMode;
CIM_ComputerSystem REF TestReplicaSystem;
uint16 ApplicationHealth;
uint16 IntegrationServicesVersionState;
boolean MemorySpansPhysicalNumaNodes;
string ReplicationProviderId[];
uint16 EnhancedSessionModeState;
string VirtualSwitchNames[];
string VirtualSystemSubType;
string HostComputerSystemName;
};
メンバー
Msvm_SummaryInformation クラスには、次の種類のメンバーがあります。
プロパティ
Msvm_SummaryInformation クラスには、これらのプロパティがあります。
-
AllocatedGPU
-
-
データ型: string
-
アクセスの種類: 読み取り専用
この仮想マシンに割り当てられた物理グラフィックス処理装置 (GPU) の識別子。 このプロパティは、RemoteFX を使用する仮想マシンにのみ適用されます。
-
-
ApplicationHealth
-
-
データ型: uint16
-
アクセスの種類: 読み取り専用
仮想マシンの現在のアプリケーションの正常性状態。 このプロパティは、仮想マシンのスナップショットを表すMsvm_SummaryInformationのインスタンスでは無効です。
-
-
OK (2)
-
Application Critical (32782)
-
無効 (32896)
AsyncTasks
-
データ型: 配列CIM_ConcreteJob
-
アクセスの種類: 読み取り専用
-
修飾子: ArrayType ("Indexed")
現在 実行中の仮想 マシンに関連する非同期操作を表す Msvm_ConcreteJob インスタンスの配列。 このプロパティは、仮想マシンのスナップショットを表すMsvm_SummaryInformationのインスタンスでは無効です。
AvailableMemoryBuffer
-
データ型: sint32
-
アクセスの種類: 読み取り専用
仮想マシンで使用可能なメモリ バッファーの割合。 仮想マシンで動的メモリが有効になっている場合、このプロパティは、使用可能なメモリ バッファーと仮想マシンの理想的なメモリ バッファーの比率を表します。 理想的なメモリ バッファー サイズは、Msvm_MemorySettingData クラスの TargetMemoryBuffer プロパティを使用して構成されます。
このプロパティは、動的メモリが有効になっていない仮想マシンを表す Msvm_SummaryInformation クラスのインスタンスでは無効です。
このプロパティは、仮想マシン スナップショットを表すMsvm_SummaryInformation クラスのインスタンスでは無効です。
CreationTime
-
データ型: DateTime
-
アクセスの種類: 読み取り専用
仮想マシンまたはスナップショットが作成された時刻。
ElementName
-
データ型: string
-
アクセスの種類: 読み取り専用
仮想マシンまたはスナップショットの表示名。
EnabledState
-
データ型: uint16
-
アクセスの種類: 読み取り専用
仮想マシンまたはスナップショットの現在の状態。 使用可能な値については、Msvm_ComputerSystem クラスの EnabledState プロパティを参照してください。
EnhancedSessionModeState
-
データ型: uint16
-
アクセスの種類: 読み取り専用
拡張モード接続がホストによって許可されるかどうか、および許可されている場合は仮想マシンで使用できるかどうかを示します。
Windows 8.1: この値は、Windows 8.1して R2 をWindows Server 2012するまでサポートされません。
許可および使用可能 (2)
許可されていません (3)
許可されているが使用できない (6)
GuestOperatingSystem
-
データ型: string
-
アクセスの種類: 読み取り専用
ゲスト オペレーティング システムの名前 (使用可能な場合)。 この情報を使用できない場合、このプロパティの値は Null です。 このプロパティは、仮想マシンのスナップショットを表すMsvm_SummaryInformationのインスタンスでは無効です。
HealthState
-
データ型: uint16
-
アクセスの種類: 読み取り専用
仮想マシンの現在の正常性状態。 このプロパティは、仮想マシンのスナップショットを表すMsvm_SummaryInformationのインスタンスでは無効です。
ハートビート
-
データ型: uint16
-
アクセスの種類: 読み取り専用
仮想マシンの現在のハートビート状態。 詳細については、Msvm_HeartbeatComponent クラスの StatusDescriptions プロパティのドキュメントを参照してください。 このプロパティは、仮想マシンのスナップショットを表すMsvm_SummaryInformationのインスタンスでは無効です。
-
OK (2)
-
エラー (6)
-
連絡先なし (12)
-
失われた通信 (13)
HostComputerSystemName
-
データ型: string
-
アクセスの種類: 読み取り専用
この仮想マシンをホストしているコンピューターの名前。
注意
Windows 10に追加されました。
InstanceID
InstanceID は、インスタンス化する名前空間のスコープ内で、このクラスのインスタンスを不透明かつ一意に識別するために使用できる省略可能なプロパティです。 このクラスのさまざまなサブクラスは、このプロパティをオーバーライドして、必須またはキーにすることができます。 このようなサブクラスは、以下に定義されている一意性を確保するために推奨されるアルゴリズムを変更することもできます。
NameSpace 内の一意性を確保するには、次の "優先" アルゴリズムを使用して InstanceID の値を構築する必要があります。
<OrgID>:<LocalID>
OrgID> と <LocalID> がコロン (:)で区切られ、OrgID には<、InstanceID> を作成または定義しているビジネス エンティティ、または認識されたグローバル機関によってビジネス エンティティに割り当てられた登録済み ID である、著作権、商標、またはその他の一意の名前を含<める必要があります。 (この要件は、 <スキーマ名><クラス名> スキーマ クラス名の構造。さらに、一意性を確保するために、 <OrgID> にコロン (:)を含めてはいけません。 このアルゴリズムを使用する場合は、InstanceID に表示される最初のコロンが OrgID と <LocalID>> の間<に表示される必要があります。
<LocalID> はビジネス エンティティによって選択され、異なる基になる (実際の) 要素を識別するために再利用しないでください。 null でなく、上記の "優先" アルゴリズムが使用されていない場合、定義エンティティは、このインスタンスの NameSpace に対して、このプロバイダーまたは他のプロバイダーによって生成された InstanceID 全体で、結果の InstanceID が再利用されないことを保証する必要があります。
DMTF で定義されたインスタンスに対して null に設定しない場合は、OrgID> を CIM に設定して "優先" アルゴリズムを<使用する必要があります。
注意
Windows 10に追加されました。
IntegrationServicesVersionState
-
データ型: uint16
-
アクセスの種類: 読み取り専用
仮想マシンにインストールされている統合サービスが最新かどうかを示します。
不明 (0)
UpToDate (1)
不一致 (2)
MemoryAvailable
-
データ型: sint32
-
アクセスの種類: 読み取り専用
仮想マシンで使用できる現在のメモリの割合。 仮想マシンで動的メモリが有効になっている場合、このプロパティは、仮想マシンに割り当てられた物理メモリの合計に対する仮想マシンの使用可能なメモリの比率を表します。 仮想マシンに使用可能なメモリがない場合、このプロパティは負の値になり、仮想マシンに割り当てられた物理メモリの合計に対する仮想マシンに必要なメモリの比率が含まれます。
このプロパティは、動的メモリが有効になっていない仮想マシンを表す Msvm_SummaryInformation クラスのインスタンスでは無効です。
このプロパティは、仮想マシン スナップショットを表すMsvm_SummaryInformation クラスのインスタンスでは無効です。
MemorySpansPhysicalNumaNodes
-
データ型: boolean
-
アクセスの種類: 読み取り専用
仮想マシンの 1 つ以上の仮想非フォーム メモリ アクセス (NUMA) ノードのメモリが、ホスティング コンピューター システムの複数の物理 NUMA ノードにまたがるかどうかを示します。 メモリが複数の物理 NUMA ノードにまたがる場合は True 、それ以外の場合 は False を 含みます。
MemoryUsage
-
データ型: uint64
-
アクセスの種類: 読み取り専用
仮想マシンの現在のメモリ使用量 (メガバイト単位)。 このプロパティは、仮想マシンのスナップショットを表すMsvm_SummaryInformationのインスタンスでは無効です。
Name
-
データ型: string
-
アクセスの種類: 読み取り専用
仮想マシンまたはスナップショットの一意の名前。
メモ
-
データ型: string
-
アクセスの種類: 読み取り専用
仮想マシンまたはスナップショットに関連付けられているメモ。
NumberOfProcessors
-
データ型: uint16
-
アクセスの種類: 読み取り専用
仮想マシンまたはスナップショットに割り当てられた仮想プロセッサの合計数。
OperationalStatus
-
データ型: uint16 配列
-
アクセスの種類: 読み取り専用
-
修飾子: ArrayType ("Indexed")
仮想マシンの現在の運用状態。 使用可能な値については、Msvm_ComputerSystem クラスの OperationalStatus プロパティを参照してください。
OtherEnabledState
-
データ型: string
-
アクセスの種類: 読み取り専用
EnabledState プロパティが 1 に設定されている場合の要素の有効または無効の状態を表す文字列。 EnabledState が 1 以外の値の場合、このプロパティは Null に設定されます。
ProcessorLoad
-
データ型: uint16
-
アクセスの種類: 読み取り専用
仮想マシンの現在のプロセッサ使用率 (パーセンテージ)。 このプロパティは、仮想マシンのスナップショットを表すMsvm_SummaryInformationのインスタンスでは無効です。
ProcessorLoadHistory
-
データ型: uint16 配列
-
アクセスの種類: 読み取り専用
-
修飾子: ArrayType ("Indexed")
仮想マシンのプロセッサ使用量の過去 100 サンプルの配列 (パーセンテージ)。 このプロパティは、仮想マシンのスナップショットを表すMsvm_SummaryInformationのインスタンスでは無効です。
ReplicationHealth
-
データ型: uint16
-
アクセスの種類: 読み取り専用
-
修飾子: 非推奨 ("Msvm_SummaryInformation。ReplicationHealthEx")
仮想マシンのレプリケーションの正常性。 使用可能な値については、Msvm_ComputerSystem クラスの ReplicationHealth プロパティを参照してください。
注意
このプロパティは、Windows 8.1以降は非推奨です。代わりに、ReplicationHealthEx を使用してください。
該当なし (0)
Ok (1)
警告 (2)
重大 (3)
ReplicationHealthEx
-
データ型: uint16 配列
-
アクセスの種類: 読み取り専用
-
修飾子: ArrayType ("Indexed")
仮想マシンのさまざまなレプリケーション 関係のレプリケーション正常性値の配列。 使用可能な値については、Msvm_ReplicationRelationship クラスの ReplicationHealth プロパティを参照してください。
該当なし (0)
Ok (1)
警告 (2)
重大 (3)
ReplicationMode
-
データ型: uint16
-
アクセスの種類: 読み取り専用
仮想マシンのレプリケーションの種類。 使用可能な値については、Msvm_ComputerSystem クラスの ReplicationMode プロパティを参照してください。
なし (0)
プライマリ (1)
レプリカ (2)
テスト レプリカ (3)
拡張レプリカ (4)
ReplicationProviderId
-
データ型: 文字列 配列
-
アクセスの種類: 読み取り専用
-
修飾子: ArrayType ("Indexed")
プライマリまたは拡張レプリカの仮想マシンの場合、これはプライマリ レプリケーション プロバイダー ID です。 レプリカ仮想マシンの場合、および拡張レプリケーションが有効になっている場合、これは拡張リレーションシップのプロバイダー ID です。
Windows 8.1: この値は、Windows 8.1して R2 をWindows Server 2012するまでサポートされません。
ReplicationState
-
データ型: uint16
-
アクセスの種類: 読み取り専用
-
修飾子: 非推奨 ("Msvm_SummaryInformation。ReplicationStateEx")
仮想マシンのレプリケーションの状態。 使用可能な値については、Msvm_ComputerSystem クラスの ReplicationState プロパティを参照してください。
注意
このプロパティは、Windows 8.1以降は非推奨です。代わりに、ReplicationStateEx を使用してください。
無効 (0)
レプリケーションの準備完了 (1)
初期レプリケーションの完了を待機 しています (2)
レプリケート ( 3)
同期されたレプリケーションの完了 (4)
回復済み (5)
コミット済み (6)
中断 (7)
Critical (8)
再同期の開始を待機 しています (9)
再同期 (10)
再同期が中断されました (11)
フェールオーバーの進行中 (12)
ReplicationStateEx
-
データ型: uint16 配列
-
アクセスの種類: 読み取り専用
-
修飾子: ArrayType ("Indexed")
仮想マシンのさまざまなレプリケーション関係のレプリケーション状態値の配列。 使用可能な値については、Msvm_ReplicationRelationship クラスの ReplicationState プロパティを参照してください。
無効 (0)
レプリケーションの準備完了 (1)
初期レプリケーションの完了を待機 しています (2)
レプリケート ( 3)
同期されたレプリケーションの完了 (4)
回復済み (5)
コミット済み (6)
中断 (7)
Critical (8)
再同期の開始を待機 しています (9)
再同期 (10)
再同期が中断されました (11)
フェールオーバーの進行中 (12)
進行中のフェールバック (13)
フェールバックの完了 (14)
ディスクの更新が進行中 (15)
注意
Windows 10 バージョン 1703 および Windows Server 2016 で追加されました。
ディスク更新プログラムクリティカル (16)
注意
Windows 10 バージョン 1703 および Windows Server 2016 で追加されました。
不明 (17)
注意
Windows 10 バージョン 1703 および Windows Server 2016 で追加されました。
進行中のレプリケーションの再利用 (18)
注意
Windows 10 バージョン 1703 および Windows Server 2016 で追加されました。
同期レプリケーションの準備 ( 19)
注意
Windows 10 バージョン 1703 および Windows Server 2016 で追加されました。
グループの逆レプリケーションの準備 (20)
注意
Windows 10 バージョン 1703 および Windows Server 2016 で追加されました。
実行中の Firedrill (21)
注意
Windows 10 バージョン 1703 および Windows Server 2016 で追加されました。
[シールド]
-
データ型: boolean
-
アクセスの種類: 読み取り専用
仮想マシンに対してシールドが構成されているかどうかを示します。
注意
Windows 10 バージョン 1703 および Windows Server 2016 で追加されました。
スナップショット
-
データ型: 配列CIM_VirtualSystemSettingData
-
アクセスの種類: 読み取り専用
-
修飾子: ArrayType ("Indexed")
仮想マシンのスナップショットを表す Msvm_VirtualSystemSettingData インスタンスの配列。 このプロパティは、仮想マシンのスナップショットを表すMsvm_SummaryInformationのインスタンスでは無効です。
StatusDescriptions
-
データ型: 文字列 配列
-
アクセスの種類: 読み取り専用
-
修飾子: ArrayType ("Indexed")
対応する OperationalStatus 配列値を記述する文字列。 これは、Msvm_ComputerSystem クラスの StatusDescriptions プロパティに対応します。
SwapFilesInUse
-
データ型: boolean
-
アクセスの種類: 読み取り専用
第 2 レベルのページングがアクティブかどうかを示します。 第 2 レベルのページングがアクティブな場合は True 、それ以外の場合は False を 含みます。
TestReplicaSystem
-
データ型: CIM_ComputerSystem
-
アクセスの種類: 読み取り専用
仮想マシンのテスト レプリカ仮想マシンを表す CIM_ComputerSystem インスタンスへの参照。 このプロパティは、仮想マシンのスナップショットを表すMsvm_SummaryInformationのインスタンスでは無効です。
ThumbnailImage
-
データ型: uint8 配列
-
アクセスの種類: 読み取り専用
-
修飾子: OctetString、 ArrayType ("Indexed")、 ModelCorrespondence ("Msvm_SummaryInformation。ThumbnailImageWidth", "Msvm_SummaryInformation.ThumbnailImageHeight")
仮想マシンまたはスナップショットのデスクトップの小さなサムネイル サイズの画像を RGB565 形式で含む配列。
ThumbnailImageHeight
-
データ型: uint16
-
アクセスの種類: 読み取り専用
-
修飾子: ModelCorrespondence ("Msvm_SummaryInformation。ThumbnailImage")
ThumbnailImage プロパティの画像の高さ (ピクセル単位)。
注意
Windows 10に追加されました。
ThumbnailImageWidth
-
データ型: uint16
-
アクセスの種類: 読み取り専用
-
修飾子: ModelCorrespondence ("Msvm_SummaryInformation。ThumbnailImage")
ThumbnailImage プロパティの画像の幅 (ピクセル単位)。
注意
Windows 10に追加されました。
アップタイム
-
データ型: uint64
-
アクセスの種類: 読み取り専用
仮想マシンが最後に起動されてからの時間。 このプロパティは、仮想マシンのスナップショットを表すMsvm_SummaryInformationのインスタンスでは無効です。
Version
-
データ型: string
-
アクセスの種類: 読み取り専用
"major.minor" の形式の仮想システムのバージョン ("2.0" など)。
注意
Windows 10に追加されました。
VirtualSwitchNames
-
データ型: 文字列 配列
-
アクセスの種類: 読み取り専用
-
修飾子: ArrayType ("Indexed")
仮想マシンが接続されている仮想スイッチのフレンドリ名を指定する文字列。
Windows 8.1: この値は、Windows 8.1して R2 をWindows Server 2012するまでサポートされません。
VirtualSystemSubType
-
データ型: string
-
アクセスの種類: 読み取り専用
仮想システムのサブタイプ。
Windows 8.1: この値は、Windows 8.1して R2 をWindows Server 2012するまでサポートされません。
Microsoft:Hyper-V:SubType:1 ()
Microsoft:Hyper-V:SubType:2 ()
注釈
UAC フィルター処理によって 、Msvm_SummaryInformation クラスへのアクセスが制限される場合があります。 詳細については、「 ユーザー アカウント制御と WMI」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 8 [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2012 [デスクトップ アプリのみ] |
名前空間 |
Root\Virtualization\V2 |
MOF |
|
[DLL] |
|