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

O cmdlet Trace-Command configura e inicia um rastreamento da expressão ou comando especificado. Ele funciona como Set-TraceSource, exceto que se aplica apenas ao comando especificado.

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

Este comando inicia um rastreamento de processamento de metadados, associação de parâmetros e criação e destruição de cmdlets da Get-Process Notepad expressão. Ele usa o parâmetro Name para especificar as fontes de rastreamento, o parâmetro Expression para especificar o comando e o parâmetro PSHost para enviar a saída para o console. Como ele não especifica nenhuma opção de rastreamento ou opção de ouvinte, o comando usa os padrões--All para as opções de rastreamento e Nenhum para as opções de ouvinte.

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

Esses comandos rastreiam as ações das operações ParameterBinding do Windows PowerShell enquanto ele processa uma expressão Get-Alias que recebe entrada do pipeline.

Em Trace-Command, o parâmetro InputObject passa um objeto para a expressão que está sendo processada durante o rastreamento.

O primeiro comando armazena a string "i*" na variável $A. O segundo comando usa o cmdlet Trace-Command com a origem de rastreamento ParameterBinding. O parâmetro PSHost envia a saída para o console.

A expressão que está sendo processada é Get-Alias $Input, onde a variável $Input está associada ao parâmetro InputObject . O parâmetro InputObject passa a variável $A para a expressão. Com efeito, o comando que está sendo processado durante o rastreamento é Get-Alias -InputObject $A" or "$A | Get-Alias.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Você pode canalizar objetos que representam a entrada para a expressão para Trace-Command.

Retorna o rastreamento de comando no fluxo de depuração.

• O rastreamento é um método que os desenvolvedores usam para depurar e refinar programas. Ao rastrear, o programa gera mensagens detalhadas sobre cada etapa de seu processamento interno.

• Os cmdlets de rastreamento do Windows PowerShell foram projetados para ajudar os desenvolvedores do Windows PowerShell, mas estão disponíveis para todos os usuários. Eles permitem que você monitore quase todos os aspetos da funcionalidade do shell.

• Para localizar os componentes do Windows PowerShell habilitados para rastreamento, digite Get-Help Get-TraceSource.

  Uma fonte de rastreamento é a parte de cada componente do Windows PowerShell que gerencia o rastreamento e gera mensagens de rastreamento para o componente. Para rastrear um componente, identifique sua origem de rastreamento.

  Um ouvinte de rastreamento recebe a saída do rastreamento e a exibe para o usuário. Você pode optar por enviar os dados de rastreamento para um depurador de modo de usuário ou kernel, para o host ou console, para um arquivo ou para um ouvinte personalizado derivado da classe System.Diagnostics.TraceListener.

• Quando você usa o conjunto de parâmetros commandSet, o Windows PowerShell processa o comando da mesma forma que seria processado em um pipeline. Por exemplo, a descoberta de comandos não é repetida para cada objeto de entrada.

• Os nomes dos parâmetros Name, Expression, Option e Command são opcionais. Se você omitir os nomes dos parâmetros, os valores de parâmetros sem nome deverão aparecer nesta ordem: Name, Expression, Option ou Name, Command, Option. Se você incluir os nomes dos parâmetros, os parâmetros poderão aparecer em qualquer ordem.