Trace-Command

Trace-Command [-Command] <string> [-ArgumentList <Object[]>] [-Name] <string[]> [[-Option] {<None> | <Constructor> | <Dispose> | <Finalizer> | <Method> | <Property> | <Delegates> | <Events> | <Exception> | <Lock> | <Error> | <Errors> | <Warning> | <Verbose> | <WriteLine> | <Data> | <Scope> | <ExecutionFlow> | <Assert> | <All>}] [-Debugger] [-FilePath <string>] [-Force] [-InputObject <psobject>] [-ListenerOption {<None> | <LogicalOperationStack> | <DateTime> | <Timestamp> | <ProcessId> | <ThreadId> | <Callstack>}] [-PSHost] [<CommonParameters>]

Trace-Command [-Expression] <scriptblock> [-Name] <string[]> [[-Option] {<None> | <Constructor> | <Dispose> | <Finalizer> | <Method> | <Property> | <Delegates> | <Events> | <Exception> | <Lock> | <Error> | <Errors> | <Warning> | <Verbose> | <WriteLine> | <Data> | <Scope> | <ExecutionFlow> | <Assert> | <All>}] [-Debugger] [-FilePath <string>] [-Force] [-InputObject <psobject>] [-ListenerOption {<None> | <LogicalOperationStack> | <DateTime> | <Timestamp> | <ProcessId> | <ThreadId> | <Callstack>}] [-PSHost] [<CommonParameters>]

Trace-Command Cmdlet 會為指定的運算式或命令設定並啟動追蹤。它的作用類似 Set-TraceSource，但是只能套用到指定的命令。

-ArgumentList <Object[]>

為追蹤的命令指定參數和參數值。ArgumentList 的別名為 Args。此功能特別有助於對動態參數進行偵錯。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Command <string>

指定追蹤期間所要處理的命令。

必要?	true
位置?	2
預設值
接受管線輸入?	false
接受萬用字元?	false

-Debugger

將追蹤輸出傳送至偵錯工具。可使用任何的使用者模式或核心模式偵錯工具，或在 Visual Studio 中檢視輸出。此參數也會選取預設的追蹤接聽程式。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Expression <scriptblock>

指定追蹤期間所要處理的運算式。將運算式置於大括號 ({}) 內。

必要?	true
位置?	2
預設值
接受管線輸入?	false
接受萬用字元?	false

-FilePath <string>

將追蹤輸出傳送到指定的檔案。此參數也會選取檔案追蹤接聽程式。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Force

允許此 Cmdlet 將追蹤資訊附加至唯讀的檔案。請搭配 FilePath 參數使用。即便使用 Force 參數，此 Cmdlet 也無法覆寫安全性限制。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-InputObject <psobject>

為追蹤期間處理的運算式提供輸入項。

可輸入代表運算式所接受之輸入項的變數，或透過管線傳遞物件。

必要?	false
位置?	named
預設值
接受管線輸入?	true (ByValue)
接受萬用字元?	false

-ListenerOption <TraceOptions>

在輸出中的每個追蹤訊息開頭加入選用性資料。有效的值包括 None、LogicalOperationStack、DateTime、Timestamp、ProcessId、ThreadId 和 Callstack。預設值為 "None"。

若要指定多重選項，請用逗號分隔選項，但不能包含空格，然後置於引號內，例如 "ProcessID,ThreadID"。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Name <string[]>

決定要追蹤的 Windows PowerShell 元件。輸入每個元件的追蹤來源的名稱。允許使用萬用字元。若要找出電腦上的追蹤來源，請輸入 "Get-TraceSource"。

必要?	true
位置?	1
預設值
接受管線輸入?	false
接受萬用字元?	false

-Option <PSTraceSourceOptions>

決定所要追蹤的事件類型。

有效的值包括 None、Constructor、Dispose、Finalizer、Method、Property、Delegates、Events、Exception、Lock、Error、Errors、Warning、Verbose、WriteLine、Data、Scope、ExecutionFlow、Assert 和 All。預設值為 "All"。

下列值是其他值的組合：

-- ExecutionFlow：(Constructor、Dispose、Finalizer、Method、Delegates、Events 和 Scope)

-- Data：(Constructor、Dispose、Finalizer、Property、Verbose 和 WriteLine)

