Write-Warning
Figyelmeztető üzenetet ír.
Syntax
Default (Alapértelmezett)
Write-Warning
[-Message] <String>
[<CommonParameters>]
Description
A Write-Warning parancsmag figyelmeztető üzenetet ír a Windows PowerShell gazdagépnek. A figyelmeztetésre adott válasz a felhasználó $WarningPreference változójának értékétől és a WarningAction közös paraméter használatától függ.
Példák
1. példa: Figyelmeztető üzenet írása
PS C:\> Write-Warning "This is only a test warning."
Ez a parancs a következő üzenetet jeleníti meg: "FIGYELMEZTETÉS: Ez csak tesztriasztás".
2. példa: Karakterlánc átadása Write-Warning
PS C:\> $w = "This is only a test warning."
PS C:\> $w | Write-Warning
Ez a parancs azt mutatja, hogy egy folyamatoperátorral (|) sztringet küldhet a Write-Warning. A sztringet mentheti egy változóba, ahogy az ebben a parancsban is látható, vagy közvetlenül a Write-Warning karakterláncba továbbíthatja.
3. példa: A $WarningPreference változó beállítása és figyelmeztetés írása
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."
Ez a példa a változó értékének $WarningPreference hatását mutatja be egy Write-Warning parancsra.
Az első parancs a $WarningPreference változó alapértelmezett értékét jeleníti meg, amely a Folytatás. Ennek eredményeképpen figyelmeztetés írásakor megjelenik a figyelmeztető üzenet, és a végrehajtás folytatódik.
Ha módosítja a $WarningPreference változó értékét, a Write-Warning parancs hatása ismét megváltozik. A SilentlyContinue értéke letiltja a figyelmeztetést. A Stop érték megjeleníti a figyelmeztetést, majd leállítja a parancs végrehajtását.
A $WarningPreference változóval kapcsolatos további információkért lásd: about_Preference_Variables.
4. példa: A WarningAction paraméter beállítása és figyelmeztetés írása
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"):
Ez a példa a WarningAction közös paraméter hatását mutatja be egy Write-Warning parancsra. A WarningAction közös paraméterrel bármely parancsmaggal meghatározhatja, hogy a Windows PowerShell hogyan reagál a parancsból eredő figyelmeztetésekre. A WarningAction közös paraméter csak az adott parancs $WarningPreference értékét bírálja felül.
Ez a parancs a Write-Warning parancsmaggal jelenít meg figyelmeztetést. A WarningAction közös paraméter Lekérdezés értékkel arra utasítja a rendszert, hogy kérdezze meg a felhasználót, amikor a parancs figyelmeztetést jelenít meg.
További információ a WarningAction közös paraméterről: about_CommonParameters.
Paraméterek
-Message
Meghatározza a figyelmeztető üzenetet.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Msg |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
String
A figyelmeztetést tartalmazó sztringet átirányíthatja a Write-Warning .
Kimenetek
None
Write-Warning csak a figyelmeztető streambe ír. Nem hoz létre más kimenetet.
Jegyzetek
A $WarningPreference változó alapértelmezett értéke a Folytatás, amely megjeleníti a figyelmeztetést, majd folytatja a parancs végrehajtását. Ha egy beállítási változó (például $WarningPreference) érvényes értékeit szeretné meghatározni, állítsa be véletlenszerű karakterekből álló sztringre, például az "abc"-ra. Az eredményként kapott hibaüzenet felsorolja az érvényes értékeket.