WMI プロバイダー

[アーティクル]
05/10/2023

WMIProvider サンプルでは、Windows Communication Foundation (WCF) に組み込まれている Windows Management Instrumentation (WMI) プロバイダーを使用して実行時に WCF サービスのデータを収集する方法を示します。また、このサンプルでは、ユーザー定義の WMI オブジェクトをサービスに追加する方法も示します。このサンプルでは、「入門サンプル」用に WMI プロバイダーをアクティブにし、実行時に ICalculator サービスのデータを収集する方法を示します。

WMI は、Web ベースのエンタープライズ管理 (WBEM) 標準をマイクロソフトが実装したものです。 WMI SDK の詳細については、「Windows Management Instrumentation」を参照してください。 WBEM は、アプリケーションが Management Instrumentation を外部管理ツールに開示する業界標準の方法です。

WCF には WMI プロバイダーが実装されています。これは、WBEM と互換性のあるインターフェイスを通して実行時にインストルメンテーションを公開するコンポーネントです。管理ツールは、実行時にインターフェイスを介してサービスに接続できます。 WCF では、アドレス、バインディング、動作、リスナーなどのサービスの属性を公開します。

組み込みの WMI プロバイダーは、アプリケーションの構成ファイルでアクティブにされます。次のサンプル構成に示すように、これは <system.serviceModel> セクションにある <diagnostics> の wmiProviderEnabled 属性を介して実行されます。

<system.serviceModel>
    ...
    <diagnostics wmiProviderEnabled="true" />
    ...
</system.serviceModel>

この構成エントリには、WMI インターフェイスが開示されます。管理アプリケーションはこのインターフェイスを通して接続し、アプリケーションの Management Instrumentation にアクセスできるようになります。

カスタム WMI オブジェクト

WMI オブジェクトをサービスに追加すると、組み込みの WMI プロバイダーの情報と共にユーザー定義の情報を開示できます。これは、Installutil.exe アプリケーションを使用してサービスのスキーマを WMI に公開することによって実現されます。これを行うための手順および詳細情報は、このトピックの最後のセットアップ手順で示します。

WMI 情報へのアクセス

WMI データには、複数の異なる方法でアクセスできます。 Microsoft では、スクリプト、Visual Basic アプリケーション、C++ アプリケーション、.NET Framework 用の WMI API を提供しています。詳細については、「WMI の使用」を参照してください。

このサンプルでは、2 つの Java スクリプトを使用します。1 つ目は、コンピューター上で実行されているサービスとその一部のプロパティを列挙するスクリプトで、2 つ目はユーザー定義の WMI データを表示するスクリプトです。スクリプトは、WMI プロバイダーへの接続を開き、データを解析し、収集されたデータを表示します。

サンプルを開始して、WCF サービスの実行中のインスタンスを作成します。サービスの実行中は、コマンドプロンプトで次のコマンドを入力することによって、それぞれの Java スクリプトを実行してください。

cscript EnumerateServices.js

スクリプトは、サービスに含まれているインストルメンテーションにアクセスし、次の出力を生成します。

Microsoft (R) Windows Script Host Version 5.6
Copyright © Microsoft Corporation 1996-2001. All rights reserved.

1 service(s) found.
|-PID:           5776
|-DistinguishedName:  CalculatorService@http://localhost/ServiceModelSamples/service.svc
|-Endpoints:     1 endpoints
  |-CalculatorService.ICalculator@http://localhost/ServiceModelSamples/service.svc
    |-Address:                        http://localhost/ServiceModelSamples/service.svc
    |-CounterInstanceName:
    |-AddressHeaders:                 0
    |-ContractType:                   Contract.Name='ICalculator'
    |-BindingElements:                4 bindings
      |-BindingElements[0]
        |-Type:                       TransactionFlowBindingElement
      |-BindingElements[1]
        |-Type:                       SymmetricSecurityBindingElement
      |-BindingElements[2]
        |-Type:                       TextMessageEncodingBindingElement
        |-MaxReadPoolSize:            64
        |-MaxWritePoolSize:           16
      |-BindingElements[3]
        |-Type:                       HttpTransportBindingElement
        |-ManualAddressing:           false
        |-MaxBufferSize:              65536
        |-AllowCookies:               false
        |-AuthenticationScheme:       Anonymous
        |-BypassProxyOnLocal:         false
        |-HostNameComparisonMode:     StrongWildcard
        |-ProxyAddress:               null
        |-ProxyAuthenticationScheme:  Anonymous
        |-Realm:
        |-TransferMode:               Buffered
        |-UseDefaultWebProxy:         true
