WMI 提供程序

2008-09-04

此示例演示如何在运行时使用 WCF 中内置的 Windows Management Instrumentation (WMI) 提供程序从 Windows Communication Foundation (WCF) 服务中收集数据。另外，此示例还演示如何向服务添加用户定义的 WMI 对象。该示例激活入门示例的 WMI 提供程序，并演示如何在运行时从 ICalculator 服务收集数据。

WMI 是 Microsoft 基于 Web 的企业管理 (WBEM) 标准的实现。有关 WMI SDK 的更多信息，请参阅 MSDN Library(https://msdn.microsoft.com/library/default.asp?url=/library/en-us/wmisdk/wmi/wmi\_start\_page.asp)。WBEM 是有关应用程序如何向外部管理工具公开管理规范的行业标准。

WCF 实现 WMI 提供程序，该提供程序是一个在运行时通过 WBEM 兼容接口公开规范的组件。管理工具可以在运行时通过接口连接至服务。WCF 公开服务的属性，如地址、绑定、行为和侦听器。

在应用程序的配置文件中激活内置 WMI 提供程序。这可以通过 system.ServiceModel element一节中的 <diagnostics> Element的 wmiProviderEnabled 属性实现，如以下示例配置所示：

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

此配置项公开 WMI 接口。现在，您可以通过此接口连接管理应用程序并访问应用程序的管理规范。

自定义 WMI 对象

将 WMI 对象添加到服务，可以显示用户定义的信息以及内置的 WMI 提供程序信息。这可以通过使用 Installutil.exe 应用程序将服务方案发布到 WMI 来实现。本主题末尾的安装说明介绍了如何实现上述操作的说明以及更详细的信息。

访问 WMI 信息

可以采用多种不同方式访问 WMI 数据。Microsoft 提供脚本、Visual Basic 应用程序、C++ 应用程序和 .NET Framework 的 WMI API (https://msdn.microsoft.com/library/default.asp?url=/library/en-us/wmisdk/wmi/using\_wmi.asp)。

此示例使用两个 Java 脚本：一个脚本用于枚举在计算机上运行的服务及其某些属性，另一个脚本用于查看用户定义的 WMI 数据。该脚本打开与 WMI 提供程序的连接、分析数据并显示所收集的数据。

启动该示例可以创建 WCF 服务的一个运行中实例。在该服务运行的同时，在命令提示符处使用以下命令运行每个 Java 脚本：

cscript EnumerateServices.js

该脚本访问服务中包含的规范，并生成下面的输出：

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

1 service(s) found.
|-PID:           5776
|-DistinguishedName:  CalculatorService@https://localhost/ServiceModelSamples/service.svc
|-Endpoints:     1 endpoints
  |-CalculatorService.ICalculator@https://localhost/ServiceModelSamples/service.svc
    |-Address:                        https://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

接下来，运行第二个 Java 脚本可以显示用户定义的 WMI 数据：

cscript EnumerateCustomObjects.js

该脚本访问服务中包含的用户定义的规范，并生成下面的输出：

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

该输出显示计算机上正在运行一个单一服务。该服务公开一个实现 ICalculator 协定的终结点。该终结点实现的行为和绑定的设置列作消息堆栈的各个元素的总和。

WMI 不仅限于公开 WCF 基础结构的管理规范。该应用程序可以通过相同机制公开它自己的特定域数据项。WMI 是用于检查和控制 Web 服务的统一机制。

设置、生成和运行示例

请确保已经执行了 Windows Communication Foundation 示例的一次性安装过程。
若要生成 C# 或 Visual Basic .NET 版本的解决方案，请按照生成 Windows Communication Foundation 示例中的说明进行操作。
通过在宿主目录中的 service.dll 文件上运行 InstallUtil.exe（InstallUtil.exe 的默认位置是“%WINDIR%\Microsoft.NET\Framework\v2.0.50727”），可以将服务方案发布到 WMI。只有在对 service.dll 文件进行了更改的情况下才需要执行此步骤。有关详细信息，请参阅“如何：将方案发布到已检测的应用程序的 WMI”一节中位于 https://msdn2.microsoft.com/en-us/library/ms186147.aspx 的“通过检测应用程序提供管理信息”。
若要用单机配置或跨计算机配置来运行示例，请按照运行 Windows Communication Foundation 示例中的说明进行操作。

提示

如果您在安装 ASP.NET 之后安装了 WCF，则可能需要运行 "%WINDIR%\ Microsoft.Net\Framework\v3.0\Windows Communication Foundation\servicemodelreg.exe " -r -x 以便为 ASPNET 帐户授予发布 WMI 对象的权限。
使用下面的命令可以查看通过 WMI 显示的示例：cscript EnumerateServices.js 或 cscript EnumerateCustomObjects.js。

通过

WMI 提供程序

自定义 WMI 对象

访问 WMI 信息

设置、生成和运行示例

其他资源