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 $WarningPreference
Benutzers und der Verwendung des allgemeinen Parameters WarningAction ab.
Beispiele
Beispiel 1: Schreiben einer Warnmeldung
Mit diesem Befehl wird die Meldung "WARNUNG: Dies ist nur eine Testwarnung" angezeigt.
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-Warning
Sie können die Zeichenfolge wie in diesem Befehl dargestellt in einer Variablen speichern oder die Zeichenfolge direkt an Write-Warning
die Zeichenfolge ü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 der Effekt 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, also 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, der SilentlyContinue
die Warnung unterdrückt. Ein Wert von Stop
zeigt die Warnung an und beendet dann die Ausführung des Befehls.
Weitere Informationen zur Variable $WarningPreference
finden Sie unter about_Preference_Variables.
Beispiel 4: Festlegen des WarningAction-Parameters und Schreiben einer Warnung
Dieses Beispiel zeigt die Auswirkung des allgemeinen WarningAction-Parameters auf einen Write-Warning
Befehl. Sie können den allgemeinen Parameter WarningAction mit jedem Cmdlet verwenden, um zu bestimmen, wie PowerShell auf Warnungen reagiert, die sich aus diesem Befehl ergeben. Der allgemeine WarningAction-Parameter überschreibt den Wert des $WarningPreference
einzigen 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 dem Wert "Inquire" leitet 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.
Typ: | String |
Aliase: | Msg |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Sie können eine Zeichenfolge weiterleiten, die die Warnung an dieses Cmdlet enthält.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück. Er schreibt nur in den Warndatenstrom.
Hinweise
Der Standardwert für die $WarningPreference
Variable lautet Continue
, wodurch die Warnung angezeigt wird, und führt dann die Ausführung des Befehls fort. Um gültige Werte für eine Einstellungsvariable $WarningPreference
wie z. B. festzulegen, legen Sie sie auf eine Zeichenfolge zufälliger Zeichen fest, z. B. "abc". Die resultierende Fehlermeldung listet die gültigen Werte auf.
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für