Write-Warning
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-Warning
senden.
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
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 $WarningPreference
zu bestimmen, legen Sie sie auf eine Zeichenfolge zufälliger Zeichen fest, z. B. "abc". In der resultierenden Fehlermeldung werden die gültigen Werte aufgelistet.