Set-PSDebug - PowerShell Befehl Hilfe und Beispiele

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

... Beispiele      
 NAME
 
    Set-PSDebug 

 ÜBERSICHT
 
    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 [<SwitchParameter>] 
        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 [<SwitchParameter>] 
        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 [<SwitchParameter>] 
        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 folgende allgemeine Parameter: "Verbose", "Debug", 
        "ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable", 
        "OutBuffer" und "OutVariable". Weitere Informationen 
        erhalten Sie mit dem Befehl "get-help about_commonparameters". 

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

 AUSGABEN
 
    Keiner 
        Dieses Cmdlet gibt keine Ausgabe zurück. 

 HINWEISE
 

 Beispiele
    
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. 

VERWANDTE LINKS 
    Online version: http://go.microsoft.com/fwlink/?LinkID=113398 (möglicherweise auf Englisch) 
    about_Debuggers 
    Debug-Process 
    Set-PSBreakpoint 
    Set-StrictMode 
    Write-Debug 

C:\Windows>powershell get-help Set-StrictMode -full 

Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.

ColorConsole [Version 3.7.1000] PowerShell 2.0-Export

Windows 11, 10, 8.1, 8, 7 / Server 2022, 2019, 2016