Sdílet prostřednictvím

Write-Warning

  • Reference
Modul:
Microsoft.PowerShell.Utility

Zapíše zprávu s upozorněním.

Syntaxe

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

Description

Rutina Upozornění na zápis zapíše do hostitele Windows PowerShellu zprávu s upozorněním. Odpověď na upozornění závisí na hodnotě proměnné $WarningPreference uživatele a použití WarningAction společný parametr.

Příklady

Příklad 1: Napsání zprávy s upozorněním

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

Tento příkaz zobrazí zprávu UPOZORNĚNÍ: Toto je pouze testovací upozornění.

Příklad 2: Předání řetězce Write-Warning

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

Tento příkaz ukazuje, že pomocí operátoru kanálu (|) můžete odeslat řetězec do upozornění zápisu. Řetězec můžete uložit do proměnné, jak je znázorněno v tomto příkazu, nebo řetězec předvést přímo do upozornění zápisu .

Příklad 3: Nastavení proměnné $WarningPreference a zápis upozornění

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

Tento příklad ukazuje účinek hodnoty proměnné $WarningPreference na příkaz Write-Warning.

První příkaz zobrazí výchozí hodnotu proměnné $WarningPreference, což je Continue. V důsledku toho se při psaní upozornění zobrazí zpráva s upozorněním a bude pokračovat spuštění.

Když změníte hodnotu proměnné $WarningPreference, změní se efekt Upozornění zápisu příkaz znovu. Hodnota SilentlyContinue potlačí upozornění. Hodnota Stop zobrazí upozornění a pak zastaví spuštění příkazu.

Další informace o proměnné $WarningPreference najdete v tématu about_Preference_Variables.

Příklad 4: Nastavení parametru WarningAction a zápis upozornění

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

Tento příklad ukazuje účinek WarningAction společný parametr na příkaz Write-Warning. Pomocí WarningAction společný parametr s libovolnou rutinou můžete určit, jak Windows PowerShell reaguje na upozornění vyplývající z daného příkazu. WarningAction společný parametr přepíše hodnotu $WarningPreference pouze pro tento konkrétní příkaz.

Tento příkaz používá rutinu Write-Warning k zobrazení upozornění. WarningAction společný parametr s hodnotou Inquire směruje systém k zobrazení výzvy uživateli, když příkaz zobrazí upozornění.

Další informace o WarningAction společný parametr najdete v tématu about_CommonParameters.

Parametry

-Message

Určuje zprávu upozornění.

Typ:String
Aliasy:Msg
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

String

Řetězec, který obsahuje upozornění, můžete převést na upozornění zápisu .

Výstupy

None

upozornění na zápis zapisuje pouze do datového proudu upozornění. Nevygeneruje žádný jiný výstup.

Poznámky

  • Výchozí hodnota proměnné $WarningPreference je Continue, která zobrazí upozornění a pak pokračuje v provádění příkazu. Pokud chcete určit platné hodnoty pro proměnnou předvoleb, jako je například $WarningPreference, nastavte ji na řetězec náhodných znaků, například "abc". Výsledná chybová zpráva zobrazí seznam platných hodnot.