Sdílet prostřednictvím

Set-TraceSource

  • Reference
Modul:
Microsoft.PowerShell.Utility

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

Syntaxe

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Aliasy:PSPath
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:TraceOptions
Přípustné hodnoty:None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

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

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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

None je výchozí možnost.

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

Typ:PSTraceSourceOptions
Přípustné hodnoty: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
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PSHost

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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í.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 .

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

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