Write-Warning

Artikel
10/30/2009

Schreibt eine Warnmeldung.

Syntax

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

Beschreibung

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

Parameter

-Message <string>

Gibt die Warnmeldung an.

Erforderlich?	true
Position?	1
Standardwert
Pipelineeingaben akzeptieren?	true (ByValue)
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

System.String

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

Ausgaben

Keiner

Write-Warning schreibt nur in den Warnstream. Es wird keine weitere Ausgabe generiert.

Hinweise

Der Standardwert für die Variable "$WarningPreference" ist "Continue", mit dem die Warnung angezeigt und die Ausführung des Befehls fortgesetzt wird. Um gültige Werte für eine Einstellungsvariable wie "$WarningPreference" zu bestimmen, können Sie sie auf eine Zeichenfolge mit nach dem Zufallsprinzip ausgewählten Zeichen, z. B. "abc", festlegen. In der resultierenden Fehlermeldung werden die gültigen Werte aufgelistet.

Beispiel 1

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

Beschreibung
-----------
Mit diesem Befehl wird die Meldung "WARNING: This is only a test warning" angezeigt.

Beispiel 2

C:\PS>$w = "This is only a test warning."

C:\PS> $w | write-warning

Beschreibung
-----------
In diesem Beispiel wird gezeigt, dass eine Zeichenfolge mithilfe eines Pipelineoperators (|) an Write-Warning gesendet werden kann. Sie können die Zeichenfolge wie in diesem Befehl in einer Variablen speichern oder die Zeichenfolge direkt über die Pipeline an Write-Warning übergeben.

Beispiel 3

C:\PS>$warningpreference

Continue

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

C:\PS> $warningpreference = "SilentlyContinue"

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

C:\PS> $warningpreference = "Stop"

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

Beschreibung
-----------
In diesem Beispiel werden die Auswirkungen der Variablen "$WarningPreference" im Befehl "Write-Warning" veranschaulicht.

Im ersten Befehl wird der Standardwert "Continue" der Variablen "$WarningPreference" angezeigt. Wenn Sie eine Warnung schreiben, wird daher eine Warnmeldung angezeigt und die Ausführung fortgesetzt.

Wenn Sie den Wert der Variablen "$WarningPreference" ändern, ändert sich die Auswirkung des Befehls "Write-Warning" erneut. Mit dem Wert "SilentlyContinue" wird die Warnung unterdrückt. Mit dem Wert "Stop" wird die Warnung angezeigt und anschließend die Ausführung des Befehls angehalten.

Weitere Informationen über die Variable "$WarningPreference" finden Sie unter "about_Preference_Variables".

Beispiel 4

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

Beschreibung
-----------
Dieses Beispiel veranschaulicht die Auswirkungen des allgemeinen WarningAction-Parameters im Befehl "Write-Warning". Sie können den allgemeinen WarningAction-Parameter mit einem beliebigen Cmdlet verwenden, um zu bestimmen, wie Windows PowerShell auf Warnungen reagiert, die durch diesen Befehl verursacht werden. Der allgemeine WarningAction-Parameter überschreibt den Wert von $WarningPreference nur für diesen spezifischen Befehl.

Dieser Befehl zeigt Warnungen mit dem Cmdlet "Write-Warning" an. Der allgemeine WarningAction-Parameter mit dem Wert "Inquire" legt fest, dass das System den Benutzer zu einer Aktion auffordert, wenn der Befehl eine Warnung anzeigt.

Weitere Informationen über den allgemeinen WarningAction-Parameter finden Sie unter "about_CommonParameters".

Siehe auch

Konzepte

about_Preference_Variables
about_Commonparameters
Write-Debug
Write-Error
Write-Host
Write-Output
Write-Progress
Write-Verbose

Freigeben über