Write-Warning
Zapíše zprávu s upozorněním.
Syntaxe
Default (Výchozí)
Write-Warning
[-Message] <String>
[<CommonParameters>]
Description
Cmdlet Write-Warning zapíše varovnou zprávu do hostitele PowerShellu. Odpověď na upozornění závisí na hodnotě proměnné $WarningPreference uživatele a použití běžného parametru WarningAction.
Příklady
Příklad 1: Napsání zprávy s upozorněním
Tento příkaz zobrazí zprávu UPOZORNĚNÍ: Toto je pouze testovací upozornění.
Write-Warning "This is only a test warning."
Příklad 2: Předání řetězce Write-Warning
Tento příkaz ukazuje, že můžete použít operátor kanálu (|) k odeslání řetězce do Write-Warning.
Řetězec můžete uložit do proměnné, jak je znázorněno v tomto příkazu, nebo řetězec předat přímo do Write-Warning.
$w = "This is only a test warning."
$w | Write-Warning
Příklad 3: Nastavení proměnné $WarningPreference a zápis upozornění
Tento příklad ukazuje účinek hodnoty proměnné $WarningPreference na příkaz Write-Warning.
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.
První příkaz zobrazí výchozí hodnotu proměnné $WarningPreference, která je Continue. V důsledku toho se, když zadáte upozornění, zobrazí zpráva s upozorněním a pak pokračuje provádění.
Když změníte hodnotu proměnné $WarningPreference, efekt příkazu Write-Warning se znovu změní. Hodnota SilentlyContinue potlačí upozornění. Hodnota Stop zobrazí upozornění a pak zastaví spuštění příkazu.
Další informace o proměnné $WarningPreference naleznete v tématu about_Preference_Variables.
Příklad 4: Nastavení parametru WarningAction a zápis upozornění
Tento příklad ukazuje účinek společného parametru WarningAction na příkaz Write-Warning. Pomocí společného parametru WarningAction u libovolného cmdletu můžete určit, jak PowerShell reaguje na varování vznikající z tohoto příkazu.
WarningAction společný parametr nahradí hodnotu $WarningPreference pouze pro tento příkaz konkrétně.
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"):
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 společném parametru WarningAction naleznete v tématu about_CommonParameters.
Parametry
-Message
Určuje zprávu upozornění.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Msg |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
Řetězec, který obsahuje upozornění, můžete přesměrovat do této rutiny.
Výstupy
None
Tento cmdlet nevrátí žádný výstup. Zapisuje se jenom do datového proudu upozornění.
Poznámky
Výchozí hodnota proměnné $WarningPreference je Continue, která zobrazí upozornění a pak pokračuje v provádění příkazu. Chcete-li určit platné hodnoty pro proměnnou předvoleb, například $WarningPreference, nastavte ji na řetězec náhodných znaků, například "abc". Výsledná chybová zpráva obsahuje platné hodnoty.
