Beschreibt das Throw-Schlüsselwort, das einen Fehler mit Abbruch (about_Throw)
THEMAabout_ThrowKURZBESCHREIBUNGBeschreibt das Throw-Schlüsselwort, das einen Fehler mit Abbruch generiert.DETAILBESCHREIBUNGDas Throw-Schlüsselwort verursacht einen Fehler mit Abbruch. Mit dem Throw-Schlüsselwort können Sie die Verarbeitung eines Befehls, einer Funktion oder eines Skripts beenden. Sie können das Throw-Schlüsselwort beispielsweise im Skriptblock einer IF-Anweisung verwenden, um auf eine Bedingung zu reagieren, oder Sie verwenden es im Catch-Block einer Try-Catch-Finally- Anweisung. Außerdem können Sie das Throw-Schlüsselwort in einer Parameterdeklaration verwenden, um einen Funktionsparameter als erforderlich festzulegen. Das Throw-Schlüsselwort kann jedes Objekt auslösen, z. B. eine Benutzermeldungszeichenfolge oder das Objekt, das den Fehler verursacht hat. SYNTAX Die Syntax des Throw-Schlüsselworts lautet wie folgt: throw [<Ausdruck>] Der Ausdruck in der Throw-Syntax ist optional. Wenn die Throw-Anweisung nicht in einem Catch-Block enthalten ist und keinen Ausdruck einschließt, wird ein ScriptHalted-Fehler generiert. C:\PS> throw ScriptHalted Bei Zeile:1 Zeichen:6 + throw <<<< + CategoryInfo : OperationStopped: (:) [], RuntimeException + FullyQualifiedErrorId : ScriptHalted Wenn das Throw-Schlüsselwort ohne Ausdruck in einem Catch-Block verwendet wird, wird erneut die aktuelle "RuntimeException" ausgelöst. Weitere Informationen finden Sie unter "about_Try_Catch_Finally". AUSLÖSEN EINER ZEICHENFOLGE Der optionale Ausdruck in einer Throw-Anweisung kann eine Zeichenfolge sein, wie im folgenden Beispiel gezeigt: C:\PS> throw "Fehler aufgetreten." Fehler aufgetreten. Bei Zeile:1 Zeichen:6 + throw <<<< "Fehler aufgetreten." + CategoryInfo : OperationStopped: (Fehler aufgetreten.:String) [], RuntimeException + FullyQualifiedErrorId : Fehler aufgetreten. AUSLÖSEN VON ANDEREN OBJEKTEN Der Ausdruck kann auch ein Objekt sein,in dem das Objekt, das den PowerShell-Prozess darstellt, ausgelöst wird, wie im folgenden Beispiel gezeigt: C:\PS> throw (get-process powershell) System.Diagnostics.Process (powershell) Bei Zeile:1 Zeichen:6 + throw <<<< (get-process powershell) + CategoryInfo : OperationStopped: (System.Diagnostics.Process (powershell)):Process, [], RuntimeException + FullyQualifiedErrorId : System.Diagnostics.Process (powershell) Mit der TargetObject-Eigenschaft des ErrorRecord-Objekts in der automatischen Variablen "$error" können Sie den Fehler überprüfen. C:\PS> $error[0].targetobject Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName ------- ------ ----- ----- ----- ------ -- ----------- 319 26 61016 70864 568 3.28 5548 powershell Es kann auch ein ErrorRecord-Objekt oder eine Microsoft .NET Framework-Ausnahme ausgelöst werden. Im folgenden Beispiel wird mit dem Throw-Schlüsselwort ein System.FormatException-Objekt ausgelöst. C:\PS> $formatError = new-object system.formatexception C:\PS> throw $formatError Ein identifiziertes Element hat ein ungültiges Format. Bei Zeile:1 Zeichen:6 + throw <<<< $formatError + CategoryInfo : OperationStopped: (:) [], FormatException + FullyQualifiedErrorId : Ein identifiziertes Element hat ein ungültiges Format. RESULTIERENDER FEHLER Das Throw-Schlüsselwort kann ein ErrorRecord-Objekt generieren. Die Exception-Eigenschaft des ErrorRecord-Objekts enthält ein RuntimeException-Objekt. Der Rest des ErrorRecord-Objekts und des RuntimeException-Objekts ändert sich abhängig von dem Objekt, das das Throw-Schlüsselwort auslöst. Das RunTimeException-Objekt wird von einem ErrorRecord-Objekt umschlossen, und das ErrorRecord-Objekt wird automatisch in der automatischen Variablen "$Error" gespeichert. ERSTELLEN EINES ERFORDERLICHEN PARAMETERS MIT "THROW" Mit dem Throw-Schlüsselwort können Sie einen Funktionsparameter als erforderlich festlegen. Dies ist eine Alternative zur Verwendung des Mandatory-Parameters des Parameter-Schlüsselworts. Wenn Sie den Mandatory-Parameter verwenden, fordert das System den Benutzer zur Eingabe des erforderlichen Parameterwerts auf. Wenn Sie das Throw-Schlüsselwort verwenden, wird der Befehl beendet, und der Fehlerdatensatz wird angezeigt. Bei Verwendung des Throw-Schlüsselworts im Parameterteilausdruck wird beispielsweise der Path-Parameter als erforderlicher Parameter in der Funktion festgelegt. In diesem Fall löst das Throw-Schlüsselwort eine Meldungszeichen- folge aus. Der Fehler mit Abbruch wird jedoch durch das Throw-Schlüsselwort generiert, wenn der Path-Parameter nicht angegeben wird. Der auf "Throw" folgende Ausdruck ist optional. function Get-XMLFiles { param ($path = $(throw "Der Path-Parameter ist erforderlich.")) dir -path $path\* -include *.xml -recurse | sort lastwritetime | ft lastwritetime, attributes, name -auto } SIEHE AUCH about_Break about_Continue about_Scope about_Trap about_Try_Catch_Finally C:\Windows>powershell get-help about_transactions -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
