Msvm_PlannedComputerSystem クラス

[アーティクル]
06/12/2023

計画された仮想マシンを表します。

次の構文は、簡略化されたマネージドオブジェクト形式 (MOF) コードであり、継承されたすべてのプロパティが含まれています。

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_PlannedComputerSystem : CIM_ComputerSystem
{
  string   InstanceID;
  string   Caption = "Planned Virtual Machine";
  string   Description = "Microsoft Planned Virtual Machine";
  string   ElementName;
  datetime InstallDate;
  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;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState = 12;
  string   CreationClassName;
  string   Name;
  string   NameFormat;
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   Roles[];
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   Dedicated[];
  string   OtherDedicatedDescriptions[];
  uint16   ResetCapability;
  uint16   PowerManagementCapabilities[];
  uint16   AssignedNumaNodeList[];
  uint64   OnTimeInMilliseconds;
  uint32   ProcessID;
  datetime TimeOfLastConfigurationChange;
};

メンバー

Msvm_PlannedComputerSystem クラスには、次の種類のメンバーがあります。

メソッド
プロパティ

メソッド

Msvm_PlannedComputerSystem クラスには、これらのメソッドがあります。

メソッド	説明
RequestStateChange	計画システムの状態を指定された値に変更するよう要求します。
SetPowerState	このメソッドはサポートされていません。

プロパティ

Msvm_PlannedComputerSystem クラスには、これらのプロパティがあります。

AssignedNumaNodeList

データ型: uint16 配列
アクセスの種類: 読み取り専用
修飾子: ArrayType ("Indexed")

現在仮想マシンに割り当てられている、一様でないメモリアクセス (NUMA) ノードの配列。

AvailableRequestedStates

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

状態変更の開始に使用される RequestStateChange メソッドの RequestedState パラメーターに使用できる値を示します。一覧表示される値は、CIM_EnabledLogicalElementCapabilitiesの関連付けられたインスタンスの RequestedStatesSupported プロパティに含まれる 値のサブセットになります。ここで、選択された値は 、CIM_EnabledLogicalElement オブジェクトの現在の状態の関数です。実装で使用可能な値のセットを現在の状態の関数としてアドバタイズできる場合、このプロパティは Null 以外にすることができます。実装が現在の状態の関数として使用可能な値のセットを特定できない場合、このプロパティは Null になります 。

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

有効 (2)
無効 (3)
シャットダウン (4)
オフライン (6)
テスト (7)
延期 (8)
休止 (9)
再起動 (10)
リセット (11)
DMTF 予約済み (..)

Caption

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

オブジェクトの簡単な説明。このプロパティは CIM_ManagedElementから継承され、常に "計画仮想マシン" に設定されます。

CommunicationStatus

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

基になるマネージド要素と通信するインストルメンテーションの機能を示します。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは、 CIM_ManagedSystemElementから継承されます。

CreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: Key、 MaxLen ( 256 )

インスタンスの作成で使用されるクラスまたはサブクラスの名前を示します。このクラスの他のキープロパティと共に使用する場合、このプロパティを使用すると、このクラスとそのサブクラスのすべてのインスタンスを一意に識別できます。このプロパティは、 CIM_System クラスから継承されます。

専用

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

計画システムが専用の目的 (存在する場合) と提供される機能を示す値の配列。たとえば、システムが "Print" 専用 (値 =11) であるか、"ハブ" (値 = 8) として機能することを指定できます。複数の目的を指定することもできます。たとえば、これは "Not Dedicated" (value=0) を示す汎用システムですが、"Print" (value=11) または "Mobile User Device" (値 =17) サービスもホストします。

このプロパティは、 CIM_ComputerSystem クラスから継承されます。

