Set-TraceSource
Nakonfiguruje, spustí a zastaví trasování komponent PowerShellu.
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
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 ExecutionFlow
událostí trasování a parametr PSHost k výběru naslouchacího procesu hostitele PowerShellu, který odešle výstup do konzoly. Parametr ListenerOption přidá ProcessID
hodnoty 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 removeListener parametr 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í.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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, pomocí parametru RemoveFileListener trasování zastavte.
Type: | String |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Označuje, že rutina přepíše soubor jen pro čtení. Použijte s parametrem FilePath .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ListenerOption
Určuje volitelná data pro předponu každé zprávy trasování ve výstupu. Tento parametr přijímá tyto hodnoty:
None
LogicalOperationStack
DateTime
Timestamp
ProcessId
ThreadId
Callstack
None
je výchozí možnost.
Tyto hodnoty jsou definovány jako výčet založený na příznaku. Pomocí tohoto parametru můžete zkombinovat více hodnot a nastavit více příznaků. Hodnoty lze předat do parametru ListenerOption 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 použít pro hodnoty dokončování tabulátoru.
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
Určuje, které komponenty jsou trasovány. Zadejte název zdroje trasování jednotlivých komponent. Jsou povoleny zástupné cardy.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Option
Určuje typ událostí, které jsou trasovány. Tento parametr přijímá tyto hodnoty:
None
Constructor
Dispose
Finalizer
Method
Property
Delegates
Events
Exception
Lock
Error
Errors
Warning
Verbose
WriteLine
Data
Scope
ExecutionFlow
Assert
All
All
je výchozí možnost.
Následující hodnoty jsou kombinace jiných hodnot:
ExecutionFlow
:Constructor
,Dispose
,Finalizer
, ,Method
,Delegates
,Events
Scope
Data
:Constructor
,Dispose
,Finalizer
,Property
, ,Verbose
,WriteLine
Errors
:Error
,Exception
Tyto hodnoty jsou definovány jako výčet založený na příznaku. 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 použít pro hodnoty dokončování tabulátoru.
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
Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PSHost
Označuje, že tato rutina odešle výstup trasování hostiteli PowerShellu. Tento parametr také vybere naslouchací proces trasování PSHost.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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í.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveListener
Zastaví trasování odebráním naslouchacího procesu trasování.
Použijte následující hodnoty s RemoveListener:
- Chcete-li odebrat PSHost (konzola), zadejte
Host
. - Chcete-li odebrat Ladicí program, zadejte
Debug
. - Chcete-li odebrat všechny naslouchací procesy trasování, zadejte
*
.
Pokud chcete odebrat naslouchací proces trasování souboru, použijte parametr RemoveFileListener .
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
Ř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.
Pokud použijete parametr PassThru , tato rutina vrátí 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 režimu uživatele nebo režimu jádra, do konzoly, do souboru nebo do vlastního naslouchacího procesu odvozeného z třídy System.Diagnostics.TraceListener .
Pokud chcete spustit trasování, pomocí parametru Name zadejte zdroj trasování a parametry FilePath, Debugger nebo 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 . Chcete-li zastavit trasování, které používá naslouchací proces souboru (trasování spuštěno 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
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro