Configura, inicia y detiene el seguimiento de los componentes de Windows PowerShell.
Sintaxis
Set-TraceSource [[-Option] {<None> | <Constructor> | <Dispose> | <Finalizer> | <Method> | <Property> | <Delegates> | <Events> | <Exception> | <Lock> | <Error> | <Errors> | <Warning> | <Verbose> | <WriteLine> | <Data> | <Scope> | <ExecutionFlow> | <Assert> | <All>}] [-Debugger] [-FilePath <string>] [-Force] [-ListenerOption {<None> | <LogicalOperationStack> | <DateTime> | <Timestamp> | <ProcessId> | <ThreadId> | <Callstack>}] [-PassThru] [-PSHost] [-Name] <string[]> [<CommonParameters>]
Set-TraceSource [-RemoveListener <string[]>] [-Name] <string[]> [<CommonParameters>]
Set-TraceSource [-RemoveFileListener <string[]>] [-Name] <string[]> [<CommonParameters>]
Descripción
El cmdlet Set-TraceSource configura, inicia y detiene el seguimiento de un componente de Windows PowerShell. El usuario puede especificar los componentes de los que se va a realizar un seguimiento y dónde se va a enviar el resultado de este seguimiento.
Parámetros
-Debugger
Envía el resultado del seguimiento al depurador. Puede ver el resultado en cualquier depurador en modo kernel o de usuario, o bien, en Microsoft Visual Studio. Este parámetro selecciona también el agente de escucha de seguimiento predeterminado.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-FilePath <string>
Envía el resultado del seguimiento al archivo especificado. Este parámetro seleccione también el agente de escucha de seguimiento de archivos. Si usa este parámetro para iniciar el seguimiento, use el parámetro RemoveFileListener para detenerlo.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Force
Permite al cmdlet sobrescribir un archivo de solo lectura. Se utiliza con el parámetro FilePath.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-ListenerOption <TraceOptions>
Agrega datos opcionales al prefijo de cada mensaje de seguimiento en la salida. Los valores válidos son "None", "LogicalOperationStack", "DateTime", "Timestamp", "ProcessId", "ThreadId" y "Callstack". "None" es el valor predeterminado.
Para especificar varias opciones, separe los valores mediante comas (sin espacios) y escríbalos entre paréntesis, por ejemplo "ProcessID,ThreadID".
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Name <string[]>
Determina los componentes de los que se va a realizar el seguimiento. Escriba el nombre del origen de seguimiento de cada componente. Se permite el uso de caracteres comodín.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Option <PSTraceSourceOptions>
Determina el tipo de eventos del que se va a realizar el seguimiento.
Los valores válidos son: "None", "Constructor", "Dispose", "Finalizer", "Method", "Property", "Delegates", "Events", "Exception", "Lock", "Error", "Errors", "Warning", "Verbose", "WriteLine", "Data", "Scope", "ExecutionFlow", "Assert" y "All". "All" es el valor predeterminado.
Los valores que se muestran a continuación son combinaciones de otros valores:
-- ExecutionFlow: (Constructor, Dispose, Finalizer, Method, Delegates, Events y Scope)
-- Data: (Constructor, Dispose, Finalizer, Property, Verbose y WriteLine)
-- Errors: (Error y Exception).
Para especificar varias opciones, separe los valores mediante comas (sin espacios) y escríbalos entre paréntesis, por ejemplo "Constructor,Dispose".
|
¿Requerido? |
false |
|
¿Posición? |
2 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-PassThru
Devuelve un objeto que representa la sesión de seguimiento. De forma predeterminada, este cmdlet no genera resultados.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-PSHost
Envía el resultado del seguimiento al host de Windows PowerShell. Este parámetro selecciona también el agente de escucha de seguimiento de PSHost.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-RemoveFileListener <string[]>
Detiene el seguimiento al eliminar el agente de escucha de archivos asociados al archivo especificado. Indique la ruta y el nombre del archivo de salida de seguimiento.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-RemoveListener <string[]>
Detiene el seguimiento al eliminar el agente de escucha de seguimiento.
Use los valores siguientes con RemoveListener:
-- Para eliminar PSHost (consola), escriba "Host".
-- Para eliminar Debugger, escriba "Debug".
-- Para eliminar todos los agentes de escucha de seguimiento, escriba "*".
Para eliminar el agente de escucha de seguimiento de archivos, use el parámetro RemoveFileListener.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar 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.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
System.String Puede canalizar una cadena que contiene un nombre a Set-TraceSource. |
|
Salidas |
Ninguno o System.Management.Automation.PSTraceSource Cuando se usa el parámetro PassThru, Set-TraceSource genera un objeto System.Management.Automation.PSTraceSource que representa la sesión de seguimiento. En caso contrario, este cmdlet no genera resultados. |
Notas
El seguimiento es un método que usan los programadores para depurar y refinar sus programas. Cuando se realiza un seguimiento, el programa genera mensajes detallados sobre cada paso de su procesamiento interno.
Los cmdlets de seguimiento de Windows PowerShell se han diseñado para ayudar a los programadores de Windows PowerShell, pero están a disposición de todos los usuarios. Estos cmdlets permiten supervisar prácticamente cualquier aspecto de la funcionalidad de Windows PowerShell.
Un "origen de seguimiento" es la parte de cada componente de Windows PowerShell que realiza el seguimiento y genera mensajes de seguimiento para el componente. Para efectuar el seguimiento de un documento, debe identificarse su origen de seguimiento.
Un "agente de escucha de seguimiento" recibe los resultados del seguimiento y los muestra al usuario. Puede optar por enviar los datos de seguimiento a un depurador de modo kernel o de modo usuario, a la consola, a un archivo o un agente de escucha personalizado derivado de la clase System.Diagnostics.TraceListener.
Para iniciar el seguimiento, use el parámetro Name para especificar un origen de seguimiento (el componente que se va a supervisar) y utilice los parámetros FilePath, Debugger o PSHost para especificar un agente de escucha (un destino para los resultados). Use el parámetro Options para determinar los tipos de eventos que serán objeto del seguimiento y el parámetro ListenerOptions para configurar los resultados del seguimiento.
Para modificar la configuración de una operación de seguimiento, especifique un comando Set-TraceSource tal y como lo haría para iniciar el seguimiento. Windows PowerShell reconoce que el origen de seguimiento ya está siendo supervisado. Por tanto, detiene la operación de seguimiento, agrega la nueva configuración e inicia o reinicia el seguimiento.
Para determina una operación de seguimiento, use el parámetro RemoveListener. Para detener una operación de seguimiento en que se usa el agente de escucha de archivos (un seguimiento iniciado mediante el parámetro -FilePath), use el parámetro RemoveFileListener. Cuando se elimina el agente de escucha, el seguimiento se interrumpe.
Para determinar qué componentes pueden someterse al seguimiento, 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 el resultado de Get-TraceSource.
Ejemplo 1
C:\PS>Set-TraceSource -Name Parameterbinding -Option ExecutionFlow -PSHost ' -ListenerOption "ProcessID,TimeStamp" Descripción ----------- Este comando inicia el seguimiento del componente ParameterBinding de Windows PowerShell. Use el parámetro Name para especificar el origen de seguimiento, el parámetro Option para seleccionar los eventos de seguimiento del flujo de ejecución y el parámetro PSHost para seleccionar el agente de escucha del host de Windows PowerShell, que envía el resultado a la consola. El parámetro ListenerOption agrega los valores "ProcessID" y "TimeStamp" al prefijo del mensaje de seguimiento.
Ejemplo 2
C:\PS>set-tracesource -name ParameterBinding -RemoveListener Host Descripción ----------- Este comando detiene el seguimiento del componente ParameterBinding de Windows PowerShell. Usa el parámetro Name para identificar el componente objeto del seguimiento y el parámetro RemoveListener para identificar el agente de escucha de seguimiento.
Vea también