Get-PSCallStack

  • 参考
模块:
Microsoft.PowerShell.Utility

显示当前的调用堆栈。

语法

Get-PSCallStack []

说明

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