Set-TraceSource (Microsoft.PowerShell.Utility)

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>]

Descripción

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á el resultado del rastreo.

Ejemplos

Ejemplo 1: rastrear el componente ParameterBinding

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

Este comando inicia el seguimiento del componente ParameterBinding de PowerShell. Utiliza el parámetro Name para especificar el origen del seguimiento, el parámetro Option para seleccionar los eventos de seguimiento ExecutionFlow y el PSHost. parámetro para seleccionar el oyente 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. Utiliza el parámetro Name para identificar el componente que se estaba rastreando y el parámetro RemoveListener para identificar el detector de seguimiento.

Parámetros

-Debugger

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

Tipo :

SwitchParameter

Posición:

Nombrado

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 el resultado del seguimiento. Este parámetro también selecciona el detector de seguimiento de archivos. Si utiliza este parámetro para iniciar el seguimiento, utilice el parámetro RemoveFileListener para detener el seguimiento.

Tipo :

String

Alias:

PSPath, Path

Posición:

Nombrado

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. Úselo con el parámetro FilePath.

Tipo :

SwitchParameter

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-ListenerOption

Especifica 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

Ninguno es el valor predeterminado.

Estos valores se definen como una enumeración basada en indicadores. Puede combinar varios valores para establecer varios indicadores utilizando este parámetro. Los valores se pueden pasar al parámetro ListenerOption como una matriz de valores o como una cadena de esos valores separada por comas. El cmdlet combinará los valores mediante una operación binaria O. Pasar valores como una matriz es la opción más simple y también le permite usar la función de tabulación en los valores.

Tipo :

TraceOptions

Valores aceptados:

Ninguno, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Name

Especifica qué componentes se rastrean. Introduzca el nombre del origen de seguimiento de cada componente. Se permiten comodines.

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 que se rastrean. 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

Todos es el valor predeterminado.

Los siguientes valores son combinaciones de otros valores:

• Flujo de ejecución: Constructor, Dispose, Finalizador, Método, Delegados, Eventos, Ámbito
• Datos: Constructor, Dispose, Finalizador, Propiedad, Detallado, Línea de escritura
• Errores: Error, Excepción

Estos valores se definen como una enumeración basada en indicadores. Puede combinar varios valores para establecer varios indicadores utilizando este parámetro. Los valores se pueden pasar al parámetro Opción como una matriz de valores o como una cadena de esos valores separada por comas. El cmdlet combinará los valores mediante una operación binaria O. Pasar valores como una matriz es la opción más simple y también le permite usar la función de tabulación en los valores.

Tipo :

Opciones de PSTraceSource

Valores aceptados:

Ninguno, Constructor, Disponer, Finalizador, Método, Propiedad, Delegados, Eventos, Excepción, Bloqueo, Error, Errores, Advertencia, Detallado, WriteLine, Datos, Alcance, ExecutionFlow, Afirmar, Todo

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ás trabajando. De forma predeterminada, este cmdlet no genera ningún resultado.

Tipo :

SwitchParameter

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-PSHost

Indica que este cmdlet envía el resultado del seguimiento al host de PowerShell. Este parámetro también selecciona el detector de seguimiento PSHost.

Tipo :

SwitchParameter

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-RemoveFileListener

Detiene el seguimiento eliminando el detector de seguimiento de archivos asociado con el archivo especificado. Introduzca la ruta y el nombre del archivo de salida del seguimiento.

Tipo :

String[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-RemoveListener

Detiene el seguimiento eliminando el detector de seguimiento.

Utilice los siguientes valores con RemoveListener:

• Para eliminar PSHost (consola), escriba Host.
• Para eliminar el depurador, escriba Debug.
• Para eliminar todos los detectores de seguimiento, escriba *.

Para eliminar el detector de seguimiento de archivos, utilice el parámetro RemoveFileListener.

Tipo :

String[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Cadena

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

Salidas

Ninguno

De forma predeterminada, este cmdlet no devuelve ningún resultado.

PSTraceSource

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

Notas

• El rastreo es un método que los desarrolladores utilizan para depurar y perfeccionar programas. Al realizar el seguimiento, el programa genera mensajes detallados sobre cada paso de 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. Le permiten monitorear casi todos los aspectos de la funcionalidad de PowerShell.

  Un origen de seguimiento es la parte de cada componente de PowerShell que gestiona el seguimiento y genera mensajes de seguimiento para el componente. Para rastrear un componente, se identifica su origen de rastreo.

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

• Para iniciar un seguimiento, utilice el parámetro Nombre para especificar un origen de seguimiento y el FilePath, Debugger o PSHost. parámetros para especificar un oyente (un destino para la salida). Utilice el parámetro Options para determinar los tipos de eventos que se rastrean y el parámetro ListenerOption para configurar la salida del seguimiento.

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

• Para detener un seguimiento, utilice el parámetro RemoveListener. Para detener un seguimiento que utiliza el detector de archivos (un seguimiento iniciado mediante el parámetro FilePath), utilice el parámetro RemoveFileListener. Cuando elimina al oyente, el seguimiento se detiene.

• Para determinar qué componentes se pueden rastrear, utilice Get-TraceSource. Las fuentes de seguimiento para cada módulo se cargan automáticamente cuando el componente está en uso y aparecen en la salida de Get-TraceSource.