Freigeben über

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 "WARNING: This is only a test warning" (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 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 $WarningPreference Variablen 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, der lautet 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. Der Wert zeigt Stop 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 nur für diesen $WarningPreference 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 dieses Cmdlet übergeben.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück. Es wird nur in den Warnungsstream geschrieben.

Hinweise

Der Standardwert für die $WarningPreference Variable ist , wodurch die Warnung angezeigt wird und dann die Ausführung des Befehls fortgesetzt wird Continue. Um gültige Werte für eine Einstellungsvariable wie $WarningPreferencezu bestimmen, legen Sie sie auf eine Zeichenfolge mit zufälligen Zeichen fest, z. B. "abc". Die resultierende Fehlermeldung listet die gültigen Werte auf.