Share via

Write-Warning

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Schreibt eine Warnmeldung.

Syntax

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

Beschreibung

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

Beispiele

Beispiel 1: Schreiben einer Warnmeldung

Dieser Befehl zeigt die Meldung "WARNUNG: Dies ist nur eine Testwarnung" an.

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 zu Write-Warningsenden. Sie können die Zeichenfolge wie in diesem Befehl gezeigt 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 variablen $WarningPreference und Schreiben einer Warnung

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

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 $WarningPreference Variablen an, nämlich Continue. Beim Schreiben einer Warnung wird daher 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. Ein Wert von SilentlyContinue unterdrückt die Warnung. 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 allgemeinen WarningAction-Parameters auf einen Write-Warning Befehl veranschaulicht. Sie können den allgemeinen WarningAction-Parameter mit einem beliebigen Cmdlet verwenden, um zu bestimmen, wie PowerShell auf Warnungen reagiert, die sich aus diesem Befehl ergeben. Der allgemeine WarningAction-Parameter überschreibt den Wert von $WarningPreference only für diesen bestimmten Befehl.

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 Write-Warning Cmdlet, um eine Warnung anzuzeigen. Der allgemeine WarningAction-Parameter mit dem Wert Inquire weist das System an, den Benutzer aufzufordern, wenn der Befehl eine Warnung anzeigt.

Weitere Informationen zum allgemeinen WarningAction-Parameter finden Sie unter about_CommonParameters.

Parameter

-Message

Gibt die Warnmeldung an.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

String

Sie können eine Zeichenfolge, die die Warnung enthält, an übergeben Write-Warning.

Ausgaben

None

Write-Warning schreibt nur in den Warnungsstream. Es generiert keine andere Ausgabe.

Hinweise

Der Standardwert für die $WarningPreference Variable ist Continue, was die Warnung anzeigt und dann die Ausführung des Befehls fortsetzt. Um gültige Werte für eine Einstellungsvariable wie $WarningPreferencezu bestimmen, legen Sie sie auf eine Zeichenfolge zufälliger Zeichen fest, z. B. "abc". In der resultierenden Fehlermeldung werden die gültigen Werte aufgelistet.