获取Windows事件提供程序信息

Question

我想使用Windows PowerShell检索有关事件提供程序的信息？我正在使用PowerShell 4.0版运行Windows 8.1，我注意到System.Diagnostics.Eventing namespace中有一些.NET类提供了围绕Windows事件的一些功能。

我可以通过调用其默认构造函数来创建EventProvider实例，但是这不允许我获取有关系统上安装的事件提供程序的任何信息。

$EventProvider = New-Object -TypeName System.Diagnostics.Eventing.EventProvider -ArgumentList ([System.Guid]'{00000000-0000-0000-0000-000000000000}');

如何使用Windows PowerShell获取有关安装在系统上的Windows事件跟踪（ETW）提供程序以及与Windows事件日志交互的更多信息？

我已经知道我可以使用命令logman.exe query providers作为described here来检索ETW提供程序列表，并查询Windows事件日志，但这不是PowerShell友好的。

Answer 1

还有另一个名为System.Diagnostics.Eventing.Reader的.NET命名空间，它包含许多.NET类，允许您检索有关Windows事件跟踪（ETW）提供程序和使用Windows操作系统注册的事件日志的信息。大多数这些类型都是在.NET System.Core.dll的Global Assembly Cache (GAC) .NET程序集中定义的。

例如，您可以执行以下操作（以及更多）：

• 找出计算机上安装的ETW提供程序的名称
• 发现计算机上存在的ETW日志名称的完整列表
• 枚举与ETW提供程序相关的元数据
• 导出事件日志数据

ETW提供商名称

ETW的核心功能之一是获取在给定系统上安装的ETW提供程序列表。您可以使用System.Diagnostics.Eventing.Reader命名空间中的.NET Framework类型轻松检索此信息。恰好是一个名为EventLogSession的.NET类，在这个类上有一个名为GlobalSession的静态属性，它自动检索本地计算机上事件日志服务的会话/连接。如有必要，您也可以使用EventLogSession类中的一个构造函数连接到远程计算机。

一旦检索到EventLogSession类的实例，就可以调用GetProviderNames()方法来检索一组String对象，这些对象代表计算机上已安装的ETW提供程序的名称。

以下是从本地计算机检索提供程序名称的示例：

$EventSession = [System.Diagnostics.Eventing.Reader.EventLogSession]::GlobalSession;
$EventProviderNames = $EventSession.GetProviderNames();
$EventProviderNames;

以下是使用alternate constructor从远程计算机检索ETW提供程序名称的示例：

$EventSession = New-Object -TypeName System.Diagnostics.Eventing.Reader.EventLogSession -ArgumentList server01.contoso.com;
$EventProviderNames = $EventSession.GetProviderNames();
$EventProviderNames;

您可以使用EventLogSession类的其他构造函数来指定远程计算机的备用凭据。 alternate constructor类的EventLogSession需要以下参数：

• 电脑名称
• 域名
• 用户名
• 密码（作为SecureString）
• System.Diagnostics.Eventing.Reader.SessionAuthentication类型

以下是如何实现这一目标的示例：

