共用方式為

Get-PSCallStack

  • 參考
模組:
Microsoft.PowerShell.Utility

顯示目前的呼叫堆疊。

Syntax

Get-PSCallStack []

Description

Cmdlet Get-PSCallStack 會顯示目前的呼叫堆疊。

雖然它是設計來搭配 Windows PowerShell 偵錯工具使用，您可以在偵錯工具之外，使用這個 Cmdlet 顯示指令碼或函式中的呼叫堆疊。

若要在除錯程式中執行 Get-PSCallStack 命令，請輸入 k 或 Get-PSCallStack。

範例

範例 1：取得函式的呼叫堆疊

PS C:\> function my-alias {
$p = $args[0]
Get-Alias | where {$_.definition -like "*$p"} | format-table definition, name -auto
}
PS C:\ps-test> Set-PSBreakpoint -Command my-alias
Command    : my-alias
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : prompt PS C:\> my-alias Get-Content

Entering debug mode. Use h or ? for help.
Hit Command breakpoint on 'prompt:my-alias'
my-alias get-content
[DBG]: PS C:\ps-test> s
$p = $args[0]
DEBUG: Stepped to ':    $p = $args[0]    '
[DBG]: PS C:\ps-test> s
get-alias | Where {$_.Definition -like "*$p*"} | format-table Definition,
[DBG]: PS C:\ps-test>get-pscallstack

Name        CommandLineParameters         UnboundArguments              Location
----        ---------------------         ----------------              --------
prompt      {}                            {}                            prompt
my-alias    {}                            {get-content}                 prompt
prompt      {}                            {}                            prompt

PS C:\> [DBG]: PS C:\ps-test> o
Definition  Name
----------  ----
Get-Content gc
Get-Content cat
Get-Content type

此命令會 Get-PSCallStack 使用 Cmdlet 來顯示 的 My-Alias呼叫堆疊，這是一個簡單的函式，可取得 Cmdlet 名稱的別名。

第一個命令在 Windows PowerShell 命令提示字元中輸入函式。 第二個命令會 Set-PSBreakpoint 使用 Cmdlet 在函式上 My-Alias 設定斷點。 第三個命令會 My-Alias 使用 函式來取得 Cmdlet 目前會話 Get-Content 中的所有別名。

偵錯工具會在函式呼叫時中斷。 兩個連續 step-into (s) 命令開始逐行執行函式。 然後， Get-PSCallStack 會使用 命令來擷取呼叫堆疊。

最後一個 Step-Out 命令是命令 (o) 結束調試程式，並繼續執行腳本以完成。

輸入

None

您無法使用管線將物件傳送至此 Cmdlet。

輸出

CallStackFrame

這個 Cmdlet 會傳回物件，代表呼叫堆疊中的專案。

備註

PowerShell 包含下列的 Get-PSCallStack別名：

  • 所有平台：
    • gcs