|-Behaviors:     5 behaviors
      |-Behavior[0]
      |-Type:                       ServiceBehaviorAttribute
        |-AddressFilterMode:               Exact
        |-AutomaticSessionShutdown:        true
        |-ConcurrencyMode:                 Single
        |-IncludeExceptionDetailInFaults:  false
        |-InstanceContextMode:             PerSession
        |-TransactionIsolationLevel:       Unspecified
        |-TransactionTimeout:              null
        |-ValidateMustUnderstand:          true
      |-Behavior[1]
      |-Type:                       AspNetCompatibilityRequirementsAttribute
      |-Behavior[2]
      |-Type:                       ServiceDebugBehavior
      |-Behavior[3]
      |-Type:                       ServiceAuthorizationBehavior
      |-Behavior[4]
      |-Type:                       Behavior

次に、2 つ目の Java スクリプトを実行して、ユーザー定義の WMI データを表示します。

cscript EnumerateCustomObjects.js

スクリプトは、サービスに含まれているユーザー定義のインストルメンテーションにアクセスし、次の出力を生成します。

1 WMIObject(s) found.
|-PID:           30285bfd-9d66-4c4e-9be2-310499c5cef5
|-InstanceId:    3839
|-WMIInfo:       User Defined WMI Information.

この出力は、コンピューター上で 1 つのサービスが実行中であることを示しています。サービスは、ICalculator コントラクトを実装する 1 つのエンドポイントを公開します。このエンドポイントによって実装されている動作とバインディングの設定は、メッセージスタックの個々の要素の合計として表示されます。

WMI でできることは、WCF インフラストラクチャの管理インストルメンテーションの公開だけではありません。独自のドメイン固有のデータアイテムを、同じ機構を使用して公開できます。 WMI は、Web サービスの検査と制御のための統一された機構です。

サンプルをセットアップ、ビルド、および実行するには

Windows Communication Foundation サンプルの 1 回限りのセットアップの手順を実行したことを確認します。
ソリューションの C# 版または Visual Basic .NET 版をビルドするには、「 Building the Windows Communication Foundation Samples」の手順に従います。
サービススキーマを WMI に公開します。これを行うには、ホストディレクトリ内の service.dll ファイルに対して、InstallUtil.exe (既定の場所は "%WINDIR%\Microsoft.NET\Framework\v4.0.30319") を実行します。この手順を実行する必要があるのは、service.dll ファイルを変更した場合のみです。
単一または複数コンピューター構成でサンプルを実行するには、「Windows Communication Foundation サンプルの実行」の手順に従います。

注意

ASP.NET のインストール後に WCF をインストールした場合は、"%WINDIR%\ Microsoft.Net\Framework\v3.0\Windows Communication Foundation\servicemodelreg.exe" -r -x を実行して、ASPNET アカウントに WMI オブジェクトを公開する権限を付与する必要がある場合があります。
コマンド cscript EnumerateServices.js または cscript EnumerateCustomObjects.js を使用して、WMI を通じて示されるサンプルのデータを表示します。

次の方法で共有

WMI プロバイダー

カスタム WMI オブジェクト

WMI 情報へのアクセス

サンプルをセットアップ、ビルド、および実行するには

関連項目

その他のリソース