Write-Warning

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

Das Cmdlet Schreibwarnung schreibt eine Warnmeldung auf den Windows PowerShell-Host. Die Antwort auf die Warnung hängt vom Wert der $WarningPreference Variablen des Benutzers und der Verwendung des WarningAction allgemeinen Parameters ab.

PS C:\> Write-Warning "This is only a test warning."

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

PS C:\> $w = "This is only a test warning."
PS C:\> $w | 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.

PS C:\> $warningpreference
Continue PS C:\> Write-Warning "This is only a test warning."
This is only a test warning. PS C:\> $warningpreference = "SilentlyContinue"
PS C:\> Write-Warning "This is only a test warning."
PS C:\>
PS C:\> $warningpreference = "Stop"
PS C:\> Write-Warning "This is only a test warning."
WARNING: This is only a test message.
Write-Warning : Command execution stopped because the shell variable "WarningPreference" is set to Stop.
At line:1 char:14
     + Write-Warning <<<<  "This is only a test message."

In diesem Beispiel wird die Auswirkung des Werts der $WarningPreference Variablen auf einen Befehl "Write-Warning" gezeigt.

Der erste Befehl zeigt den Standardwert der variablen $WarningPreference an, die "Weiter" lautet. 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.

PS C:\> 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"):

In diesem Beispiel wird die Auswirkung des WarningAction- allgemeinen Parameters auf einen Befehl "Write-Warning" gezeigt. Sie können den WarningAction allgemeinen Parameter mit jedem Cmdlet verwenden, um zu bestimmen, wie Windows PowerShell auf Warnungen reagiert, die sich aus diesem Befehl ergeben. Der WarningAction allgemeiner Parameter überschreibt den Wert des $WarningPreference nur für diesen bestimmten Befehl.

Dieser Befehl verwendet das Cmdlet Schreibwarnung, 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 WarningAction- allgemeinen 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, an Write-Warningweitergeleitet werden.

Schreibwarnung schreibgeschützt nur in den Warndatenstrom. Es wird keine andere Ausgabe generiert.

• Der Standardwert für die variable $WarningPreference ist "Weiter", der die Warnung anzeigt und dann den Befehl weiter ausführt. 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". Die resultierende Fehlermeldung listet die gültigen Werte auf.