Get-PSCallStack
Zeigt den aktuellen Aufrufstapel an.
Syntax
Default (Standard)
Get-PSCallStack
Beschreibung
Das Cmdlet Get-PSCallStack zeigt den aktuellen Aufrufstapel an.
Obwohl es für die Verwendung mit dem Windows PowerShell-Debugger konzipiert ist, können Sie dieses Cmdlet verwenden, um den Aufrufstapel in einem Skript oder einer Funktion außerhalb des Debuggers anzuzeigen.
Zum Ausführen eines Get-PSCallStack Befehls im Debugger geben Sie k oder Get-PSCallStackein.
Beispiele
Beispiel 1: Abrufen des Aufrufstapels für eine Funktion
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
Dieser Befehl verwendet das Cmdlet Get-PSCallStack, um den Aufrufstapel für My-Aliasanzuzeigen, eine einfache Funktion, die die Aliase für einen Cmdlet-Namen abruft.
Der erste Befehl gibt die Funktion an der Windows PowerShell-Eingabeaufforderung ein. Der zweite Befehl verwendet das Cmdlet Set-PSBreakpoint, um einen Haltepunkt für die My-Alias-Funktion festzulegen. Der dritte Befehl verwendet die My-Alias-Funktion, um alle Aliase in der aktuellen Sitzung für das Cmdlet Get-Content abzurufen.
Der Debugger wird beim Funktionsaufruf unterbrochen. Zwei aufeinander folgende step-into (s) Befehle beginnen mit der Ausführung der Funktionszeile nach Zeile. Anschließend wird ein Get-PSCallStack-Befehl verwendet, um den Aufrufstapel abzurufen.
Der letzte Befehl ist ein Step-Out -Befehl (o), der den Debugger beendet und das Skript bis zum Abschluss weiter ausführt.
Eingaben
None
Objekte können nicht an dieses Cmdlet weitergeleitet werden.
Ausgaben
CallStackFrame
Get-PSCallStack Gibt ein Objekt zurück, das die Elemente in der Aufrufliste darstellt.