Set-TraceSource
Konfigurerar, startar och stoppar en spårning av PowerShell-komponenter.
Syntax
Set-TraceSource
[-Name] <String[]>
[[-Option] <PSTraceSourceOptions>]
[-ListenerOption <TraceOptions>]
[-FilePath <String>]
[-Force]
[-Debugger]
[-PSHost]
[-PassThru]
[<CommonParameters>]
Set-TraceSource
[-Name] <String[]>
[-RemoveListener <String[]>]
[<CommonParameters>]
Set-TraceSource
[-Name] <String[]>
[-RemoveFileListener <String[]>]
[<CommonParameters>]
Description
Cmdleten Set-TraceSource konfigurerar, startar och stoppar en spårning av en PowerShell-komponent. Du kan använda den för att ange vilka komponenter som ska spåras och var spårningsutdata skickas.
Exempel
Exempel 1: Spåra ParameterBinding-komponenten
PS C:\> Set-TraceSource -Name "ParameterBinding" -Option ExecutionFlow -PSHost -ListenerOption "ProcessId,TimeStamp"
Det här kommandot börjar spåra ParameterBinding-komponenten i PowerShell. Den använder parametern Namn för att ange spårningskällan, parametern Alternativ för att välja körningsflödesspårningshändelser och PSHost-parametern för att välja PowerShell-värdlyssnaren, som skickar utdata till konsolen. Parametern ListenerOption lägger till värdena ProcessID och TimeStamp i prefixet för spårningsmeddelandet.
Exempel 2: Stoppa en spårning
PS C:\> Set-TraceSource -Name "ParameterBinding" -RemoveListener "Host"
Det här kommandot stoppar spårningen av ParameterBinding-komponenten i PowerShell. Den använder parametern Namn för att identifiera komponenten som spårades och parametern RemoveListener för att identifiera spårningslyssnaren.
Parametrar
-Debugger
Anger att cmdleten skickar spårningsutdata till felsökaren. Du kan visa utdata i valfritt felsökningsprogram för användarläge eller kernelläge eller i Microsoft Visual Studio. Den här parametern väljer också standardspårningslyssnaren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FilePath
Anger en fil som den här cmdleten skickar spårningsutdata till. Den här parametern väljer även filspårningslyssnaren. Om du använder den här parametern för att starta spårningen använder du parametern RemoveFileListener för att stoppa spårningen.
Type: | String |
Aliases: | PSPath, Path |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Anger att cmdleten skriver över en skrivskyddad fil. Använd med Parametern FilePath .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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:
- Ingen
- LogicalOperationStack
- DateTime
- Timestamp
- Processid
- ThreadId
- Samtalsstack
Ingen är standard.
Om du vill ange flera alternativ avgränsar du dem med kommatecken, men utan blanksteg och omger dem inom citattecken, till exempel "ProcessID,ThreadID".
Type: | TraceOptions |
Accepted values: | None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Anger vilka komponenter som spåras. Ange namnet på spårningskällan för varje komponent. Jokertecken tillåts.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Option
Anger vilken typ av händelser som spåras. De acceptabla värdena för den här parametern är:
- Ingen
- Konstruktor
- Kassera
- Slutför
- Metod
- Egenskap
- Delegeringar
- Händelser
- Undantag
- Låsa
- Fel
- Fel
- Varning
- Verbose
- WriteLine
- Data
- Omfång
- ExecutionFlow
- Assert
- Alla
Allt är standard.
Följande värden är kombinationer av andra värden:
- ExecutionFlow: (Konstruktor, Kassera, Slutför, Metod, Ombud, Händelser och Omfång)
- Data: (Konstruktor, Kassera, Slutför, Egenskap, Utförlig och WriteLine)
- Fel: (fel och undantag).
Om du vill ange flera alternativ avgränsar du dem med kommatecken, men utan blanksteg, och omger dem inom citattecken, till exempel "Konstruktor,Kassera".
Type: | PSTraceSourceOptions |
Accepted values: | None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet inga utdata.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PSHost
anger att den här cmdleten skickar spårningsutdata till PowerShell-värden. Den här parametern väljer även PSHost-spårningslyssnaren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveFileListener
Stoppar spårningen genom att ta bort den filspårningslyssnare som är associerad med den angivna filen. Ange sökvägen och filnamnet för spårningsutdatafilen.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveListener
Stoppar spårningen genom att ta bort spårningslyssnaren.
Använd följande värden med RemoveListener:
- Om du vill ta bort PSHost (konsol) skriver du
Host
. - Om du vill ta bort felsökaren skriver du
Debug
. - Om du vill ta bort alla spårningslyssnare skriver du
*
.
Om du vill ta bort filspårningslyssnaren använder du parametern RemoveFileListener .
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Du kan skicka en sträng som innehåller ett namn till Set-TraceSource.
Utdata
None or System.Management.Automation.PSTraceSource
När du använder parametern PassThru genererar Set-TraceSource ett System.Management.Automation.PSTraceSource-objekt som representerar spårningssessionen. Annars genererar den här cmdleten inga utdata.
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-spårnings-cmdletar ä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 funktionerna i PowerShell.
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.
En spårningslyssnare tar emot spårningens utdata och visar den för användaren. Du kan välja att skicka spårningsdata till en felsökare i användarläge eller kernelläge, till konsolen, till en fil eller till en anpassad lyssnare som härletts från klassen System.Diagnostics.TraceListener .
Om du vill starta en spårning använder du parametern Namn för att ange en spårningskälla och parametrarna FilePath, Debugger eller PSHost för att ange en lyssnare (ett mål för utdata). Använd parametern Alternativ för att fastställa vilka typer av händelser som spåras och parametern ListenerOption för att konfigurera spårningsutdata.
Om du vill ändra konfigurationen för en spårning anger du ett Set-TraceSource-kommando som du skulle göra för att starta en spårning. PowerShell identifierar att spårningskällan redan spåras. Den stoppar spårningen, lägger till den nya konfigurationen och startar eller startar om spårningen.
Om du vill stoppa en spårning använder du parametern RemoveListener . Om du vill stoppa en spårning som använder fillyssnaren (en spårning som startas med parametern FilePath ) använder du parametern RemoveFileListener . När du tar bort lyssnaren stoppas spårningen.
Om du vill ta reda på vilka komponenter som kan spåras använder du Get-TraceSource. Spårningskällorna för varje modul läses in automatiskt när komponenten används och de visas i utdata från Get-TraceSource.