Get-PSCallStack

模块:
Microsoft.PowerShell.Utility Module

显示当前调用堆栈。

语法

Default (默认值) 

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 函数获取 cmdlet 当前会话 Get-Content 中的所有别名。

调试器在函数调用时中断。 两个连续 step-into （s） 命令开始逐行执行函数行。 然后， Get-PSCallStack 使用命令检索调用堆栈。

最后一个命令是一个 Step-Out 命令（o），它退出调试器并继续执行脚本以完成。

输入

None

不能用管道将对象传送到此 cmdlet。

输出

CallStackFrame

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

备注

PowerShell 包含以下与 Get-PSCallStack相关的别名：

  • 所有平台：
    • gcs