Поделиться через

Get-PSCallStack

  • Ссылка
Модуль:
Microsoft.PowerShell.Utility

Отображает текущий стек вызовов.

Синтаксис

Get-PSCallStack []

Описание

Командлет Get-PSCallStack отображает текущий стек вызовов.

Хотя он предназначен для использования с отладчиком Windows PowerShell, этот командлет можно использовать для отображения стека вызовов в скрипте или функции за пределами отладчика.

Чтобы выполнить команду 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 для отображения стека вызовов для My-Aliasпростой функции, которая получает псевдонимы для имени командлета.

Первая команда вводит функцию в командной строке Windows PowerShell. Вторая команда использует командлет Set-PSBreakpoint для задания точки останова в функции My-Alias. Третья команда использует функцию My-Alias для получения всех псевдонимов в текущем сеансе для командлета Get-Content.

Отладчик прерывается при вызове функции. Две последовательные команды step-into (s) начинают выполнять строку функции по строке. Затем для получения стека вызовов используется команда Get-PSCallStack.

Последняя команда — это команда Step-Out (o), которая завершает отладчик и продолжает выполнение скрипта до завершения.

Входные данные

None

Невозможно передать объекты в этот командлет.

Выходные данные

CallStackFrame

Этот командлет возвращает объект, представляющий элементы в стеке вызовов.

Примечания

PowerShell включает следующие псевдонимы для Get-PSCallStack:

  • Все платформы:
    • gcs