ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2009 Microsoft Corporation.

C:\Windows-7>Powershell get-help Write-Warning -full

NAME
Write-Warning

# ÜBERSICHT
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 folgende allgemeine Parameter: "Verbose", "Debug",
"ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable",
"OutBuffer" und "OutVariable". Weitere Informationen
erhalten Sie mit dem Befehl "get-help about_commonparameters".

# 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".

VERWANDTE LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=113430 (möglicherweise auf Englisch)
about_Preference_Variables
about_CommonParameters
Write-Debug
Write-Error
Write-Host
Write-Output
Write-Progress
Write-Verbose

C:\Windows>powershell get-help Write-Error -full