Write-Warning

Schreibt eine Warnmeldung.

Syntax

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

Beschreibung

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

Beispiele

Beispiel 1: Schreiben einer Warnmeldung

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

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 in einer Variable speichern, wie in diesem Befehl dargestellt, oder die Zeichenfolge direkt an Write-Warningdie Zeichenfolge übergeben.

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

Beispiel 3: Festlegen der $WarningPreference-Variable und Schreiben einer Warnung

In diesem Beispiel wird der Effekt des Werts der $WarningPreference Variable auf einem Write-Warning Befehl dargestellt.

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 Variable an, was Continueist . 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 der Effekt des Write-Warning Befehls erneut. Ein Wert, der SilentlyContinue die Warnung unterdrückt. Ein Wert, der Stop die Warnung anzeigt und dann die Ausführung des Befehls beendet.

Weitere Informationen zu der $WarningPreference Variablen finden Sie unter about_Preference_Variables.

Beispiel 4: Festlegen des Warnungsparameters und Schreiben einer Warnung

In diesem Beispiel wird der Effekt des allgemeinen Parameters " WarningAction " auf einem Write-Warning Befehl dargestellt. Sie können den gängigen Parameter "WarningAction " mit jedem Cmdlet verwenden, um zu bestimmen, wie PowerShell auf Warnungen reagiert, die aus diesem Befehl stammen. Der allgemeine Parameter "WarningAction " überschreibt den Wert nur $WarningPreference 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 Parameter " WarningAction " mit einem Wert von "Inquire" leitet das System an, um den Benutzer einzufordern, wenn der Befehl eine Warnung anzeigt.

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

Parameter

-Message

Gibt die Warnmeldung an.

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

Eingaben

String

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

Ausgaben

None

Write-Warning schreibt nur auf den Warnungsdatenstrom. Es generiert keine andere Ausgabe.

Hinweise

Der Standardwert für die $WarningPreference Variable lautet Continue, die die Warnung anzeigt und dann den Befehl ausführt. Um gültige Werte für eine Einstellungsvariable wie z. B. eine Zeichenfolge zufälliger Zeichen festzulegen, z $WarningPreference. B. "abc". Die resultierende Fehlermeldung enthält die gültigen Werte.