Dela via

Write-Warning

  • Referens
Modul:
Microsoft.PowerShell.Utility

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 common-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 värdet för variabeln $WarningPreference 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 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."

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. Ett värde för SilentlyContinue utelämnar varningen. Värdet Stop visar varningen och stoppar sedan körningen av kommandot.

Mer information om variabeln finns i $WarningPreferenceabout_Preference_Variables.

Exempel 4: Ange parametern WarningAction och skriv en varning

Det här exemplet visar effekten av common-parametern WarningAction på ett Write-Warning kommando. Du kan använda common-parametern WarningAction med valfri cmdlet för att avgöra hur PowerShell svarar på varningar från det kommandot. Common 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 fråga användaren när kommandot visar en varning.

Mer information om common-parametern WarningAction finns i about_CommonParameters.

Parametrar

-Message

Anger varningsmeddelandet.

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

Indata

String

Du kan skicka en sträng som innehåller varningen till Write-Warning.

Utdata

None

Write-Warning skriver bara till varningsströmmen. Det genererar inga andra utdata.

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.