Set-TraceSource
Nakonfiguruje, spustí a zastaví trasování komponent PowerShellu.
Syntax
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 konfiguruje, 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
PS C:\> 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í
PS C:\> 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: | False |
| 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 |
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:
- Žádné
- Logický zásobník operací
- Datum a čas
- Časová značka
- Id procesu
- ThreadId
- Acka volání
Výchozí hodnota není žádná.
Pokud chcete zadat více možností, oddělte je čárkami, ale bez mezer a uzavřete je do uvozovek, například "ProcessID,ThreadID".
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:
- Žádné
- Konstruktor
- Zničit
- Finalizátor
- Metoda
- Vlastnictví
- Delegáti
- Události
- Výjimka
- Lock
- Chyba
- Chyby
- Výstraha
- Zdlouhavý
- WriteLine
- Údaje
- Scope
- Tok provedení
- Tvrdit
- Všechno
Vše je výchozí.
Následující hodnoty jsou kombinace jiných hodnot:
- ExecutionFlow: (konstruktor, Dispose, Finalizer, Method, Delegates, Events a Scope)
- Data: (Konstruktor, Dispose, Finalizer, Property, Verbose a WriteLine)
- Chyby: (chyba a výjimka).
Pokud chcete zadat více možností, oddělte je čárkami, ale bez mezer a uzavřete je do uvozovek, například "Konstruktor,Dispose".
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
ndikuje, že tato rutina odesílá 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, můžete Set-TraceSource.
Výstupy
None or System.Management.Automation.PSTraceSource
Pokud použijete parametr PassThru, Set-TraceSource vygeneruje System.Management.Automation.PSTraceSource objekt představující relaci trasování. Jinak tento příkaz negeneruje žádný výstup.
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 příkaz Set-TraceSource 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.