Sdílet prostřednictvím

Set-TraceSource

  • Reference
Modul:
Microsoft.PowerShell.Utility

Konfiguruje, spouští a zastavuje 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 kam se bude výstup trasování odesílat.

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. Používá parametr Name k určení zdroje trasování, parametr Option pro výběr událostí trasování ExecutionFlow a parametr PSHost k výběru naslouchacího procesu hostitele PowerShellu, který odesílá 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 v PowerShellu. Používá parametr Name k identifikaci komponenty, která byla trasována, a removeListener parametr k identifikaci trasovacího naslouchacího procesu.

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 v uživatelském režimu 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:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilePath

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

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:

  • Žádné
  • LogicalOperationStack
  • DateTime
  • Timestamp
  • Processid
  • ThreadId
  • 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".

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í každé komponenty. Jsou povoleny zástupné y.

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:

  • Žádné
  • Konstruktor
  • Dispose
  • Finalizační
  • Metoda
  • Vlastnost
  • Delegáty
  • Události
  • Výjimka
  • Lock
  • Chyba
  • Chyby
  • Upozornění
  • Verbose
  • WriteLine
  • Data
  • Obor
  • ExecutionFlow
  • Assert
  • Vše

Vše je výchozí.

Následující hodnoty jsou kombinace další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".

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

ndá, že tato rutina odešle výstup trasování do hostitele PowerShellu. Tento parametr také vybere trasovací naslouchací proces 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 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í.

V nástroji RemoveListener použijte následující hodnoty:

  • Pokud chcete odebrat PSHost (konzolu), zadejte Host.
  • Pokud chcete odebrat ladicí program, zadejte Debug.
  • Pokud chcete odebrat všechny naslouchací procesy trasování, zadejte *.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

String

Řetězec, který obsahuje název, můžete nasměrovat na Set-TraceSource.

Výstupy

None or System.Management.Automation.PSTraceSource

Při použití parametru PassThruSet-TraceSource vygeneruje objekt System.Management.Automation.PSTraceSource představující relaci trasování. V opačném případě tato rutina 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 v jeho interním zpracování.

    Rutiny trasování PowerShellu jsou navržené tak, aby pomáhaly 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 zprávy trasování pro komponentu. Pokud chcete trasovat komponentu, identifikujte její zdroj trasování.

    Naslouchací proces trasování přijme výstup trasování a zobrazí ho uživateli. Můžete se rozhodnout odesílat data trasování do ladicího programu v uživatelském režimu 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í, použijte parametr Name k zadání zdroje trasování a parametry FilePath, Debugger nebo PSHost k zadání 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 , stejně jako byste spustili trasování. PowerShell rozpozná, že zdroj trasování se už trasuje. Zastaví trasování, přidá novou konfiguraci a spustí nebo restartuje trasování.

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

  • Pokud chcete zjistit, které komponenty lze trasovat, použijte Get-TraceSource. Zdroje trasování pro každý modul se načtou automaticky, když se komponenta používá, a zobrazí se ve výstupu Get-TraceSource.