Get-PSCallStack

顯示目前的通話堆疊。

語法

Default (預設值)

Get-PSCallStack

Description

指令長會 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-Outo指令,從除錯器中退出並持續執行腳本直到完成。

輸入

None

您不能將物件透過管道傳送到此 Cmdlet。

輸出

CallStackFrame

此 cmdlet 回傳一個物件,代表呼叫堆疊中的項目。

備註

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

  • 所有平臺:
    • gcs