Write-Warning

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

Cmdleten Write-Warning skriver ett varningsmeddelande till PowerShell-värdmiljön. Svaret på varningen beror på värdet för användarens $WarningPreference variabel och användningen av WarningAction gemensam parameter.

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

Write-Warning "This is only a test 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

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.

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.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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

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

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.