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-WarningBeispiel 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 |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Eingaben
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.