Set-TraceSource

Modul:

Microsoft.PowerShell.Utility Module

Nakonfiguruje, spustí a zastaví trasování komponent PowerShellu.

Syntaxe

optionsSet (Výchozí)

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

Rutina Set-TraceSource nakonfiguruje, spustí a zastaví trasování komponenty PowerShellu. Můžete ho použít k určení, které komponenty budou trasovány a kde se odesílá výstup trasování.

Příklady

Příklad 1: Trasování komponenty ParameterBinding

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

Tento příkaz spustí trasování pro komponentu ParameterBinding PowerShellu. Pomocí parametru Name určuje zdroj trasování, parametr Option k výběru událostí trasování ExecutionFlow a parametr PSHost k výběru naslouchacího procesu hostitele PowerShellu, který odešle výstup do konzoly. Parametr listenerOption přidá hodnoty ProcessId a TimeStamp do předpony zprávy trasování.

Příklad 2: Zastavení trasování

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

Tento příkaz zastaví trasování komponenty ParameterBinding PowerShellu. Pomocí parametru Name identifikuje komponentu, která byla trasována, a parametr RemoveListener k identifikaci naslouchacího procesu trasování.

Parametry

-Debugger

Označuje, že rutina odešle výstup trasování do ladicího programu. Výstup můžete zobrazit v libovolném ladicím programu pro režim uživatele nebo v režimu jádra nebo v sadě Microsoft Visual Studio. Tento parametr také vybere výchozí naslouchací proces trasování.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

optionsSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FilePath

Určuje soubor, do kterého tato rutina odesílá výstup trasování. Tento parametr také vybere naslouchací proces trasování souboru. Pokud ke spuštění trasování použijete tento parametr, zastavte trasování pomocí parametru RemoveFileListener.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	PSPath, Cesta

Sady parametrů

optionsSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Force

Označuje, že rutina přepíše soubor jen pro čtení. Používá se s parametrem FilePath.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

optionsSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ListenerOption

Určuje volitelná data pro předponu každé zprávy trasování ve výstupu. Přijatelné hodnoty pro tento parametr jsou:

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

None je výchozí.

Tyto hodnoty jsou definovány jako výčtové hodnoty na bázi příznaků. Pomocí tohoto parametru můžete zkombinovat více hodnot a nastavit více příznaků. Hodnoty lze předat ListenerOption parametr jako pole hodnot nebo jako řetězec oddělený čárkami těchto hodnot. Rutina zkombinuje hodnoty pomocí binární operace OR. Předání hodnot jako pole je nejjednodušší možností a také umožňuje využít automatické doplňování pomocí klávesy Tab pro hodnoty.

Vlastnosti parametru

Typ:	TraceOptions
Default value:	None
Přípustné hodnoty:	None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

optionsSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

Určuje, které komponenty jsou trasovány. Zadejte název zdroje trasování jednotlivých komponent. Jsou povoleny zástupné symboly.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Option

Určuje typ událostí, které jsou trasovány. Přijatelné hodnoty pro tento parametr jsou:

• None
• Constructor
• Dispose
• Finalizer
• Method
• Property
• Delegates
• Events
• Exception
• Lock
• Error
• Errors
• Warning
• Verbose
• WriteLine
• Data
• Scope
• ExecutionFlow
• Assert
• All

None je výchozí.

Následující hodnoty jsou kombinace jiných hodnot:

• ExecutionFlow: Constructor, Dispose, Finalizer, , Method, Delegates, EventsScope
• Data: Constructor, Dispose, Finalizer, Property, , Verbose, WriteLine
• Errors: Error, Exception

Tyto hodnoty jsou definovány jako výčtové hodnoty na bázi příznaků. Pomocí tohoto parametru můžete zkombinovat více hodnot a nastavit více příznaků. Hodnoty lze předat parametru Option jako pole hodnot nebo jako řetězec oddělený čárkami těchto hodnot. Rutina zkombinuje hodnoty pomocí binární operace OR. Předání hodnot jako pole je nejjednodušší možností a také umožňuje využít automatické doplňování pomocí klávesy Tab pro hodnoty.

Vlastnosti parametru

Typ:	PSTraceSourceOptions
Default value:	None
Přípustné hodnoty:	None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

optionsSet

Position:	1
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-PassThru

Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

optionsSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PSHost

Označuje, že tato rutina odešle výstup trasování hostiteli PowerShellu. Tento parametr také vybere naslouchací proces trasování PSHost.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

optionsSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-RemoveFileListener

Zastaví trasování odebráním naslouchacího procesu trasování souboru přidruženého k zadanému souboru. Zadejte cestu a název souboru výstupního souboru trasování.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

removeFileListenersSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-RemoveListener

Zastaví trasování odebráním naslouchacího procesu trasování.

Pro RemoveListener použijte následující hodnoty:

• Chcete-li odebrat PSHost (konzola), zadejte Host.
• Chcete-li odebrat Ladicí program, zadejte Debug.
• Pokud chcete odebrat všechny naslouchací procesy trasování, zadejte *.

Pokud chcete odebrat naslouchací proces trasování souboru, použijte parametr RemoveFileListener.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

removeAllListenersSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Řetězec, který obsahuje název této rutiny, můžete převést.

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

PSTraceSource

Pokud použijete parametr PassThru, vrátí tato rutina objekt PSTraceSource představující relaci trasování.

Poznámky

• Trasování je metoda, kterou vývojáři používají k ladění a upřesňování programů. Při trasování program generuje podrobné zprávy o jednotlivých krocích jeho interního zpracování.

  Rutiny trasování PowerShellu jsou navržené tak, aby pomohly vývojářům PowerShellu, ale jsou dostupné všem uživatelům. Umožňují monitorovat téměř všechny aspekty funkcí PowerShellu.

  Zdroj trasování je součástí každé komponenty PowerShellu, která spravuje trasování a generuje trasovací zprávy pro danou komponentu. Pokud chcete trasovat komponentu, identifikujete její zdroj trasování.

  Naslouchací proces trasování obdrží výstup trasování a zobrazí ho uživateli. Můžete se rozhodnout odeslat data trasování do ladicího programu v uživatelském režimu nebo do konzoly, do souboru nebo do vlastního naslouchacího procesu odvozeného z System.Diagnostics.TraceListener třídy.

• Pokud chcete spustit trasování, pomocí parametru Name určete zdroj trasování a FilePath, ladicí programnebo parametry PSHost k určení naslouchacího procesu (cíl výstupu). Pomocí parametru Options určete typy událostí, které jsou trasovány, a parametr ListenerOption ke konfiguraci výstupu trasování.

• Pokud chcete změnit konfiguraci trasování, zadejte Set-TraceSource příkaz tak, jak byste spustili trasování. PowerShell rozpozná, že zdroj trasování je již trasován. Zastaví trasování, přidá novou konfiguraci a spustí nebo restartuje trasování.

• Trasování zastavíte pomocí parametru RemoveListener. Pokud chcete zastavit trasování, které používá naslouchací proces souboru (trasování spuštěné pomocí parametru FilePath), použijte parametr RemoveFileListener. Když naslouchací proces odeberete, trasování se zastaví.

• K určení komponent, které lze trasovat, použijte Get-TraceSource. Zdroje trasování pro každý modul se načtou automaticky při použití komponenty a zobrazí se ve výstupu Get-TraceSource.

Související odkazy

• Get-TraceSource
• Trace-Command