Set-TraceSource

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

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.

PS C:\> 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.

PS C:\> 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.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede canalizar una cadena que contenga un nombre para Set-TraceSource.

Cuando se usa el parámetro PassThru, Set-TraceSource genera un objeto System.Management.Automation.PSTraceSource que representa la sesión de seguimiento. De lo contrario, este cmdlet no genera ninguna salida.

• 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 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.