Trace-Command

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

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

Cmdleten Trace-Command konfigurerar och startar en spårning av det angivna uttrycket eller kommandot. Det fungerar som Set-TraceSource, förutom att det endast gäller för det angivna kommandot.

Det här exemplet startar en spårning av metadatabearbetning, parameterbindning och cmdlet-skapande och destruktion av Get-Process Notepad-uttrycket.

Trace-Command -Name Metadata, ParameterBinding, Cmdlet -Expression {Get-Process Notepad} -PSHost

Den använder parametern Name för att ange spårningskällorna, parametern Expression för att ange kommandot och parametern PSHost för att skicka utdata till konsolen. Eftersom det inte anger några spårningsalternativ eller lyssnaralternativ använder kommandot standardvärdena:

• Allt för spårningsalternativen
• Ingen för lyssnaralternativen

Det här exemplet spårar åtgärderna i ParameterBinding åtgärder i PowerShell medan det bearbetar ett Get-Alias uttryck som tar indata från pipelinen.

$A = "i*"
Trace-Command ParameterBinding {Get-Alias $input} -PSHost -InputObject $A

I Trace-Commandskickar parametern InputObject ett objekt till uttrycket som bearbetas under spårningen.

Det första kommandot lagrar strängen i* i variabeln $A. Det andra kommandot använder cmdleten Trace-Command med ParameterBinding-spårningskällan. Parametern PSHost skickar utdata till konsolen.

Uttrycket som bearbetas är Get-Alias $input, där variabeln $input är associerad med parametern InputObject. Parametern InputObject skickar variabeln $A till uttrycket. I själva verket bearbetas kommandot under spårningen Get-Alias -InputObject $A" or "$A | Get-Alias.

PowerShell 7.3 har lagt till möjligheten att spåra parameterbindning för interna kommandon. I följande exempel visas hur PowerShell parsar kommandoradsargumenten för det interna kommandot TestExe.

$a = 'a" "b'
Trace-Command -PSHOST -Name ParameterBinding { TestExe -echoargs $a 'c" "d' e" "f }

DEBUG: 2023-02-27 14:20:45.3975 ParameterBinding Information: 0 : BIND NAMED native application line args [C:\Public\Toolbox\TestExe\testexe.exe]
DEBUG: 2023-02-27 14:20:45.3978 ParameterBinding Information: 0 :     BIND cmd line arg [-echoargs] to position [0]
DEBUG: 2023-02-27 14:20:45.3979 ParameterBinding Information: 0 :     BIND cmd line arg [a" "b] to position [1]
DEBUG: 2023-02-27 14:20:45.3980 ParameterBinding Information: 0 :     BIND cmd line arg [c" "d] to position [2]
DEBUG: 2023-02-27 14:20:45.3982 ParameterBinding Information: 0 :     BIND cmd line arg [e f] to position [3]
DEBUG: 2023-02-27 14:20:47.6092 ParameterBinding Information: 0 : CALLING BeginProcessing

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka pipe-objekt som representerar indata till uttrycket till den här cmdleten.

Den här cmdleten returnerar inga egna utdata. Det spårade kommandot kan returnera utdata. Den här cmdleten skriver kommandospårningen till felsökningsströmmen.

Spårning är en metod som utvecklare använder för att felsöka och förfina program. När du spårar genererar programmet detaljerade meddelanden om varje steg i den interna bearbetningen. PowerShell-cmdletarna för spårning är utformade för att hjälpa PowerShell-utvecklare, men de är tillgängliga för alla användare. De gör att du kan övervaka nästan alla aspekter av gränssnittets funktioner.

En spårningskälla är den del av varje PowerShell-komponent som hanterar spårning och genererar spårningsmeddelanden för komponenten. Om du vill spåra en komponent identifierar du dess spårningskälla.

Använd Get-TraceSource för att se en lista över PowerShell-komponenter som är aktiverade för spårning.

En spårningslyssnare tar emot utdata från spårningen och visar den för användaren. Du kan välja att skicka spårningsdata till ett felsökningsprogram i användarläge eller kernelläge, till värden eller konsolen, till en fil eller till en anpassad lyssnare som härletts från klassen System.Diagnostics.TraceListener.