値	説明
専用ではありません 0
Unknown 1
その他 2
Storage 3
ルーター 4
スイッチ 5
レイヤ 3 スイッチ 6
セントラルオフィススイッチ 7
ハブ 8
Access Server 9
ファイアウォール 10
印刷 11
I/O 12
Web キャッシュ 13
管理 14	このインスタンスがホスティングシステム管理ソフトウェア専用であることを示します。
サーバーのブロック 15
ファイルサーバー 16
モバイルユーザーデバイス 17	専用のモバイルユーザーデバイスの例として、無線周波数を介して通信するストア内の携帯電話またはバーコードスキャナーがあります。これらのシステムは、機能とプログラミングが非常に制限されており、汎用コンピューティングプラットフォームとは見なされません。または、汎用 (つまり、専用ではない) モバイルシステムの例は、手持ちコンピューターです。プログラミングは限られていますが、新しいソフトウェアをダウンロードし、その機能をユーザーが拡張することができます。
リピータ 18
ブリッジ/エクステンダー 19
ゲートウェイ 20
Storage Virtualizer 21
メディアライブラリ 22
ExtenderNode 23
NAS ヘッド 24
自己完結型 NAS 25
UPS 26
IP Phone 27
管理コントローラー 28	このインスタンスは、システム管理専用の特殊なハードウェア (つまり、Baseboard Management Controller (BMC) またはサービスプロセッサ) を表します。管理コントローラーの管理スコープは、通常、それが含まれている 1 つのマネージドシステムです。
シャーシマネージャー 29	このインスタンスは、ブレードシャーシとその包含デバイスの管理専用のシステムを表します。この値は、シェルフコントローラーを表すために使用されます。シャーシマネージャは管理のための集約ポイントであり、構成要素の管理のために下位管理コントローラに依存する場合があります。
ホストベースの RAID コントローラー 30	このインスタンスは、ホストコンピューター内に含まれる RAID ストレージコントローラーを表します。
記憶装置エンクロージャ 31	このインスタンスが、ストレージデバイスを含むエンクロージャを表していることを示します。
デスクトップ 32
ラップトップ 33
仮想テープライブラリ 34	仮想ライブラリシステムによるテープライブラリのエミュレーション。
仮想ライブラリシステム 35	ディスクストレージを使用してテープライブラリをエミュレートします。
ネットワーク PC/シンクライアント 36
FC スイッチ 37	このインスタンスが、レイヤー 2 ファイバーチャネルフレームの切り替え専用であることを示します。
イーサネットスイッチ 38	このインスタンスがレイヤー 2 イーサネットフレームの切り替え専用であることを示します。
DMTF 予約済み 39..32567
ベンダー予約済み 32568..65535

説明

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

オブジェクトの説明。このプロパティは CIM_ManagedElementから継承され、常に "Microsoft 計画仮想マシン" に設定されます。

DetailedStatus

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

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

ElementName

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

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

EnabledDefault

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

要素の有効な状態に対する管理者の既定またはスタートアップ構成。このプロパティは CIM_EnabledLogicalElementから継承され、次のいずれかの値を指定できます。

値	説明
Disabled 3	システムがオフになっています。
有効だがオフライン 6	システムは有効ですが、オフラインです。新しい要求はすべて削除されます。

EnabledState

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

計画システムの有効な状態を指定します。このプロパティは CIM_EnabledLogicalElementから継承され、次のいずれかの値を指定できます。

値	説明
Disabled 3	システムがオフになっています。
有効だがオフライン 6	システムは有効ですが、オフラインです。新しい要求はすべて削除されます。

HealthState

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

要素の現在の正常性。このプロパティは、この要素の正常性を表しますが、必ずしもサブコンポーネントの正常性を表すわけではありません。指定できる値は 0 から 30 です。5 は要素が完全に正常であることを意味し、30 は要素が完全に非機能であることを意味します。このプロパティは CIM_ManagedSystemElementから継承され、常に 5 (OK) に設定されます。

値	説明
5	正常性状態は正常です。

IdentifyingDescriptions

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

OtherIdentifyingInfo 配列内のエントリの背後にある説明と詳細を提供する文字列の配列。この配列の各エントリは、同じインデックスにある OtherIdentifyingInfo のエントリに関連しています。このプロパティは、 CIM_System クラスから継承されます。

InstallDate

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

仮想マシンの構成が作成された日時。このプロパティは 、CIM_ManagedSystemElementから継承されます。

InstanceID

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

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

名前

データ型: string
アクセスの種類: 読み取り専用
修飾子: Key、 Override、 MaxLen ( 256 )

継承された名前は、エンタープライズ環境のシステムインスタンスのキーとして機能します。このプロパティは、 CIM_System クラスから継承されます。

NameFormat

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

サブクラスのヒューリスティックを使用して、システム名がどのように生成されたかを識別します。システムオブジェクトとその派生オブジェクトは、CIM の最上位オブジェクトです。これらは、多数のコンポーネントのスコープを提供します。一意のシステムキーが必要です。ヒューリスティックは、常に同じシステム名キーを生成しようとする個々のシステムサブクラスで定義できます。このプロパティは、 CIM_System クラスから継承されます。

OnTimeInMilliseconds

データ型: uint64
アクセスの種類: 読み取り専用
修飾子: Units ("MilliSeconds")

仮想マシンが最後に有効、リセット、または復元されてからの合計時間 (ミリ秒単位)。今回は、仮想マシンが一時停止状態だった時間を除外します。

OperatingStatus

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

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

OperationalStatus

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

