Get-PSCallStack

  • Reference
Modul:
Microsoft.PowerShell.Utility

Zobrazí aktuální zásobník volání.

Syntax

Get-PSCallStack []

Description

Rutina Get-PSCallStack zobrazí aktuální zásobník volání.

I když je navržená tak, aby se používala s ladicím programem Prostředí Windows PowerShell, můžete pomocí této rutiny zobrazit zásobník volání ve skriptu nebo funkci mimo ladicí program.

Chcete-li spustit příkaz v ladicím Get-PSCallStack programu, zadejte k nebo Get-PSCallStack.

Příklady

Příklad 1: Získání zásobníku volání pro funkci

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

Tento příkaz používá rutinu Get-PSCallStack k zobrazení zásobníku volání pro My-Alias, jednoduchou funkci, která získá aliasy pro název rutiny.

První příkaz zadá funkci na příkazovém řádku Windows PowerShellu. Druhý příkaz pomocí rutiny Set-PSBreakpoint nastaví zarážku funkce My-Alias . Třetí příkaz pomocí My-Alias funkce získá všechny aliasy v aktuální relaci rutiny Get-Content .

Ladicí program se přeruší při volání funkce. Dva po sobě jdoucí step-into příkazys () začínají spouštět řádek po řádku funkce. Pak se Get-PSCallStack k načtení zásobníku volání použije příkaz.

Posledním příkazem Step-Out je příkaz (o), který ukonče ladicí program a pokračuje v provádění skriptu k dokončení.

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

CallStackFrame

Tato rutina vrátí objekt představující položky v zásobníku volání.

Poznámky

PowerShell obsahuje následující aliasy pro Get-PSCallStack:

  • Všechny platformy:
    • gcs