Set-TraceSource

Syntax

optionsSet (Standard)

Set-TraceSource
    [-Name] <String[]>
    [[-Option] <PSTraceSourceOptions>]
    [-ListenerOption <TraceOptions>]
    [-FilePath <String>]
    [-Force]
    [-Debugger]
    [-PSHost]
    [-PassThru]
    [<CommonParameters>]

removeAllListenersSet

Set-TraceSource
    [-Name] <String[]>
    [-RemoveListener <String[]>]
    [<CommonParameters>]

removeFileListenersSet

Set-TraceSource
    [-Name] <String[]>
    [-RemoveFileListener <String[]>]
    [<CommonParameters>]

Description

Exempel

Exempel 1: Spåra parameterbindningskomponenten

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

Exempel 2: Stoppa en spårning

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

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.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-Force

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

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-Name

Anger vilka komponenter som spåras. Ange namnet på spårningskällan för varje komponent. Jokertecken tillåts.

Parameteregenskaper

Parameteruppsättningar

-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

None används som standard.

Följande värden är kombinationer av andra värden:

• ExecutionFlow: Constructor, Dispose, Finalizer, Method, , Delegates, , EventsScope
• 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.

Parameteregenskaper

Parameteruppsättningar

-PassThru

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

Parameteregenskaper

Parameteruppsättningar

-PSHost

Anger att den här cmdleten skickar spårningsutdata till PowerShell-värden. Den här parametern väljer även PSHost-spårningslyssnaren.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

String

Utdata

None

PSTraceSource

Kommentarer

Relaterade länkar

• Get-TraceSource
• Trace-Command