Set-TraceSource

Módulo:

Microsoft.PowerShell.Utility

Configura, inicia y detiene un seguimiento de los componentes de PowerShell.

Sintaxis

Set-TraceSource
   [-Name] <String[]>
   [[-Option] <PSTraceSourceOptions>]
   [-ListenerOption <TraceOptions>]
   [-FilePath <String>]
   [-Force]
   [-Debugger]
   [-PSHost]
   [-PassThru]
   [<CommonParameters>]

Set-TraceSource
   [-Name] <String[]>
   [-RemoveListener <String[]>]
   [<CommonParameters>]

Set-TraceSource
   [-Name] <String[]>
   [-RemoveFileListener <String[]>]
   [<CommonParameters>]

Description

El cmdlet Set-TraceSource configura, inicia y detiene un seguimiento de un componente de PowerShell. Puede usarlo para especificar qué componentes se rastrearán y dónde se enviará la salida de seguimiento.

Ejemplos

Ejemplo 1: Seguimiento del componente ParameterBinding

Set-TraceSource -Name "ParameterBinding" -Option ExecutionFlow -PSHost -ListenerOption "ProcessId,TimeStamp"

Este comando inicia el seguimiento del componente ParameterBinding de PowerShell. Usa el parámetro Name para especificar el origen de seguimiento, el parámetro Option para seleccionar los eventos de seguimiento ExecutionFlow y el parámetro PSHost para seleccionar el agente de escucha del host de PowerShell, que envía la salida a la consola. El parámetro ListenerOption agrega los valores ProcessId y TimeStamp al prefijo del mensaje de seguimiento.

Ejemplo 2: Detener un seguimiento

Set-TraceSource -Name "ParameterBinding" -RemoveListener "Host"

Este comando detiene el seguimiento del componente ParameterBinding de PowerShell. Usa el parámetro Name para identificar el componente que se estaba rastreando y el parámetro RemoveListener para identificar el agente de escucha de seguimiento.

Parámetros

-Debugger

Indica que el cmdlet envía la salida de seguimiento al depurador. Puede ver la salida en cualquier depurador de modo de usuario o modo kernel o en Microsoft Visual Studio. Este parámetro también selecciona el agente de escucha de seguimiento predeterminado.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FilePath

Especifica un archivo al que este cmdlet envía la salida de seguimiento. Este parámetro también selecciona el agente de escucha de seguimiento de archivos. Si usa este parámetro para iniciar el seguimiento, use el parámetro RemoveFileListener para detener el seguimiento.

Tipo:	String
Alias:	PSPath, Path
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Force

Indica que el cmdlet sobrescribe un archivo de solo lectura. Use con el parámetro FilePath.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ListenerOption

Especifica los datos opcionales para el prefijo de cada mensaje de seguimiento en la salida. Los valores aceptables para este parámetro son:

• None
• LogicalOperationStack
• DateTime
• Timestamp
• ProcessId
• ThreadId
• Callstack

None es el valor predeterminado.

Estos valores se definen como una enumeración basada en marcas. Puede combinar varios valores para establecer varias marcas mediante este parámetro. Los valores se pueden pasar al parámetro listenerOption de como una matriz de valores o como una cadena separada por comas de esos valores. El cmdlet combinará los valores mediante una operación binary-OR. Pasar valores como una matriz es la opción más sencilla y también permite usar la finalización de tabulación en los valores.

Tipo:	TraceOptions
Valores aceptados:	None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Name

Especifica qué componentes se rastrean. Escriba el nombre del origen de seguimiento de cada componente. Se permiten caracteres comodín.

Tipo:	String[]
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	True

-Option

Especifica el tipo de eventos de seguimiento. Los valores aceptables para este parámetro son:

• None
• Constructor
• Dispose
• Finalizer
• Method
• Property
• Delegates
• Events
• Exception
• Lock
• Error
• Errors
• Warning
• Verbose
• WriteLine
• Data
• Scope
• ExecutionFlow
• Assert
• All

