Aktiviert bzw. deaktiviert Skript-Debuggingfunktionen, legt die Ablaufverfolgungsebene fest und schaltet den Strict-Modus um.

Syntax

Set-PSDebug [-Off] [<CommonParameters>]

Set-PSDebug [-Step] [-Strict] [-Trace <int>] [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Set-PSDebug" werden Skript-Debuggingfunktionen aktiviert und deaktiviert, die Ablaufverfolgungsebene wird festgelegt , und der Strict-Modus wird umgeschaltet.

Wenn der Trace-Parameter auf 1 festgelegt ist, wird während der Ausführung eine Ablaufverfolgung für jede Zeile des Skripts durchgeführt. Wenn der Parameter auf 2 festgelegt ist, wird auch der Ablauf von Variablenzuweisungen sowie Funktions- und Skriptaufrufen verfolgt. Wenn der Step-Parameter angegeben wird, werden Sie vor Ausführung der einzelnen Zeilen des Skripts zur Bestätigung aufgefordert angezeigt.

Parameter

-Off

Deaktiviert alle Skript-Debuggingfunktionen.

Hinweis: Mit dem Befehl "Set-StrictMode -off" wird die vom Befehl "set-psdebug -strict" festgelegte Überprüfung deaktiviert. Weitere Informationen finden Sie unter "Set-StrictMode".

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Step

Aktiviert das schrittweise Durchlaufen von Skripts. Vor dem Ausführen der einzelnen Zeilen wird der Benutzer zum Beenden, Fortfahren oder Wechseln zu einer neuen Interpreterebene aufgefordert, um den Zustand des Skripts zu überprüfen.

Hinweis: Beim Angeben des Step-Parameters wird automatisch eine Ablaufverfolgungsebene von 1 festgelegt.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Strict

Gibt an, dass der Interpreter eine Ausnahme auslösen soll, wenn auf eine Variable verwiesen wird, bevor ihr ein Wert zugewiesen wurde.

Hinweis: Mit dem Befehl "Set-StrictMode -off" wird die vom Befehl "set-psdebug -strict" festgelegte Überprüfung deaktiviert. Weitere Informationen finden Sie unter "Set-StrictMode".

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Trace <int>

Gibt die Ablaufverfolgungsebene an:

0 - Skriptablaufverfolgung deaktivieren

1 - Skriptzeilen beim Ausführen verfolgen

2 - Skriptzeilen, Variablenzuweisungen, Funktionsaufrufe und Skripts verfolgen

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

None

Eingaben können nicht über die Pipeline an dieses Cmdlet übergeben werden.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Beispiel 1

C:\PS>set-psdebug -trace 2; foreach ($i in 1..3) {$i}

DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
1
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
2
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
3

Beschreibung
-----------
Mit diesem Befehl wird die Ablaufverfolgungsstufe auf 2 festgelegt, und anschließend wird ein Skript ausgeführt, das die Zahlen 1, 2 und 3 anzeigt.

Beispiel 2

C:\PS>set-psdebug -step; foreach ($i in 1..3) {$i}

DEBUG:    1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
Continue with this operation?
   1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help
(default is "Y"):a
DEBUG:    1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
1
2
3

Beschreibung
-----------
Mit diesem Befehl wird das schrittweise Durchlaufen aktiviert, und anschließend 
ein Skript ausgeführt, das die Zahlen 1, 2 und 3 anzeigt.

Beispiel 3

C:\PS>set-psdebug -off; foreach ($i in 1..3) {$i}

1
2
3

Beschreibung
-----------
Mit diesem Befehl werden alle Debuggingfunktionen deaktiviert, und anschließend wird ein Skript ausgeführt, das die Zahlen 1, 2 und 3 anzeigt.

Beispiel 4

C:\PS>set-psdebug -strict; $NewVar

The variable $NewVar cannot be retrieved because it has not been set yet.
At line:1 char:28
+ Set-PsDebug -strict;$NewVar <<<<

Beschreibung
-----------
Mit diesem Befehl wird der Interpreter in den Strict-Modus versetzt, und es wird versucht, auf eine Variable zuzugreifen, die noch nicht festgelegt wurde.

Siehe auch



Inhaltsverzeichnis