Write-Warning
Skriver ett varningsmeddelande.
Syntax
Default (Standard)
Write-Warning
[-Message] <String>
[<CommonParameters>]
Description
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.
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
Anger att varningsmeddelandet.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Msg |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
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.
Indata
String
Du kan skicka en sträng som innehåller varningen till Write-Warning.
Utdata
None
Write-Warning Skriver endast 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 som $WarningPreferenceanger du den till en sträng med slumpmässiga tecken, till exempel "abc". Det resulterande felmeddelandet visar giltiga värden.