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 Windows PowerShell-värden. Svaret på varningen beror på värdet för användarens $WarningPreference variabel och användningen av WarningAction gemensam parameter.

Exempel

Exempel 1: Skriva ett varningsmeddelande

PS C:\> Write-Warning "This is only a test warning."

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

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

PS C:\> $w = "This is only a test warning."
PS C:\> $w | 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.

Exempel 3: Ange variabeln $WarningPreference och skriv en varning

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."

Det här exemplet visar effekten av värdet för variabeln $WarningPreference på ett write-warning kommando.

Det första kommandot visar standardvärdet för variabeln $WarningPreference, som är Fortsätt. 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 kommandot Write-Warning igen. Värdet SilentlyContinue undertrycker varningen. Värdet Stopp visar varningen och stoppar sedan körningen av kommandot.

Mer information om variabeln $WarningPreference finns i about_Preference_Variables.

Exempel 4: Ange parametern WarningAction och skriv en varning

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

Det här exemplet visar effekten av WarningAction gemensam parameter på ett write-warning kommando. Du kan använda WarningAction gemensam parameter med valfri cmdlet för att avgöra hur Windows PowerShell svarar på varningar från kommandot. Den WarningAction gemensamma parametern åsidosätter endast värdet för $WarningPreference för det specifika kommandot.

Det här kommandot använder cmdleten Write-Warning för att visa en varning. WarningAction gemensam parameter med värdet Inquire instruerar systemet att fråga användaren när kommandot visar en varning.

Mer information om WarningAction gemensam parameter 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 Write-Warning.

Utdata

None

Skrivvarning skrivs endast till varningsströmmen. Det genererar inga andra utdata.

Kommentarer

  • Standardvärdet för variabeln $WarningPreference är Fortsätt, 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.