Write-Warning

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 WarningAction gemensam parameter.

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 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 kommandot Write-Warning igen. Värdet SilentlyContinue undertrycker varningen. Värdet Stop 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

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 PowerShell svarar på varningar från kommandot. Den WarningAction gemensamma parametern åsidosätter endast värdet för $WarningPreference 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. 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

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 som $WarningPreferenceanger du den till en sträng med slumpmässiga tecken, till exempel "abc". Det resulterande felmeddelandet visar giltiga värden.

Relaterade länkar

• about_Output_Streams
• about_Redirection
• Write-Debug
• Write-Error
• Write-Host
• Write-Information
• Write-Output
• Write-Progress
• Write-Verbose