$ComputerName = 'server01.contoso.com';
$Credential   = Get-Credential;
$ArgumentList = $ComputerName, $Credential.UserName.Split('\')[0], $Credential.UserName.Split('\')[1], $Credential.Password, [System.Diagnostics.Eventing.Reader.SessionAuthentication]::Default;
$EventSession = New-Object -TypeName System.Diagnostics.Eventing.Reader.EventLogSession -ArgumentList $ArgumentList;

ETW日志名称

一旦发现计算机上安装的所有ETW提供程序，您可能还希望浏览计算机上可用的ETW日志的完整列表。 EventLogSession类还有一个名为GetLogNames()的方法，它返回一组String对象，这些对象代表目标系统上可用的ETW日志。与GetProviderNames()方法类似，您可以在本地或远程计算机上调用GetLogNames()。

以下是从本地计算机检索ETW日志名称的示例：

$EventSession = [System.Diagnostics.Eventing.Reader.EventLogSession]::GlobalSession;
$EventLogNames = $EventSession.GetLogNames();
$EventLogNames;

以下是从远程计算机检索ETW日志名称的示例：

$EventSession = New-Object -TypeName System.Diagnostics.Eventing.Reader.EventLogSession -ArgumentList server01.contoso.com;
$EventLogNames = $EventSession.GetLogNames();
$EventLogNames;

ETW提供商元数据

除了检索ETW提供程序名称之外，您可能还希望检索有关它们的更多详细信息。您可以使用ProviderMetadata .NET类中的System.Diagnostics.Eventing.Reader类来完成此操作。 ProviderMetadata课程提供的信息包括：

• 提供者显示名称
• 帮助链接（URL）
• 提供者的关键字
• ETW提供商ID（GUID）
• 消息文件路径
• 资源文件路径
• 参数文件路径
• 提供者公开的任务
• 提供者声明的每个事件的事件元数据

与ETW提供程序和ETW日志名称类似，您可以从本地或远程系统检索提供程序元数据。在后一种情况下，您必须在尝试实例化EventLogSession类之前建立ProviderMetadata实例。

以下是从本地系统检索ETW提供程序元数据的示例：

# Get the EventLogSession object
$EventSession = [System.Diagnostics.Eventing.Reader.EventLogSession]::GlobalSession;
# Get the ETW provider names
$EventProviderNames = $EventSession.GetProviderNames();

# Create an empty array to hold the ProviderMetadata instances
$ProviderMetadataList = @();
# For each ETW provider name ...
foreach ($EventProvider in $EventProviderNames) {
    # Add each ProviderMetadata instance to the array
    $ProviderMetadataList += New-Object -TypeName System.Diagnostics.Eventing.Reader.ProviderMetadata -ArgumentList $EventProvider;
}

# Explore the 16th item from the ProviderMetadata array
$ProviderMetadataList[15];

要从远程系统检索ETW提供程序元数据，请在实例化EventLogSession类之前构建ProviderMetadata对象，并在实例化ProviderMetadata时，确保将以下参数传递给constructor：

• ETW提供商名称
• EventLogSession实例
• 一个CultureInfo对象

...

$ComputerName = 'server01.contoso.com';
$Credential   = Get-Credential;
$SessionArgumentList = $ComputerName, $Credential.UserName.Split('\')[0], $Credential.UserName.Split('\')[1], $Credential.Password, [System.Diagnostics.Eventing.Reader.SessionAuthentication]::Kerberos;
$EventSession = New-Object -TypeName System.Diagnostics.Eventing.Reader.EventLogSession -ArgumentList $SessionArgumentList;
$EventProviderNames = $EventSession.GetProviderNames();

# Create an empty array to hold the ProviderMetadata instances
$ProviderMetadataList = @();
foreach ($EventProvider in $EventProviderNames) {
    # Build the Arguments for the ProviderMetadata constructor
    $ProviderMetadataArgumentList = $EventProvider, $EventSession, [CultureInfo]::CurrentCulture;
    # Add each ProviderMetadata instance to the array
    $ProviderMetadataList += New-Object -TypeName System.Diagnostics.Eventing.Reader.ProviderMetadata -ArgumentList $ProviderMetadataArgumentList;
}

# Explore the 111th item from the array
$ProviderMetadataList[110];

注意：通过经过身份验证的连接实例化ProviderMetadata对象时，可能会遇到一些异常：

New-Object：使用“3”参数调用“.ctor”的异常：“试图执行未经授权的操作。”

阅读ETW事件日志

由于您提到您还想从ETW事件日志中读取事件，因此使用System.Diagnostics.Eventing.Reader .NET命名空间中的类型也很容易。 EventLogReader类包含一个名为ReadEvent()的方法，该方法从EventLogReader实例化时指定的事件日志中不断读取下一个事件。

以下是从System事件日志中读取事件的简单示例：

# Instantiate the EventLogReader .NET class
$EventLogReader = New-Object -TypeName System.Diagnostics.Eventing.Reader.EventLogReader -ArgumentList 'System';
# Read the first 5 events from the event log
1..5 | % { $EventLogReader.ReadEvent(); };

ETW事件日志配置

与先前检索的提供程序元数据类似，您可以检索有关特定ETW事件日志配置的信息。为此，您实例化EventLogConfiguration class，传入ETW事件日志的名称。将返回有关事件日志的各种信息，包括：

• 日志名称
• 最大大小（以字节为单位）
• 提供商名称
• 日志类型
• 安全描述符
• 缓冲区大小
• 是否启用了日志？

以下是如何检索此信息的示例：

$EventSession = [System.Diagnostics.Eventing.Reader.EventLogSession]::GlobalSession;
$EventLogNames = $EventSession.GetLogNames();

$EventLogConfigurationList = @();
foreach ($EventLogName in $EventLogNames) {
    $EventLogConfigurationList += New-Object -TypeName System.Diagnostics.Eventing.Reader.EventLogConfiguration -ArgumentList $EventLogName;
}
$EventLogConfigurationList[5];

Answer 2

# working in version 5
$providers = Get-WinEvent -ListProvider * | select name
$providers