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

De Trace-Command-cmdlet configureert en start een tracering van de opgegeven expressie of opdracht. Het werkt net als Set-TraceSource, behalve dat deze alleen van toepassing is op de opgegeven opdracht.

In dit voorbeeld wordt een tracering gestart van metagegevensverwerking, parameterbinding en het maken en vernietigen van de Get-Process Notepad-expressie.

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

Hierbij wordt de parameter Name gebruikt om de traceringsbronnen, de Expression parameter op te geven om de opdracht op te geven en de parameter PSHost om de uitvoer naar de console te verzenden. Omdat er geen traceringsopties of listeneropties worden opgegeven, gebruikt de opdracht de standaardinstellingen:

• Alles voor de traceringsopties
• Geen voor de listeneropties

In dit voorbeeld worden de acties van de ParameterBinding bewerkingen van PowerShell bij de verwerking van een Get-Alias-expressie die invoer uit de pijplijn neemt.

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

In Trace-Commandgeeft de parameter InputObject een object door aan de expressie die tijdens de tracering wordt verwerkt.

Met de eerste opdracht wordt de tekenreeks i* opgeslagen in de variabele $A. De tweede opdracht maakt gebruik van de Trace-Command cmdlet met de ParameterBinding-traceringsbron. De parameter PSHost verzendt de uitvoer naar de console.

De expressie die wordt verwerkt, wordt Get-Alias $input, waarbij de variabele $input is gekoppeld aan de parameter InputObject. De parameter InputObject geeft de variabele $A door aan de expressie. In feite wordt de opdracht die tijdens de tracering wordt verwerkt, Get-Alias -InputObject $A" or "$A | Get-Alias.

PowerShell 7.3 heeft de mogelijkheid toegevoegd om parameterbinding te traceren voor systeemeigen opdrachten. In het volgende voorbeeld ziet u hoe PowerShell de opdrachtregelargumenten parseert voor de systeemeigen opdracht 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

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt objecten doorsluisen die invoer voor de expressie voor deze cmdlet vertegenwoordigen.

Deze cmdlet retourneert geen eigen uitvoer. De traceringsopdracht kan uitvoer retourneren. Met deze cmdlet wordt de opdrachttracering naar de foutopsporingsstroom geschreven.

Tracering is een methode die ontwikkelaars gebruiken om programma's op te sporen en te verfijnen. Bij het traceren genereert het programma gedetailleerde berichten over elke stap in de interne verwerking. De PowerShell-tracerings-cmdlets zijn ontworpen om PowerShell-ontwikkelaars te helpen, maar ze zijn beschikbaar voor alle gebruikers. Hiermee kunt u vrijwel elk aspect van de functionaliteit van de shell bewaken.

Een traceringsbron is het onderdeel van elk PowerShell-onderdeel dat tracering beheert en traceringsberichten genereert voor het onderdeel. Als u een onderdeel wilt traceren, identificeert u de bijbehorende traceringsbron.

Gebruik Get-TraceSource om een lijst weer te geven met PowerShell-onderdelen die zijn ingeschakeld voor tracering.

Een traceerlistener ontvangt de uitvoer van de tracering en geeft deze weer aan de gebruiker. U kunt ervoor kiezen om de traceringsgegevens te verzenden naar een foutopsporingsprogramma in de gebruikersmodus of kernelmodus, naar de host of console, naar een bestand of naar een aangepaste listener die is afgeleid van de System.Diagnostics.TraceListener--klasse.