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-intosкоманды начинают выполнять строку функции по строкам. Get-PSCallStack Затем для получения стека вызовов используется команда.

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

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

None

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

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

CallStackFrame

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