Get-PSCallStack
Wyświetla bieżący stos wywołań.
Składnia
Default (domyślnie)
Get-PSCallStack
Opis
Polecenie cmdlet Get-PSCallStack wyświetla aktualny stos wywołań.
Chociaż jest on przeznaczony do używania z debugerem programu Windows PowerShell, można użyć tego polecenia cmdlet do wyświetlania stosu wywołań w skrycie lub funkcji poza debugerem.
Aby uruchomić polecenie Get-PSCallStack w debugerze, wpisz k lub Get-PSCallStack.
Przykłady
Przykład 1: Pobierz stos wywołań dla funkcji
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
To polecenie używa cmdletu Get-PSCallStack, aby wyświetlić stos wywołań dla My-Alias, prostej funkcji, która zwraca aliasy dla nazwy cmdletu.
Pierwsze polecenie wprowadza funkcję w wierszu polecenia programu Windows PowerShell. Drugie polecenie używa polecenia cmdlet Set-PSBreakpoint, aby ustawić punkt przerwania w funkcji My-Alias. Trzecie polecenie używa funkcji My-Alias, aby pobrać wszystkie aliasy w bieżącej sesji dla polecenia cmdlet Get-Content.
Debugger zatrzymuje się przy wywołaniu funkcji. Dwa kolejne polecenia step-into (s) zaczynają wykonywać funkcję w sposób liniowy, wiersz po wierszu. Następnie polecenie Get-PSCallStack służy do pobierania stosu wywołań.
Ostatnim poleceniem jest polecenie Step-Out (o), które zakończa działanie debugera i kontynuuje wykonywanie skryptu aż do jego zakończenia.
Dane wejściowe
None
Nie można przekazywać obiektów do tego cmdletu.
Dane wyjściowe
CallStackFrame
To polecenie cmdlet zwraca obiekt reprezentujący elementy w stosie wywołań.
Uwagi
Program PowerShell zawiera następujące aliasy dla Get-PSCallStack:
- Wszystkie platformy:
gcs