Trace-Command

Trace-Command
    [-Name] <String[]>
    [-Expression] <ScriptBlock>
    [[-Option] <PSTraceSourceOptions>]
    [-InputObject <PSObject>]
    [-ListenerOption <TraceOptions>]
    [-FilePath <String>]
    [-Force]
    [-Debugger]
    [-PSHost]
    [<CommonParameters>]

Trace-Command
    [-Name] <String[]>
    [-Command] <String>
    [[-Option] <PSTraceSourceOptions>]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [-ListenerOption <TraceOptions>]
    [-FilePath <String>]
    [-Force]
    [-Debugger]
    [-PSHost]
    [<CommonParameters>]

El cmdlet Trace-Command configura e inicia un seguimiento de la expresión o comando especificados. Funciona como Set-TraceSource, salvo que solo se aplica al comando especificado.

PS C:\> Trace-Command -Name metadata,parameterbinding,cmdlet -Expression {Get-Process Notepad} -PSHost

Este comando inicia un seguimiento del procesamiento de metadatos, el enlace de parámetros y la creación y destrucción de cmdlets de la expresión Get-Process Notepad. Usa el parámetro Name para especificar los orígenes de seguimiento, el parámetro Expression para especificar el comando y el parámetro PSHost para enviar la salida a la consola. Dado que no especifica ninguna opción de seguimiento o opciones del agente de escucha, el comando usa el valor predeterminado:-All para las opciones de seguimiento y Ninguno para las opciones del agente de escucha.

PS C:\> $A = "i*"
PS C:\> Trace-Command ParameterBinding {Get-Alias $Input} -PSHost -InputObject $A

Estos comandos trazan las acciones de las operaciones ParameterBinding de Windows PowerShell mientras procesa una expresión Get-Alias que toma la entrada de la canalización.

En Trace-Command, el parámetro InputObject pasa un objeto a la expresión que se está procesando durante el seguimiento.

El primer comando almacena la cadena "i*" en la variable $A. El segundo comando usa el cmdlet Trace-Command con el origen de seguimiento ParameterBinding. El parámetro PSHost de envía la salida a la consola.

La expresión que se procesa es Get-Alias $Input, donde la variable $Input está asociada al parámetro InputObject. El parámetro InputObject pasa la variable $A a la expresión. En efecto, el comando que se está procesando durante el seguimiento es Get-Alias -InputObject $A" or "$A | Get-Alias.

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 objetos que representan la entrada a la expresión para trace-Command.

Devuelve el seguimiento del comando en el flujo de depuración.

• 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 Windows PowerShell están diseñados para ayudar a los desarrolladores de Windows PowerShell, pero están disponibles para todos los usuarios. Permiten supervisar casi todos los aspectos de la funcionalidad del shell.

• Para buscar los componentes de Windows PowerShell que están habilitados para el seguimiento, escriba Get-Help Get-TraceSource.

  Un origen de seguimiento es la parte de cada componente de Windows 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, al host o la consola, a un archivo o a un agente de escucha personalizado derivado de la clase System.Diagnostics.TraceListener.

• Cuando se usa el conjunto de parámetros commandSet, Windows PowerShell procesa el comando igual que se procesaría en una canalización. Por ejemplo, la detección de comandos no se repite para cada objeto entrante.

• Los nombres de los parámetros Name, Expression, Optiony Command son opcionales. Si omite los nombres de parámetro, los valores de parámetro sin nombre deben aparecer en este orden: Name, Expression, Option o Name, Command, Option. Si incluye los nombres de parámetro, los parámetros pueden aparecer en cualquier orden.