Write-Warning

Write-Warning
    [-Message] <String>
    [<CommonParameters>]

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.

Mit diesem Befehl wird die Meldung "WARNUNG: Dies ist nur eine Testwarnung" angezeigt.

Write-Warning "This is only a test 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

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.

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.

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.

Sie können eine Zeichenfolge, die die Warnung enthält, über die Pipeline an Write-Warning.

Write-Warning schreibt nur in den Warndatenstrom. Es wird keine andere Ausgabe generiert.

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.