Freigeben über

Write-Warning

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Schreibt eine Warnmeldung.

Syntax

Write-Warning
     [-Message] <String>
     [<CommonParameters>]

Beschreibung

Das Cmdlet Write-Warning schreibt eine Warnmeldung auf den PowerShell-Host. Die Antwort auf die Warnung hängt vom Wert der $WarningPreference Variablen des Benutzers und der Verwendung der WarningAction allgemeinen Parameter ab.

Beispiele

Beispiel 1: Schreiben einer Warnmeldung

Mit diesem Befehl wird die Meldung "WARNUNG: Dies ist nur eine Testwarnung" angezeigt.

Write-Warning "This is only a test warning."

Beispiel 2: Übergeben einer Zeichenfolge an Write-Warning

Dieser Befehl zeigt, dass Sie einen Pipelineoperator (|) verwenden können, um eine Zeichenfolge an Write-Warningzu senden. Sie können die Zeichenfolge wie in diesem Befehl dargestellt in einer Variablen speichern oder die Zeichenfolge direkt an Write-Warningübergeben.

$w = "This is only a test warning."
$w | Write-Warning

Beispiel 3: Festlegen der $WarningPreference Variablen und Schreiben einer Warnung

In diesem Beispiel wird die Auswirkung des Werts der variablen $WarningPreference auf einen Write-Warning-Befehl gezeigt.

PS> $WarningPreference
Continue
PS> Write-Warning "This is only a test warning."
This is only a test warning.
PS> $WarningPreference = "SilentlyContinue"
PS> Write-Warning "This is only a test warning."
PS> $WarningPreference = "Stop"
PS> Write-Warning "This is only a test warning."
WARNING: This is only a test warning.
Write-Warning: The running command stopped because the preference variable "WarningPreference" or common parameter is set to Stop: This is only a test warning.

Der erste Befehl zeigt den Standardwert der variablen $WarningPreference an, die Continueist. Wenn Sie eine Warnung schreiben, wird die Warnmeldung angezeigt, und die Ausführung wird fortgesetzt.

Wenn Sie den Wert der $WarningPreference Variablen ändern, ändert sich die Auswirkung des Write-Warning Befehls erneut. Der Wert SilentlyContinue die Warnung unterdrückt. Ein Wert von Stop zeigt die Warnung an und beendet dann die Ausführung des Befehls.

Weitere Informationen zur $WarningPreference Variablen finden Sie unter about_Preference_Variables.

Beispiel 4: Festlegen des WarningAction-Parameters und Schreiben einer Warnung

In diesem Beispiel wird die Auswirkung des WarningAction- allgemeinen Parameters auf einen Write-Warning-Befehl gezeigt. Sie können den WarningAction allgemeinen Parameter mit jedem Cmdlet verwenden, um zu bestimmen, wie PowerShell auf Warnungen reagiert, die sich aus diesem Befehl ergeben. Der WarningAction allgemeinen Parameter setzt den Wert des $WarningPreference nur für diesen bestimmten Befehl außer Kraft.

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"):

Dieser Befehl verwendet das Cmdlet Write-Warning, um eine Warnung anzuzeigen. Der WarningAction allgemeinen Parameter mit dem Wert "Inquire" leitet das System an, den Benutzer aufzufordern, wenn der Befehl eine Warnung anzeigt.

Weitere Informationen zum WarningAction allgemeinen Parameter finden Sie unter about_CommonParameters.

Parameter

-Message

Gibt die Warnmeldung an.

Typ:String
Aliase:Msg
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

Sie können eine Zeichenfolge weiterleiten, die die Warnung an dieses Cmdlet enthält.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück. Er schreibt nur in den Warndatenstrom.

Hinweise

Der Standardwert für die variable $WarningPreference ist Continue, wodurch die Warnung angezeigt wird und anschließend der Befehl weiterhin ausgeführt wird. Um gültige Werte für eine Einstellungsvariable wie $WarningPreferencezu bestimmen, legen Sie sie auf eine Zeichenfolge zufälliger Zeichen fest, z. B. "abc". Die resultierende Fehlermeldung listet die gültigen Werte auf.