Share via

Get-PSCallStack

  • 参考
模块:
Microsoft.PowerShell.Utility

显示当前的调用堆栈。

语法

Get-PSCallStack []

说明

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

Get-PSCallStack 返回一个 对象，该对象表示调用堆栈中的项。