Verwenden Sie die folgenden Informationen, um ein Skript durch schrittweises Durchlaufen zu debuggen.

Beim schrittweisen Durchlaufen wird jeweils eine Anweisung ausgeführt. Sie können die Ausführung an einer Codezeile beenden und die Werte von Variablen sowie den Status des Systems untersuchen. In der folgenden Tabelle werden allgemeine Debugaufgaben, z. B. Überspringen, Einzelschritt und Rücksprung, beschrieben.

Debugaufgabe

Beschreibung

Ausführung in PowerShell ISE

Einzelschritt

Führt die aktuelle Anweisung aus und hält dann die Ausführung an der nächsten Anweisung an. Wenn die aktuelle Anweisung ein Funktions- oder Skriptaufruf ist, wechselt der Debugger zu dieser Funktion bzw. zu diesem Skript. Andernfalls wird die Ausführung bei der nächsten Anweisung beendet.

Geben Sie im Befehlsbereich "S" ein, und drücken Sie die EINGABETASTE, oder klicken Sie im Menü Debug auf Einzelschritt.

Überspringen

Führt die aktuelle Anweisung aus und hält dann die Ausführung an der nächsten Anweisung an. Wenn die aktuelle Anweisung ein Funktions- oder Skriptaufruf ist, führt der Debugger die gesamte Funktion bzw. das gesamte Skript aus und hält die Ausführung an der nächsten Anweisung nach dem Funktions- bzw. Skriptaufruf an.

Geben Sie im Befehlsbereich "V" ein, und drücken Sie die EINGABETASTE, oder klicken Sie im Menü Debug auf Überspringen.

Rücksprung

Verlässt die aktuelle Funktion und setzt den Vorgang eine Ebene höher fort, wenn es sich um eine geschachtelte Funktion handelt. Im Haupttext wird das Skript bis zum Ende oder bis zum nächsten Haltepunkt fortgesetzt. Die übersprungenen Anweisungen werden ausgeführt, jedoch nicht durchlaufen.

Geben Sie im Befehlsbereich "O" ein, und drücken Sie die EINGABETASTE, oder klicken Sie im Menü Debug auf Rücksprung.

Fortsetzen

Setzt die Ausführung bis zum Ende oder bis zum nächsten Haltepunkt fort. Die übersprungenen Funktionen und Aufrufe werden ausgeführt, jedoch nicht durchlaufen.

Geben Sie im Befehlsbereich "C" ein, und drücken Sie die EINGABETASTE, oder, klicken Sie im Menü Debug auf Ausführen/Fortsetzen.

Debuggen eines Skripts

  1. Legen Sie die Haltepunkte im Code fest, den Sie untersuchen möchten. Informationen zum Festlegen von Haltepunkten finden Sie unter How to Set, Remove, Disable Enable, Disable, and List Breakpoints und Set-PSBreakpoint.

  2. Klicken Sie im Menü Debug auf Ausführen/Fortsetzen, oder klicken Sie auf der Symbolleiste auf Skript ausführen. Es werden folgende Vorgänge ausgeführt:

    • Der Debugvorgang wird gestartet. Das Skript wird ausgeführt, bis der erste Haltepunkt auftritt, und dann wird das Skript beendet. Der Haltepunkt wird hervorgehoben.

    • Die Eingabeaufforderung ändert sich, und auf der Befehlsbereichleiste wird das Präfix "[DBG]" angezeigt.

    • Im Ausgabebereich wird eine Meldung über den aufgetretenen Haltepunkt angezeigt. Beispiel: "Zeilenhaltepunkt für "C:\Users\Name\Desktop\test.script.ps1:13 erreicht".

    Die Meldung enthält den Skriptnamen und Informationen über den Zeilenhaltepunkt, Variablenhaltepunkt oder den Befehlshaltepunkt.

  3. Anschließend können Sie die Aktion "Überspringen", "Einzelschritt", "Rücksprung" oder "Fortsetzen" ausführen. Mit "Fortsetzen" wird der Debugger bis zum Ende des Skripts oder bis zum nächsten Haltepunkt ausgeführt.

  4. Wenn Sie während des Debuggens den Wert einer Variablen suchen möchten, zeigen Sie im Skriptbereich mit der Maus auf die Variable, oder geben Sie im Befehlsbereich den Variablennamen ein, und drücken Sie die EINGABETASTE. Im Ausgabebereich wird der Wert der Variablen angezeigt. Setzen Sie das schrittweise Durchlaufen des Skripts fort, oder führen Sie andere Debugaufgaben aus.

Siehe auch



Inhaltsverzeichnis