Write-Warning

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Figyelmeztető üzenetet ír.

Syntax

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 közös 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: Sztring átadása írási figyelmeztetésnek

Ez a parancs azt mutatja, hogy egy folyamatkezelővel (|) sztringet küldhet a rendszernek Write-Warning. A sztringet mentheti egy változóba, ahogyan az ebben a parancsban látható, vagy közvetlenül a következőre Write-Warningirányítja a sztringet.

$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 változó értékének $WarningPreference egy parancsra Write-Warning gyakorolt hatását mutatja be.

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 változó alapértelmezett értékét, azaz a $WarningPreferenceContinue. Ennek eredményeképpen figyelmeztetés írásakor megjelenik a figyelmeztető üzenet, és a végrehajtás folytatódik.

A változó értékének $WarningPreference módosításakor a Write-Warning parancs hatása ismét megváltozik. Egy érték SilentlyContinue letiltja a figyelmeztetést. Egy érték Stop megjeleníti a figyelmeztetést, majd leállítja a parancs végrehajtását.

A változóval kapcsolatos további információkért lásd: $WarningPreference 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 common paraméter parancsra Write-Warning gyakorolt hatását mutatja be. A WarningAction common paramétert bármely parancsmaggal használhatja annak meghatározásához, hogy a PowerShell hogyan reagál az adott parancsból eredő figyelmeztetésekre. A WarningAction common paraméter felülírja az $WarningPreference adott parancs egyetlen elemének é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 egy figyelmeztetést. Az Inquire értékkel rendelkező WarningAction gyakori paraméter arra utasítja a rendszert, hogy kérje meg a felhasználót, amikor a parancs figyelmeztetést jelenít meg.

A WarningAction gyakori paraméterével kapcsolatos további információkért lásd: about_CommonParameters.

Paraméterek

-Message

Megadja a figyelmeztető üzenetet.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

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 változó Continuealapértelmezett értéke az$WarningPreference, amely megjeleníti a figyelmeztetést, majd folytatja a parancs végrehajtását. A beállítási változók érvényes értékeinek (például $WarningPreferencea "abc") meghatározásához állítsa be véletlenszerű karakterekből álló sztringre. Az eredményként kapott hibaüzenet felsorolja az érvényes értékeket.