オブジェクトの現在の状態。このプロパティは CIM_ManagedSystemElementから継承され、各配列要素は常に 2 (OK) に設定されます。

OtherDedicatedDescriptions

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

Dedicated 配列に値 2 "Other" が含まれている場合にシステムが専用になる方法または理由を説明する文字列。このプロパティは、 CIM_ComputerSystem クラスから継承されます。

OtherEnabledState

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

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

OtherIdentifyingInfo

データ型: 文字列 配列
アクセスの種類: 読み取り専用
修飾子: Key、 MaxLen ( 256 )

ComputerSystem を識別するために使用できる、システム名情報以外の追加データが含まれます。 1 つの例として、ノードのファイバーチャネルワールドワイド名 (WWN) を保持します。ファイバーチャネル名のみを使用でき、一意である (システムキーとして使用できる) 場合、このプロパティは Null になり、WWN はシステムキーになり、そのデータは Name プロパティに格納されます。このプロパティは、 CIM_System クラスから継承されます。

PowerManagementCapabilities

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

このプロパティは 、CIM_ComputerSystem クラスから継承されますが、サポートされていません。

PrimaryOwnerContact

データ型: string
アクセスの種類: 読み取り/書き込み
修飾子: MaxLen ( 256 )

プライマリシステム所有者に到達する方法 (電話番号、電子メールアドレスなど) に関する情報を提供する文字列。このプロパティは、 CIM_System クラスから継承されます。

PrimaryOwnerName

データ型: string
アクセスの種類: 読み取り/書き込み
修飾子: MaxLen ( 64 )

プライマリシステム所有者の名前。システム所有者は、システムのプライマリユーザーです。このプロパティは、 CIM_System クラスから継承されます。

PrimaryStatus

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

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

ProcessID

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

この仮想マシンが実行されているプロセスの識別子。この値を使用すると、仮想マシンを実行しているシステム上のVmwp.exeのインスタンスを一意に識別できます。

RequestedState

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

要素に対して最後に要求された状態または目的の状態。要素の実際の状態は EnabledState で表されます。このプロパティは、要素の最後に要求された状態と現在の状態を比較するために提供されます。 CIM_EnabledLogicalElement クラスの特定のインスタンスが RequestedState プロパティをサポートしていない場合があります。この場合、値 12 ("適用なし") が使用されます。このプロパティは CIM_EnabledLogicalElementから継承され、常に 12 (適用できません) に設定されます。

値	説明
12	適用不可。

ResetCapability

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

コンピューターシステムのリセット機能を指定します。このプロパティは、 CIM_ComputerSystem クラスから継承されます。

値	説明
その他 1
Unknown 2
Disabled 3	ハードウェアのリセットは許可されていません。
有効 4	コンピューターシステムは、ハードウェア (電源ボタンやリセットボタンなど) を使用してリセットできます。
実装されていません 5

ロール

データ型: 文字列 配列
アクセスの種類: 読み取り/書き込み

このシステムが管理対象環境で果たす管理者定義ロールを指定する文字列の配列。たとえば、"Building 8 print server" や "Boise user directory" などです。 1 つのシステムで複数のロールを実行できます。システムの役割のインストルメンテーションビューは、システムの特定のサブクラスをインスタンス化するか、サブクラスのプロパティ、またはその両方によって定義されます。たとえば、ComputerSystem の目的は、 Dedicated プロパティと OtherDedicatedDescription プロパティを使用して定義されます。このプロパティは、 CIM_System クラスから継承されます。

状態

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

このプロパティは CIM_ManagedSystemElementから継承されますが、使用されません。

StatusDescriptions

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

さまざまな OperationalStatus 配列値を記述する文字列。このプロパティは CIM_ManagedSystemElementから継承され、各配列要素は常に "サービスが正常に実行されています" に設定されます。

TimeOfLastConfigurationChange

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

仮想マシン構成ファイルが最後に変更された日時。構成ファイルは、特定の仮想マシンの操作中、および仮想マシンまたはデバイスの設定のいずれかが追加、変更、または削除されるときに変更されます。

TimeOfLastStateChange

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

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

TransitioningToState

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

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

値	説明
Unknown 0
有効 2
Disabled 3
シャットダウン 4
変更なし 5	移行は進行中です。
オフライン 6
テスト 7
延期 8
休止 9
Reboot 10
リセット 11
該当なし 12	実装では、進行中の遷移の表現はサポートされていません。
DMTF 予約済み ..

要件

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

こちらもご覧ください

CIM_ComputerSystem
をMsvm_VirtualSystemManagementServiceします。ImportSystemDefinition メソッド