Get-PSCallStack
顯示目前的呼叫堆疊。
Syntax
Get-PSCallStack []
Description
Get-PSCallStack Cmdlet 會顯示目前的呼叫堆棧。
雖然它的設計目的是要與 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 名稱的別名。
第一個命令會在 PowerShell 提示字元中輸入函式。 第二個命令使用 Set-PSBreakpoint Cmdlet 在 My-Alias 函式上設定中斷點。 第三個命令使用 My-Alias 函式取得目前工作階段中 Get-Content Cmdlet 的所有別名。
偵錯工具會在函式呼叫時中斷。 兩個連續「逐步執行」命令 (s) 開始逐行執行函式。 然後, 會使用 Get-PSCallStack 命令來擷取呼叫堆疊。
最後一個命令是「跳離」命令 (o),它會結束偵錯工具,並繼續執行指令碼直到完成。
輸入
None
您無法使用管線將物件傳送至此 Cmdlet。
輸出
Get-PSCallStack 會傳回物件,代表呼叫堆棧中的專案。