Set-EtwTraceProvider

Artículo
11/16/2015

Se aplica a: Windows 10, Windows Server Technical Preview

Set-EtwTraceProvider

Modifies an ETW trace provider.

Sintaxis

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

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

Parameter Set: InputObject (cdxml)
Set-EtwTraceProvider [-CimSession <CimSession[]> ] [-Level <Byte> ] [-MatchAllKeyword <UInt64> ] [-MatchAnyKeyword <UInt64> ] [-PassThru] [-Property <UInt32> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Descripción detallada

The Set-EtwTraceProvider cmdlet modifies an Event Trace for Windows (ETW) trace provider that is associated with an ETW Autologger configuration or an ETW trace session.

Parámetros

-AutologgerName<String[]>

Specifies an array of names of ETW Autologger configurations. If you specify this parameter, do not specify the SessionName parameter.

Alias	none
¿Necesario?	true
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-CimSession<CimSession[]>

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.

Alias	Session
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Guid<String[]>

Specifies an array of GUIDs, as strings, of the ETW trace provider that this cmdlet modifies.

Alias	none
¿Necesario?	true
¿Posición?	1
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	true(ByPropertyName)
¿Aceptar caracteres comodín?	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.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	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.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	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.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-PassThru

Indicates that this cmdlet returns an object that represents the item on which it operates. By default, this cmdlet does not generate any output.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	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

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-SessionName<String[]>

Specifies an array of names of ETW trace sessions. If you specify this parameter, then do not specify the AutologgerName parameter.

Alias	none
¿Necesario?	true
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	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.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

¿Necesario?	false
¿Posición?	named
Valor predeterminado	false
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-WhatIf

Muestra lo que sucedería si se ejecuta el cmdlet. El cmdlet no se ejecuta.

¿Necesario?	false
¿Posición?	named
Valor predeterminado	false
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

<WorkflowParameters>

Entradas

El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet.

Salidas

El tipo de resultado es el tipo de los objetos que el cmdlet emite.

Ejemplos

Example 1: Modify an ETW trace provider

This command modifies the ETW trace provider that has the specified GUID. That provider is associated with a specified Autologger onfiguration named WFP-IPsec Trace. The command sets the Level to have a value of 2, TRACE_LEVEL_ERROR.

PS C:\> set-EtwTraceProvider -Guid "{106B464A-8043-46B1-8CB8-E92A0CD7A560}" -AutologgerName "WFP-IPsec Trace" –Level 2

Temas relacionados

Configuring and Starting an AutoLogger Session

Configuring and Starting an Event Tracing Session

Add-EtwTraceProvider

Get-EtwTraceProvider

Remove-EtwTraceProvider

Compartir a través de

Set-EtwTraceProvider