Set-TraceSource

  • Referens
Modul:
Microsoft.PowerShell.Utility

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 parameterbindningskomponenten

Set-TraceSource -Name "ParameterBinding" -Option ExecutionFlow -PSHost -ListenerOption "ProcessId,TimeStamp"

Det här kommandot börjar spåra komponenten ParameterBinding i PowerShell. Den använder parametern Name för att ange spårningskällan, parametern Alternativ för att välja ExecutionFlow spårningshändelser och parametern PSHost 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

Set-TraceSource -Name "ParameterBinding" -RemoveListener "Host"

Det här kommandot stoppar spårningen av ParameterBinding komponenten i PowerShell. Den använder parametern Name 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ökningsprogrammet. Du kan visa utdata i valfritt felsökningsprogram i användarläge eller kernelläge eller i Microsoft 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

-FilePath

Anger en fil som den här cmdleten skickar spårningsutdata till. Den här parametern väljer också lyssnaren för filspårning. 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.

Typ:String
Alias:PSPath, Path
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Anger att cmdleten skriver över en skrivskyddad fil. Använd med parametern FilePath.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ListenerOption

Anger valfria data till prefixet för varje spårningsmeddelande i utdata. De godtagbara värdena för den här parametern är:

  • None
  • LogicalOperationStack
  • DateTime
  • Timestamp
  • ProcessId
  • ThreadId
  • Callstack

None är 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 vilka komponenter som spåras. Ange namnet på spårningskällan för varje komponent. Jokertecken tillåts.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-Option

Anger vilken typ av händelser som spåras. De godtagbara 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 är 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:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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ökningsprogrammet 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.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Du kan skicka en sträng som innehåller ett namn till den här cmdleten.

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

PSTraceSource

När du använder parametern PassThru returnerar den här cmdleten ett PSTraceSource- objekt som representerar spårningssessionen.

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 låter dig ö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 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 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 Name för att ange en spårningskälla och parametrarna FilePath, Debuggereller 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 av 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.