None es el valor predeterminado.

Los valores siguientes son combinaciones de otros valores:

• ExecutionFlow: Constructor, Dispose, Finalizer, Method, Delegates, Events, Scope
• Data: Constructor, Dispose, Finalizer, Property, Verbose, WriteLine
• Errors: Error, Exception

Estos valores se definen como una enumeración basada en marcas. Puede combinar varios valores para establecer varias marcas mediante este parámetro. Los valores se pueden pasar al parámetro Option como una matriz de valores o como una cadena separada por comas de esos valores. El cmdlet combinará los valores mediante una operación binary-OR. Pasar valores como una matriz es la opción más sencilla y también permite usar la finalización de tabulación en los valores.

Tipo:	PSTraceSourceOptions
Valores aceptados:	None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All
Posición:	1
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ninguna salida.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PSHost

Indica que este cmdlet envía la salida de seguimiento al host de PowerShell. Este parámetro también selecciona el agente de escucha de seguimiento de PSHost.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveFileListener

Detiene el seguimiento quitando el agente de escucha de seguimiento de archivos asociado al archivo especificado. Escriba la ruta de acceso y el nombre de archivo del archivo de salida de seguimiento.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveListener

Detiene el seguimiento quitando el agente de escucha de seguimiento.

Use los siguientes valores con RemoveListener:

• Para quitar PSHost (consola), escriba Host.
• Para quitar depurador, escriba Debug.
• Para quitar todos los agentes de escucha de seguimiento, escriba *.

Para quitar el agente de escucha de seguimiento de archivos, use el parámetro RemoveFileListener.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

Puede canalizar una cadena que contenga un nombre a este cmdlet.

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

PSTraceSource

Cuando se usa el parámetro PassThru, este cmdlet devuelve un objeto PSTraceSource que representa la sesión de seguimiento.

Notas

• El seguimiento es un método que los desarrolladores usan para depurar y refinar programas. Al realizar el seguimiento, el programa genera mensajes detallados sobre cada paso en su procesamiento interno.

  Los cmdlets de seguimiento de PowerShell están diseñados para ayudar a los desarrolladores de PowerShell, pero están disponibles para todos los usuarios. Permiten supervisar casi todos los aspectos de la funcionalidad de PowerShell.

  Un origen de seguimiento es la parte de cada componente de PowerShell que administra el seguimiento y genera mensajes de seguimiento para el componente. Para realizar un seguimiento de un componente, identifique su origen de seguimiento.

  Un agente de escucha de seguimiento recibe la salida del seguimiento y lo muestra al usuario. Puede optar por enviar los datos de seguimiento a un depurador en modo de usuario o en modo kernel, a la consola, a un archivo o a un agente de escucha personalizado derivado de la clase System.Diagnostics.TraceListener.

• Para iniciar un seguimiento, use el parámetro Name para especificar un origen de seguimiento y el FilePath, Debuggero PSHost parámetros para especificar un agente de escucha (un destino para la salida). Use el parámetro Opciones de para determinar los tipos de eventos que se siguen y el parámetro ListenerOption para configurar la salida de seguimiento.

• Para cambiar la configuración de un seguimiento, escriba un comando Set-TraceSource como lo haría para iniciar un seguimiento. PowerShell reconoce que el origen de seguimiento ya se está rastreando. Detiene el seguimiento, agrega la nueva configuración e inicia o reinicia el seguimiento.

• Para detener un seguimiento, use el parámetro RemoveListener. Para detener un seguimiento que use el agente de escucha de archivos (un seguimiento iniciado mediante el parámetro FilePath), use el parámetro RemoveFileListener. Al quitar el agente de escucha, el seguimiento se detiene.

• Para determinar qué componentes se pueden rastrear, use Get-TraceSource. Los orígenes de seguimiento de cada módulo se cargan automáticamente cuando el componente está en uso y aparecen en la salida de Get-TraceSource.

Vínculos relacionados

• Get-TraceSource
• Trace-Command