Get-PSCallStack

显示当前调用堆栈。

语法

Get-PSCallStack []

说明

Get-PSCallStack cmdlet 显示当前调用堆栈。

尽管它设计用于 Windows PowerShell 调试器,但你可以使用此 cmdlet 在调试器外部的脚本或函数中显示调用堆栈。

若要在调试器中运行时运行 Get-PSCallStack 命令,请键入 kGet-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-intos)命令开始逐行执行函数行。 然后,使用 Get-PSCallStack 命令检索调用堆栈。

最后一个命令是一个 Step-Out 命令(o),该命令退出调试器并继续执行脚本以完成。

输入

None

不能通过管道将对象传递给此 cmdlet。

输出

CallStackFrame

此 cmdlet 返回一个对象,该对象表示调用堆栈中的项。

备注

PowerShell 包含以下 Get-PSCallStack别名:

  • 所有平台:
    • gcs