Add-EtwTraceProvider

[アーティクル]
11/16/2015

適用対象: Windows 10, Windows Server Technical Preview

Add-EtwTraceProvider

Adds an ETW trace provider to an ETW Autologger configuration or ETW session.

構文

Parameter Set: ByAutologger
Add-EtwTraceProvider [-Guid] <String> -AutologgerName <String> [-CimSession <CimSession[]> ] [-Level <Byte> ] [-MatchAllKeyword <UInt64> ] [-MatchAnyKeyword <UInt64> ] [-Property <UInt32> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: BySession
Add-EtwTraceProvider [-Guid] <String> -SessionName <String> [-CimSession <CimSession[]> ] [-Level <Byte> ] [-MatchAllKeyword <UInt64> ] [-MatchAnyKeyword <UInt64> ] [-Property <UInt32> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

詳細説明

The Add-EtwTraceProvider cmdlet adds an Event Trace for Windows (ETW) trace provider to an ETW Autologger configuration or to an ETW session.

パラメーター

-AutologgerName<String>

Specifies an ETW Autologger configuration. If you specify this parameter, do not specify the SessionName parameter.

Aliases	none
必須/オプション	true
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-CimSession<CimSession[]>

リモートセッションまたはリモートコンピューターでコマンドレットを実行します。コンピューター名またはセッションオブジェクト (New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など) を入力します。既定値は、ローカルコンピューター上の現在のセッションです。

Aliases	Session
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Guid<String>

Specifies the GUID, as a string, of the ETW trace provider that this cmdlet adds to an ETW Autologger configuration or to an ETW session.

Aliases	none
必須/オプション	true
位置	1
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Level<Byte>

Specifies the provider-defined value that specifies the level of detail included in the event. If you specify a value, that value entails all the values that have a lower value. For instance, if you specify a value of 3, for TRACE_LEVEL_WARNING, TRACE_LEVEL_ERROR and TRACE_LEVEL_CRITICAL events are also included. Valid values are:

-- 1: TRACE_LEVEL_CRITICAL. Abnormal exit or termination events.
-- 2: TRACE_LEVEL_ERROR. Severe error events.
-- 3: TRACE_LEVEL_WARNING. Warning events such as allocation failures.
-- 4: TRACE_LEVEL_INFORMATION. Non-error events such as entry or exit events.
-- 5: TRACE_LEVEL_VERBOSE. Detailed trace events.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-MatchAllKeyword<UInt64>

Specifies keywords, as a bitmask, that further restricts the category of events that the provider writes. If an event keyword meets the conditions specified by the MatchAnyKeyword parameter, the provider writes the event only if all of the bits specified by this parameter exist in the event keyword. Do not specify this parameter if you specify a value of zero for MatchAnyKeyword. Use the following format: 0x0000000000000001.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-MatchAnyKeyword<UInt64>

Specifies keywords, as a bitmask, that determine the category of events that the provider writes. The provider writes the event if any of the keyword bits match any of the bits set in this mask. Use the following format: 0x0000000000000001.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Property<UInt32>

Specifies a bitmask that determines whether to include one or more of the following items in the log file:

-- 0x00000001. The user security identifier
-- 0x00000002. The terminal session identifier

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-SessionName<String>

Specifies the name of the ETW session to which this cmdlet adds the ETW trace provider. If you specify this parameter, do not specify AutologgerName parameter.

Aliases	none
必須/オプション	true
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-ThrottleLimit<Int32>

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of zero is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

必須/オプション	false
位置	named
既定値	false
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-WhatIf

コマンドレットが実行された場合に何が起きるのかを示します。コマンドレットは実行されません。

必須/オプション	false
位置	named
既定値	false
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

<CommonParameters>

このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。

<WorkflowParameters>

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

使用例

Example 1: Add an ETW trace provider to an Autologger configuration

This command adds the ETW trace provider that has the specified GUID to an Autologger configuration named WFP-IPsec Trace.

PS C:\> Add-EtwTraceProvider -Guid "{5EEFEBDB-E90C-423A-8ABF-0241E7C5B87D}" -AutologgerName "WFP-IPsec Trace"

Example 2: Add an ETW trace provider to an ETW session

This command adds the ETW trace provider that has the specified GUID to an session named VMM.

PS C:\> Add-EtwTraceProvider -Guid "{5EEFEBDB-E90C-423A-8ABF-0241E7C5B87D}" -SessionName "VMM"

Add-EtwTraceProvider