Schreibt eine Warnmeldung. (Write-Warning)
NAMEWrite-WarningÜBERSICHTSchreibt eine Warnmeldung.SYNTAXWrite-Warning [-Message] <string> [<CommonParameters>]BESCHREIBUNGDas Cmdlet "Write-Warning" schreibt eine Warnmeldung in den Windows PowerShell-Host. Die Reaktion auf die Warnung hängt vom Wert der Variablen "$WarningPreference" des Benutzers und der Verwendung des allgemeinen WarningAction-Parameters ab.PARAMETER-Message <string> Gibt die Warnmeldung an. Erforderlich? true Position? 1 Standardwert Pipelineeingaben akzeptieren?true (ByValue) 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".EINGABENSystem.String Sie können über die Pipeline eine Zeichenfolge, die die Warnung enthält, an Write-Warning übergeben.AUSGABENKeiner Write-Warning schreibt nur in den Warnstream. Es wird keine weitere Ausgabe generiert.HINWEISEDer Standardwert für die Variable "$WarningPreference" ist "Continue", mit dem die Warnung angezeigt und die Ausführung des Befehls fortgesetzt wird. Um gültige Werte für eine Einstellungsvariable wie "$WarningPreference" zu bestimmen, können Sie sie auf eine Zeichenfolge mit nach dem Zufallsprinzip ausgewählten Zeichen, z. B. "abc", festlegen. In der resultierenden Fehlermeldung werden die gültigen Werte aufgelistet.Beispiele
BEISPIEL 1C:\PS>write-warning "This is only a test warning." Beschreibung ----------- Mit diesem Befehl wird die Meldung "WARNING: This is only a test warning" angezeigt.BEISPIEL 2C:\PS>$w = "This is only a test warning." C:\PS> $w | write-warning Beschreibung ----------- In diesem Beispiel wird gezeigt, dass eine Zeichenfolge mithilfe eines Pipelineoperators (|) an Write-Warning gesendet werden kann. Sie können die Zeichenfolge wie in diesem Befehl in einer Variablen speichern oder die Zeichenfolge direkt über die Pipeline an Write-Warning übergeben.BEISPIEL 3C:\PS>$warningpreference Continue C:\PS> write-warning "This is only a test warning." This is only a test warning. C:\PS> $warningpreference = "SilentlyContinue" C:\PS> write-warning "This is only a test warning." C:\PS> C:\PS> $warningpreference = "Stop" C:\PS> write-warning "This is only a test warning." WARNING: This is only a test message. Write-Warning : Command execution stopped because the shell variable "WarningPreference" is set to Stop. At line:1 char:14 + write-warning <<<< "This is only a test message." Beschreibung ----------- In diesem Beispiel werden die Auswirkungen der Variablen "$WarningPreference" im Befehl "Write-Warning" veranschaulicht. Im ersten Befehl wird der Standardwert "Continue" der Variablen "$WarningPreference" angezeigt. Wenn Sie eine Warnung schreiben, wird daher eine Warnmeldung angezeigt und die Ausführung fortgesetzt. Wenn Sie den Wert der Variablen "$WarningPreference" ändern, ändert sich die Auswirkung des Befehls "Write-Warning" erneut. Mit dem Wert "SilentlyContinue" wird die Warnung unterdrückt. Mit dem Wert "Stop" wird die Warnung angezeigt und anschließend die Ausführung des Befehls angehalten. Weitere Informationen über die Variable "$WarningPreference" finden Sie unter "about_Preference_Variables".BEISPIEL 4C:\PS>write-warning "This is only a test warning." -warningaction Inquire WARNING: This is only a test warning. Confirm Continue with this operation? [Y] Yes [A] Yes to All [H] Halt Command [S] Suspend [?] Help (default is "Y"): Beschreibung ----------- Dieses Beispiel veranschaulicht die Auswirkungen des allgemeinen WarningAction-Parameters im Befehl "Write-Warning". Sie können den allgemeinen WarningAction-Parameter mit einem beliebigen Cmdlet verwenden, um zu bestimmen, wie Windows PowerShell auf Warnungen reagiert, die durch diesen Befehl verursacht werden. Der allgemeine WarningAction-Parameter überschreibt den Wert von $WarningPreference nur für diesen spezifischen Befehl. Dieser Befehl zeigt Warnungen mit dem Cmdlet "Write-Warning" an. Der allgemeine WarningAction-Parameter mit dem Wert "Inquire" legt fest, dass das System den Benutzer zu einer Aktion auffordert, wenn der Befehl eine Warnung anzeigt. Weitere Informationen über den allgemeinen WarningAction-Parameter finden Sie unter "about_CommonParameters". VERWANDTE LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=113430 (möglicherweise auf Englisch) about_Preference_Variables about_CommonParameters Write-Debug Write-Error Write-Host Write-Output Write-Progress Write-Verbose C:\Windows>powershell get-help Write-Error -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