-- Errors：(Error 和 Exception)。

若要指定多重選項，請用逗號分隔選項，但不能包含空格，然後置於引號內，例如 "Constructor,Dispose"。

必要?	false
位置?	3
預設值
接受管線輸入?	false
接受萬用字元?	false

-PSHost

將追蹤輸出傳送至 Windows PowerShell 主機。此參數也會選取 PSHost 追蹤接聽程式。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

<CommonParameters>

這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.Management.Automation.PSObject

您可經由管道將代表運算式輸入的物件輸出至 Trace-Command。

輸出

System.Management.Automation.PSObject

在偵錯資料流中傳回命令追蹤。

追蹤是開發人員用來偵錯和調整程式的一種方法。進行追蹤時，程式會產生詳細訊息列出每個內部處理步驟的相關資訊。

Windows PowerShell 追蹤 cmdlet 是專為輔助 Windows PowerShell 開發人員而設計，但所有的使用者皆可使用。這些 cmdlet 幾乎可以監視殼層每個層面的功能。

若要尋找啟用追蹤的 Windows PowerShell 元件，請輸入 "Get-Help Get-TraceSource"。

「追蹤來源」是每個 Windows PowerShell 元件的一部分，負責管理追蹤並產生元件的追蹤訊息。若要追蹤元件，您必須識別元件的追蹤來源。

「追蹤接聽程式」則接收追蹤的輸出，並顯示輸出供使用者檢視。您可以選擇將追蹤資料傳送到使用者模式或核心模式偵錯工具、主機或主控台、檔案，或者傳送到衍生自 System.Diagnostics.TraceListener 類別的自訂接聽程式。

當您使用 Command 參數集時，Windows PowerShell 處理命令的方式就如同在管線中處理一般。例如，不會針對每個內送物件重複命令搜索。

Name、Expression、Option 和 Command 參數的名稱為選擇性。如果省略參數名稱，就必須依此順序列出未具名的參數值：Name、Expression、Option (或 Name)、Command、-Option。如果包含參數名稱，則可依任意順序列出參數。

C:\PS>trace-command -name metadata,parameterbinding,cmdlet -expression {get-process notepad} -pshost

描述
-----------
這個命令會針對 "get-process notepad" 運算式之中繼資料處理、參數繫結以及 Cmdlet 建立與解構啟動追蹤。它使用 Name 參數指定追蹤來源；使用 Expression 參數指定命令；並使用 PSHost 參數，將輸出傳送到主控台。因為沒有指定任何追蹤選項或接聽程式選項，所以此命令會使用預設值：以 "All" 為追蹤選項，並以 "None" 為接聽程式選項。

C:\PS>trace-command -name commandprocessor,pipelineprocessor -command get-alias -argumentlist "ghy" -option executionflow -listenerOption "timestamp,callstack" -filepath c:\test\debug.txt

描述
-----------
這個命令會在處理 "get-alias cd" 命令時，為命令處理程式和管線處理程式啟動追蹤。

它會使用 Name 參數指定追蹤來源、使用 Command 參數指定命令、使用 ArgumentList 參數指定 Get-Alias 命令的參數、使用 Option 參數指定追蹤選項，並使用 ListenerOption 參數指定追蹤訊息開頭中的欄位。FilePath 參數會將輸出傳送到 C:\Test\Debug.txt 檔案。

C:\PS>$a = "i*"

C:\PS> trace-command parameterbinding {get-alias $input} -pshost -inputobject $a

描述
-----------
這些命令會在 Windows PowerShell 處理由管線取得輸入的 Get-Alias 運算式時，追蹤其 ParameterBinding 作業的動作。

在 Trace-Command 中，InputObject 參數會在追蹤期間將物件傳遞給處理中的運算式。

第一個命令將字串 "i*" 儲存在 $a 變數中。第二個命令會搭配 ParameterBinding 追蹤來源，使用 Trace-Command Cmdlet。PSHost 參數將輸出傳送到主控台。

正在處理中的運算式是 "get-alias $input"，其中 $input 變數與 InputObject 參數相關聯。InputObject 參數會將變數 $a 傳遞給運算式。實際上，在追蹤期間所處理的命令為 "get-alias -inputobject $a" 或 "$a | get-alias"。