SWbemServices オブジェクト

SWbemServices オブジェクトのメソッドを使用して、ローカル ホストまたはリモート ホスト上の名前空間に対して操作を実行できます。 このオブジェクトは、VBScript CreateObject 呼び出しでは作成できません。

メンバー

SWbemDateTime オブジェクトには、次の種類のメンバーがあります。

• メソッド
• プロパティ

メソッド

SWbemDateTime オブジェクトには、次のメソッドがあります。

プロパティ

SWbemDateTime オブジェクトには、次のプロパティがあります。

解説

メソッドは、同期モード、非同期モード、または半同期モードのいずれかで呼び出すことができます。 詳細については、「メソッドの呼び出し」を参照してください。

概要

SWbemServices は、2 つの主要な役割を果たします。 最初に、SWbemServices オブジェクトは、ターゲット コンピューター上の WMI 名前空間への認証された接続を表します。 次に、SWbemServices は、WMI 管理対象リソースの取得に使用する Automation オブジェクトです。 SWbemServices オブジェクトへの参照は、次の 2 つの方法のいずれかで取得できます。

• これまでに示したほとんどの WMI スクリプトで示されているように、VBScript GetObject 関数を WMI モニカー "winmgmts:" と組み合わせて使用できます。 次の例は、WMI 接続の最も簡単な形式です。 この例では、ローカル コンピューターの既定の名前空間 (通常は "Root\CIMv2") に接続します。

  Set objSWbemServices = GetObject("winmgmts:")

• SWbemLocator オブジェクト ConnectServer メソッドを使用して、SWbemServices オブジェクトへの参照を取得することもできます。

SWbemServices オブジェクトへの参照を取得した後、オブジェクト参照を使用し、SWbemServices を使用して利用できる 18 個のメソッドのうち 1 つを呼び出します。 SWbemServices は、呼び出すメソッドに応じて、3 つの異なる WMI スクリプト ライブラリ オブジェクト (SWbemObjectSet、SWbemObject、または SWbemEventSource) のいずれかを返すことができます。 各メソッドが返すオブジェクトの種類を把握しておくと、スクリプトで実行する必要がある次の手順を決定するのに役立ちます。 たとえば、SWbemObjectSet を取得した場合、コレクション内の各 SWbemObject にアクセスするには、コレクションを列挙する必要があります。 SWbemObject を取得した場合は、最初にコレクションを列挙することなく、オブジェクトのメソッドとプロパティにすぐにアクセスできます。

動作モード

SWbemServices では、同期、非同期、半同期の 3 つの操作モードがサポートされています。

• Synchronous。 同期モードでは、スクリプトは SWbemServices メソッドが完了するまでブロック (一時停止) されます。 スクリプトが待機するだけでなく、WMI が管理対象リソースのインスタンスを取得する場合は、データの最初のバイトが呼び出し元のスクリプトに返される前に、WMI がメモリ内に SWbemObjectSet 全体をビルドします。 これは、スクリプトのパフォーマンスと、スクリプトを実行しているコンピューターに悪影響を及ぼす可能性があります。 たとえば、Windows イベント ログから何千ものイベントを同期的に取得すると、時間がかかり、大量のメモリが使用される可能性があります。 これらの理由から、同期操作は、既定で同期される 3 つのメソッド (Delete、ExecMethod、Get) を除いて推奨されません。 これらのメソッドでは大きなデータ セットが返されないため、半同期操作は必要ありません。

• [非同期] 。 非同期モードでは、スクリプトは 9 つの非同期メソッドのいずれかを呼び出し、すぐに戻ります。 つまり、非同期メソッドが呼び出されるとすぐに、スクリプトは次のコード行の実行を再開します。 非同期メソッドを使用するには、スクリプトで最初に SWbemSink オブジェクトと、イベント ハンドラーと呼ばれる特別なサブルーチンを作成する必要があります。 WMI は非同期操作を実行し、操作の完了時にイベント ハンドラー サブルーチンを呼び出してスクリプトに通知します。

• 半同期。 半同期モードは、同期と非同期の折衷案です。 半同期操作は同期操作よりもパフォーマンスが優れていますが、非同期操作を処理するために必要な追加の知識とスクリプト作成手順は必要ありません。 これは、ほとんどの WMI クエリの既定の操作の種類です。

  半同期モードでは、スクリプトは 6 つのデータ取得メソッドのいずれかを呼び出し、すぐに戻ります。 スクリプトが実行を続けると、WMI はバックグラウンドで管理対象リソースを取得します。 リソースが取得されると、SWbemObjectSet 経由ですぐにスクリプトに戻ります。 コレクション全体がアセンブルされるのを待たずに、管理対象リソースへのアクセスを開始できます。

  CIM_DataFile や Win32_NTLogEvent など、多数のインスタンス (1,000 を超える多くの意味) を持つ管理対象リソースを操作する場合は、半同期操作に注意が必要です。 注意点は、WMI が管理対象リソースのインスタンスを処理する方法の結果です。 管理対象リソースの各インスタンスについて、WMI は SWbemObject オブジェクトを作成してキャッシュします。 管理対象リソースに多数のインスタンスが存在する場合、インスタンスの取得によって使用可能なリソースが独占され、スクリプトとコンピューターの両方のパフォーマンスが低下するおそれがあります。

  この問題を回避するために、wbemFlagForwardOnly フラグを使用して、半同期メソッド呼び出しを最適化できます。 wbemFlagForwardOnly フラグを wbemFlagReturnImmediately フラグ (既定の半同期フラグ) と組み合わせることで、WMI に転送専用の SWbemObjectSet を返すように指示します。これにより、大きなデータ セットのパフォーマンスの問題が解消されます。 ただし、wbemFlagForwardOnly フラグの使用にはコストを伴います。 転送専用の SWbemObjectSet は、1 回だけ列挙できます。 転送専用の SWbemObjectSet 内の各 SWbemObject にアクセスすると、インスタンスに割り当てられたメモリが解放されます。

Delete、ExecMethod、Get、および 9 つの非同期メソッドを除き、半同期が既定の推奨される操作モードです。

一般的に使用されるメソッド

システム管理スクリプトで最もよく使用されるメソッドは、InstancesOf、ExecQuery、Get、ExecNotificationQuery です。 InstancesOf はよく使用されますが、必ずしも情報を取得するための推奨される方法ではありません (ただし、間違いなく最も簡単な方法です)。

要件

関連項目

スクリプト API オブジェクト

メソッドの呼び出し