Dela via


Write-Warning

Skriver ett varningsmeddelande.

Syntax

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

Description

Cmdleten Write-Warning skriver ett varningsmeddelande till PowerShell-värden. Svaret på varningen beror på värdet för användarens $WarningPreference variabel och användningen av den vanliga parametern WarningAction .

Exempel

Exempel 1: Skriva ett varningsmeddelande

Det här kommandot visar meddelandet "VARNING: Det här är bara en testvarning".

Write-Warning "This is only a test warning."

Exempel 2: Skicka en sträng till Write-Warning

Det här kommandot visar att du kan använda en pipelineoperator (|) för att skicka en sträng till Write-Warning. Du kan spara strängen i en variabel, som du ser i det här kommandot, eller skicka strängen direkt till Write-Warning.

$w = "This is only a test warning."
$w | Write-Warning

Exempel 3: Ange variabeln $WarningPreference och skriv en varning

Det här exemplet visar effekten av variabelns $WarningPreference värde på ett Write-Warning kommando.

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.

Det första kommandot visar standardvärdet för variabeln $WarningPreference , som är Continue. När du skriver en varning visas därför varningsmeddelandet och körningen fortsätter.

När du ändrar värdet för variabeln $WarningPreference ändras effekten av Write-Warning kommandot igen. Värdet SilentlyContinue för undertrycker varningen. Värdet Stop visar varningen och stoppar sedan körningen av kommandot.

Mer information om variabeln finns i $WarningPreference about_Preference_Variables.

Exempel 4: Ange parametern WarningAction och skriv en varning

Det här exemplet visar effekten av den vanliga parametern WarningAction på ett Write-Warning kommando. Du kan använda den vanliga parametern WarningAction med valfri cmdlet för att avgöra hur PowerShell svarar på varningar från kommandot. Den vanliga parametern WarningAction åsidosätter värdet för det $WarningPreference enda för det specifika kommandot.

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

Det här kommandot använder cmdleten Write-Warning för att visa en varning. Den vanliga parametern WarningAction med värdet Inquire instruerar systemet att uppmana användaren när kommandot visar en varning.

Mer information om den vanliga parametern WarningAction finns i about_CommonParameters.

Parametrar

-Message

Anger varningsmeddelandet.

Typ:String
Alias:Msg
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

String

Du kan skicka en sträng som innehåller varningen till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata. Den skriver endast till varningsströmmen.

Kommentarer

Standardvärdet för variabeln $WarningPreference är Continue, som visar varningen och sedan fortsätter att köra kommandot. Om du vill fastställa giltiga värden för en inställningsvariabel, till exempel $WarningPreference, anger du den till en sträng med slumpmässiga tecken, till exempel "abc". Det resulterande felmeddelandet visar giltiga värden.