Write-Warning
Schreibt eine Warnmeldung.
Syntax
Default (Standardwert)
Write-Warning
[-Message] <String>
[<CommonParameters>]
Beschreibung
Das Cmdlet Write-Warning schreibt eine Warnmeldung für den PowerShell-Host. Die Reaktion auf die Warnung hängt sowohl vom Wert der $WarningPreference-Variablen des Benutzers als auch von der Anwendung 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-Warningzu senden.
Sie können die Zeichenfolge wie in diesem Befehl dargestellt 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 variablen $WarningPreference auf einen Write-Warning-Befehl gezeigt.
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 variablen $WarningPreference an, die 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 die Auswirkung des Write-Warning Befehls erneut. Der Wert SilentlyContinue unterdrückt die Warnung. 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 für einen Write-Warning-Befehl. Sie können den WarningAction allgemeinen Parameter 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 von $WarningPreference nur für diesen speziellen 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 Cmdlet Write-Warning, um eine Warnung anzuzeigen. Der allgemeine WarningAction-Parameter mit dem Wert „Inquire“ weist das System an, den Benutzer zur Eingabe aufzufordern, wenn der Befehl eine Warnung anzeigt.
Weitere Informationen zum allgemeinen WarningAction-Parameter finden Sie unter about_CommonParameters.
Parameter
-Message
Gibt die Warnmeldung an.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Msg |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
String
Sie können eine Zeichenfolge, die die Warnung enthält, an dieses Cmdlet weiterreichen.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück. Es schreibt nur in den Warnungsstream.
Hinweise
Der Standardwert für die variable $WarningPreference ist Continue, wodurch die Warnung angezeigt wird und anschließend der Befehl weiterhin ausgeführt wird. Um gültige Werte für eine Einstellungsvariable wie $WarningPreferencezu bestimmen, legen Sie sie auf eine Zeichenfolge zufälliger Zeichen fest, z. B. "abc". Die resultierende Fehlermeldung listet die gültigen Werte auf.
