Trace-Command
Konfigurerar och startar en spårning av det angivna uttrycket eller kommandot.
Syntax
Trace-Command
[-InputObject <PSObject>]
[-Name] <String[]>
[[-Option] <PSTraceSourceOptions>]
[-Expression] <ScriptBlock>
[-ListenerOption <TraceOptions>]
[-FilePath <String>]
[-Force]
[-Debugger]
[-PSHost]
[<CommonParameters>]
Trace-Command
[-InputObject <PSObject>]
[-Name] <String[]>
[[-Option] <PSTraceSourceOptions>]
[-Command] <String>
[-ArgumentList <Object[]>]
[-ListenerOption <TraceOptions>]
[-FilePath <String>]
[-Force]
[-Debugger]
[-PSHost]
[<CommonParameters>]
Description
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.
Exempel
Exempel 1: Spåra metadatabearbetning, parameterbindning och ett uttryck
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 Namn för att ange spårningskällorna, parametern Uttryck 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
Exempel 2: Spåra åtgärderna för ParameterBinding-åtgärder
Det här exemplet spårar åtgärderna i ParameterBinding-åtgärderna 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-Command
skickar 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. PSHost-parametern 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 är Get-Alias -InputObject $A" or "$A | Get-Alias
kommandot som bearbetas under spårningen .
Exempel 3: SpårningsparameterBinding-åtgärder för interna kommandon
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
Parametrar
-ArgumentList
Anger parametrarna och parametervärdena för kommandot som spåras. Aliaset för ArgumentList är Args. Den här funktionen är användbar för felsökning av dynamiska parametrar.
Mer information om beteendet för ArgumentList finns i about_Splatting.
Typ: | Object[] |
Alias: | Args |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Command
Anger ett kommando som bearbetas under spårningen.
När du använder den här parametern bearbetar PowerShell kommandot precis som det skulle bearbetas i en pipeline. Till exempel upprepas inte kommandoidentifiering för varje inkommande objekt.
Typ: | String |
Position: | 1 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Debugger
Anger att cmdleten skickar spårningsutdata till felsökningsprogrammet. Du kan visa utdata i valfritt felsökningsprogram för användarläge eller kernelläge eller i Visual Studio. Den här parametern väljer också standardspårningslyssnaren.
Typ: | SwitchParameter |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Expression
Anger det uttryck som bearbetas under spårningen. Omslut uttrycket i klammerparenteser ({}
).
Typ: | ScriptBlock |
Position: | 1 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-FilePath
Anger en fil som cmdleten skickar spårningsutdata till. Den här parametern väljer också lyssnaren för filspårning.
Typ: | String |
Alias: | PSPath, Path |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse. Används med Parametern FilePath . Även med hjälp av force-parametern kan cmdleten inte åsidosätta säkerhetsbegränsningar.
Typ: | SwitchParameter |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-InputObject
Anger indata till uttrycket som bearbetas under spårningen. Du kan ange en variabel som representerar de indata som uttrycket accepterar eller skicka ett objekt via pipelinen.
Typ: | PSObject |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-ListenerOption
Anger valfria data till prefixet för varje spårningsmeddelande i utdata. De acceptabla värdena för den här parametern är:
None
LogicalOperationStack
DateTime
Timestamp
ProcessId
ThreadId
Callstack
None
används som standard.
Dessa värden definieras som en flaggbaserad uppräkning. Du kan kombinera flera värden för att ange flera flaggor med hjälp av den här parametern. Värdena kan skickas till parametern ListenerOption som en matris med värden eller som en kommaavgränsad sträng av dessa värden. Cmdleten kombinerar värdena med hjälp av en binär-OR-åtgärd. Att skicka värden som en matris är det enklaste alternativet och du kan även använda tab-completion på värdena.
Typ: | TraceOptions |
Godkända värden: | None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Name
Anger en matris med PowerShell-komponenter som spåras. Ange namnet på spårningskällan för varje komponent. Jokertecken tillåts. Om du vill hitta spårningskällorna på datorn skriver du Get-TraceSource
.
Typ: | String[] |
Position: | 0 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Option
Avgör vilken typ av händelser som spåras. De acceptabla värdena för den här parametern är:
None
Constructor
Dispose
Finalizer
Method
Property
Delegates
Events
Exception
Lock
Error
Errors
Warning
Verbose
WriteLine
Data
Scope
ExecutionFlow
Assert
All
All
används som standard.
Följande värden är kombinationer av andra värden:
ExecutionFlow
:Constructor
,Dispose
,Finalizer
,Method
, ,Delegates
, ,Events
Scope
Data
:Constructor
,Dispose
,Finalizer
,Property
, ,Verbose
,WriteLine
Errors
:Error
,Exception
Dessa värden definieras som en flaggbaserad uppräkning. Du kan kombinera flera värden för att ange flera flaggor med hjälp av den här parametern. Värdena kan skickas till parametern Alternativ som en matris med värden eller som en kommaavgränsad sträng av dessa värden. Cmdleten kombinerar värdena med hjälp av en binär-OR-åtgärd. Att skicka värden som en matris är det enklaste alternativet och du kan även använda tab-completion på värdena.
Typ: | PSTraceSourceOptions |
Godkända värden: | None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All |
Position: | 2 |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-PSHost
Anger att cmdleten skickar spårningsutdata till PowerShell-värden. Den här parametern väljer även PSHost-spårningslyssnaren.
Typ: | SwitchParameter |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
Indata
Du kan skicka pipe-objekt som representerar indata till uttrycket till den här cmdleten.
Utdata
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.
Kommentarer
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 .
Relaterade länkar
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för