Get-PSCallStack
顯示目前的呼叫堆疊。
語法
Default (預設值)
Get-PSCallStack
Description
Get-PSCallStack Cmdlet 會顯示目前的呼叫堆疊。
雖然其設計目的是要與 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 函式來取得 Get-Content Cmdlet 目前會話中的所有別名。
調試程式會在函數調用中中斷。 連續兩個 step-into (s) 命令開始逐行執行函式行。 然後,會使用 Get-PSCallStack 命令來擷取呼叫堆疊。
最後一個命令是一個 Step-Out 命令 (o),會結束調試程式,並繼續執行腳本以完成。
輸入
None
您不能將物件透過管道傳送到此 Cmdlet。
輸出
CallStackFrame
這個 Cmdlet 會傳回物件,代表呼叫堆疊中的專案。
備註
PowerShell 包含下列 Get-PSCallStack的別名:
- 所有平臺:
gcs