通过

使用 Windows Management Instrumentation 进行诊断

  • 项目

Windows Communication Foundation (WCF) 通过 WCF Windows Management Instrumentation (WMI) 提供程序在运行时公开服务的检测数据。

启用 WMI

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

WMI 提供程序是一个在运行时通过 WBEM 兼容接口公开规范的组件。它由一组包含属性/值对的 WMI 对象组成。这些对可以是多个简单类型。管理工具可以在运行时通过接口连接至服务。WCF 公开服务的属性，如地址、绑定、行为和侦听器。

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

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

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

访问 WMI 数据

可以采用多种不同方式访问 WMI 数据。Microsoft 提供用于脚本的 WMI API、Visual Basic 应用程序、C++ 应用程序和 .NET Framework。有关更多信息，请参见使用 WMI（可能为英文网页）。

警告

如果您使用 .NET Framework 提供的方法以编程方式访问 WMI 数据，您应注意此类方法可能会在建立连接时引发异常。连接并不是在构建 ManagementObject 实例的过程中建立的，而是在涉及实际数据交换的第一次请求时建立的。因此，您应该使用 try..catch 块来捕捉可能的异常。

您可以在 WMI 中更改 System.ServiceModel 跟踪源的跟踪和消息日志记录级别以及消息日志记录选项。这可以通过访问 AppDomainInfo 实例实现，此实例将公开下列布尔属性：LogMessagesAtServiceLevel、LogMessagesAtTransportLevel、LogMalformedMessages 和 TraceLevel。因此，如果为消息日志记录配置了跟踪侦听器，但是在配置中将这些选项设置为 false，那么可以在以后运行应用程序时将它们更改为 true。这将在运行时有效地启用消息日志记录。同样，如果在配置文件中启用了消息日志记录，可以在运行时使用 WMI 将其禁用。

您应该注意如果没有用于消息日志记录的消息日志记录跟踪侦听器，或者配置文件中没有指定用于跟踪的 System.ServiceModel 跟踪侦听器，您所执行的任何更改都将无效，即使已被 WMI 接受的更改也不例外。有关正确设置各自侦听器的更多信息，请参见配置消息日志记录和配置跟踪。应用程序启动时，由配置指定的所有其他跟踪源的跟踪级别均有效，而且不能更改。

WCF 公开 GetOperationCounterInstanceName 方法以编写脚本。如果您为其提供了一个操作名称，此方法将返回一个性能计数器实例名称。但是，它不会验证您的输入。因此，如果您提供了一个不正确的操作名称，将返回不正确的计数器名称。

如果没有在 Service 方法中创建目标服务的 WCF 客户端，则 Service 实例的 OutgoingChannel 属性将不会计算由某项服务打开以连接至其他服务的通道数量。

警告 WMI 仅支持最多 3 位小数的 TimeSpan 值。例如，如果您的服务将其中一个属性设置为 MaxValue，当通过 WMI 查看时，它的值将保留 3 位小数。

安全性

因为 WCF WMI 提供程序允许在某个环境中发现服务，您应该在为其授予访问权限时特别小心。如果您放宽了默认的仅管理员访问，就可能允许不完全受信任方访问您的环境中的敏感数据。特别是，如果您放宽了对远程 WMI 访问的权限，可能会发生洪泛攻击。如果某个进程被大量 WMI 请求溢满，其性能将有所下降。

此外，如果您放宽了对 MOF 文件的访问权限，不完全受信任方可以控制 WMI 的行为并更改加载到 WMI 架构中的对象。例如，不完全受信任方可以移除字段，这样，管理员将无法看到关键数据，或者未填充或导致异常的字段将添加到文件中。

默认情况下，WCF WMI 提供程序将对管理员授予“执行方法”、“提供程序编写”和“启用帐户”权限，并对 ASP.NET、本地服务和网络服务授予“启用帐户”权限。尤其是，在非 Windows Vista 平台中，ASP.NET 帐户对 WMI ServiceModel 命名空间具有读访问权限。如果您不希望对特定用户组授予这些特权，就应该停用 WMI 提供程序（默认状态为禁用），或者是禁用对特定用户组的访问。

此外，当您尝试通过配置启用 WMI 时，WMI 可能会因用户特权不足而无法启用。但是，并不会将任何事件写入事件日志用于记录此次失败。

若要修改用户特权级别，请使用下列步骤。

  1. 单击“开始”，然后单击“运行”并键入 compmgmt.msc。
  2. 右击**“服务和应用程序/WMI 控制”[Services and Application/WMI Controls]以选择“属性”**。
  3. 选择**“安全性”选项卡，然后定位到“Root/ServiceModel”命名空间。单击“安全性”**按钮。
  4. 选择您希望控制访问权限的特定组或用户，并使用**“允许”或“拒绝”**复选框配置权限。

访问远程 WMI 对象实例

如果您需要访问远程计算机上的 WCF WMI 实例，就必须对您用于访问的工具启用数据包保密性。以下部分描述如何通过使用 WMI CIM Studio、Windows Management Instrumentation 测试器以及 .NET SDK 2.0 实现这些目标。

WMI CIM Studio

如果您安装了 WMI 管理工具（可能为英文网页），即可使用 WMI CIM Studio 访问 WMI 实例。这些工具位于以下文件夹中

%windir%\Program Files\WMI Tools\

  1. 在**“连接至命名空间:”** 窗口中，键入root\ServiceModel 并单击**“确定”**。
  2. 在**“WMI CIM Studio 登录”** 窗口中，单击**“选项 >>”按钮展开该窗口。对“身份验证级别”选择“数据包保密性”，然后单击“确定”**。

Windows Management Instrumentation 测试器

此工具由 Windows 安装。若要运行此工具，请在**“开始/运行”对话框中键入cmd.exe** 以启动命令控制台，然后单击**“确定”。然后，在命令窗口中键入wbemtest.exe**。Windows Management Instrumentation 测试器工具随即启动。

  1. 单击窗口右上角的**“连接”**按钮。
  2. 在新窗口中，在**“命名空间”字段中输入root\ServiceModel**，然后对**“身份验证级别”选择“数据包保密性”。单击“连接”**。

使用托管代码

您还可以通过使用由 System.Management 命名空间提供的类以编程方式访问远程 WMI 实例。下面的代码示例演示如何实现此操作。

String wcfNamespace = String.Format(@"\\{0}\Root\ServiceModel",    
   this.serviceMachineName);

ConnectionOptions connection = new ConnectionOptions();
connection.Authentication = AuthenticationLevel.PacketPrivacy;
ManagementScope scope = new ManagementScope(this.wcfNamespace, connection);