Trace-Command
Nakonfiguruje a spustí trasování zadaného výrazu nebo příkazu.
Syntax
expressionSet (Výchozí)
Trace-Command
[-Name] <String[]>
[-Expression] <ScriptBlock>
[[-Option] <PSTraceSourceOptions>]
[-InputObject <PSObject>]
[-ListenerOption <TraceOptions>]
[-FilePath <String>]
[-Force]
[-Debugger]
[-PSHost]
[<CommonParameters>]
commandSet
Trace-Command
[-Name] <String[]>
[-Command] <String>
[[-Option] <PSTraceSourceOptions>]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[-ListenerOption <TraceOptions>]
[-FilePath <String>]
[-Force]
[-Debugger]
[-PSHost]
[<CommonParameters>]
Description
Rutina Trace-Command nakonfiguruje a spustí trasování zadaného výrazu nebo příkazu. Funguje jako Set-TraceSource s tím rozdílem, že se vztahuje pouze na zadaný příkaz.
Příklady
Příklad 1: Trasování zpracování metadat, vazby parametrů a výrazu
PS C:\> Trace-Command -Name metadata,parameterbinding,cmdlet -Expression {Get-Process Notepad} -PSHost
Tento příkaz spustí trasování zpracování metadat, vazby parametrů a vytváření rutin a zničení výrazu Get-Process Notepad.
Pomocí parametru Name určuje zdroje trasování, parametr Expression k zadání příkazu a parametr PSHost k odeslání výstupu do konzoly.
Vzhledem k tomu, že nezadá žádné možnosti trasování nebo možnosti naslouchacího procesu, příkaz použije výchozí nastavení -All pro možnosti trasování a Žádné pro možnosti naslouchacího procesu.
Příklad 2: Trasování akcí operací ParameterBinding
PS C:\> $A = "i*"
PS C:\> Trace-Command ParameterBinding {Get-Alias $Input} -PSHost -InputObject $A
Tyto příkazy trasují akce operací ParameterBinding windows PowerShellu, zatímco zpracovává výraz Get-Alias, který přijímá vstup z kanálu.
V Trace-Command, InputObject parametr předává objekt výrazu, který se zpracovává během trasování.
První příkaz uloží řetězec "i*" do proměnné $A. Druhý příkaz používá rutinu Trace-Command se zdrojem trasování ParameterBinding. Parametr PSHost odešle výstup do konzoly.
Zpracovávaný výraz je Get-Alias $Input, kde $Input proměnná je přidružena k parametru InputObject.
Parametr InputObject předá proměnnou $A výrazu.
Příkaz, který se zpracovává během trasování, je Get-Alias -InputObject $A" or "$A | Get-Alias.
Parametry
-ArgumentList
Určuje parametry a hodnoty parametrů pro trasovaný příkaz. Alias pro ArgumentList je Args. Tato funkce je zvlášť užitečná pro ladění dynamických parametrů.
Vlastnosti parametru
| Typ: | Object[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Argumenty |
Sady parametrů
commandSet
| 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 |
-Command
Určuje příkaz, který se zpracovává během trasování.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
commandSet
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-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ě 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ů
(All)
| 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 |
-Expression
Určuje výraz, který se zpracovává během trasování. Uzavřete výraz do složených závorek ({}).
Vlastnosti parametru
| Typ: | ScriptBlock |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
expressionSet
| Position: | 1 |
| Povinné: | True |
| 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 rutina odesílá výstup trasování. Tento parametr také vybere naslouchací proces trasování souboru.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
(All)
| 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
Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele. Používá se s parametrem FilePath. I při použití parametru Force nemůže rutina přepsat omezení zabezpečení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| 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 |
-InputObject
Určuje vstup do výrazu, který se zpracovává během trasování.
Můžete zadat proměnnou, která představuje vstup, který výraz přijímá, nebo předat objekt přes kanál.
Vlastnosti parametru
| Typ: | PSObject |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| 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ů
(All)
| 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 pole komponent Windows PowerShellu, které jsou trasovány.
Zadejte název zdroje trasování jednotlivých komponent.
Jsou povoleny zástupné symboly.
Chcete-li najít zdroje trasování v počítači, zadejte Get-TraceSource.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| 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ů
(All)
| Position: | 2 |
| 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 rutina odešle výstup trasování hostiteli Windows 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ů
(All)
| 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
PSObject
Objekty, které představují vstup do výrazu, lze Trace-Command .
Výstupy
PSObject
Vrátí trasování příkazů v ladicím streamu.
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í Prostředí Windows PowerShell jsou navržené tak, aby pomohly vývojářům windows PowerShellu, ale jsou dostupné všem uživatelům. Umožňují vám monitorovat téměř všechny aspekty funkčnosti prostředí.
Chcete-li najít součásti prostředí Windows PowerShell, které jsou povoleny pro trasování, zadejte
Get-Help Get-TraceSource.Zdroj trasování je součástí každé komponenty Windows PowerShellu, která spravuje trasování a generuje zprávy trasování 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 režimu jádra, do hostitele nebo konzoly, do souboru nebo do vlastního naslouchacího procesu odvozeného z System.Diagnostics.TraceListener třídy.
Když použijete sadu parametrů commandSet, Windows PowerShell zpracuje příkaz stejně, jako by se zpracovával v kanálu. Například zjišťování příkazů se u každého příchozího objektu neopakuje.
Názvy Name, Expression, Optiona Command parametry jsou volitelné. Pokud vynecháte názvy parametrů, musí se hodnoty nepojmenovaných parametrů zobrazovat v tomto pořadí: Název, Výraz, možnost nebo Název, Příkaz, Možnost. Pokud zahrnete názvy parametrů, můžou se parametry zobrazit v libovolném pořadí.