Write-Warning
Figyelmeztető üzenetet ír.
Syntax
Default (Alapértelmezett)
Write-Warning
[-Message] <String>
[<CommonParameters>]
Description
A Write-Warning parancsmag figyelmeztető üzenetet ír a PowerShell-gazdagépnek. A figyelmeztetésre adott válasz a felhasználó $WarningPreference változójának értékétől és a WarningAction gyakori paraméterétől függ.
Példák
1. példa: Figyelmeztető üzenet írása
Ez a parancs a következő üzenetet jeleníti meg: "FIGYELMEZTETÉS: Ez csak tesztriasztás".
Write-Warning "This is only a test warning."
2. példa: Karakterlánc átadása Write-Warning
Ez a parancs azt mutatja, hogy egy csővezeték operátor (|) használatával karakterláncot küldhet Write-Warning.
A karakterláncot mentheti egy változóba, ahogyan az ebben a parancsban látható, vagy közvetlenül irányíthatja a Write-Warning-ra.
$w = "This is only a test warning."
$w | Write-Warning
3. példa: A $WarningPreference változó beállítása és figyelmeztetés írása
Ez a példa a $WarningPreference változó értékének hatását mutatja be egy Write-Warning parancsra.
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.
Az első parancs megjeleníti a $WarningPreference változó alapértelmezett értékét, amely Continue. Ennek eredményeképpen figyelmeztetés írásakor megjelenik a figyelmeztető üzenet, és a végrehajtás folytatódik.
A $WarningPreference változó értékének módosításakor a Write-Warning parancs hatása újra megváltozik. A SilentlyContinue értéke letiltja a figyelmeztetést. A Stop értéke 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
Ez a példa a WarningAction gyakori paraméter hatását mutatja be egy Write-Warning parancsra. A WarningAction gyakori paraméterrel bármely parancsmaggal meghatározhatja, hogyan reagál a PowerShell az adott parancsból eredő figyelmeztetésekre. A WarningAction gyakori paraméter csak az adott parancsra írja felül a $WarningPreference értékét.
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"):
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 gyakori 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 parancsmagra figyelmeztetést tartalmazó sztringet csövezhet.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet. Csak a figyelmeztető streamre ír.
Jegyzetek
A $WarningPreference változó alapértelmezett értéke Continue, 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 egy 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.
