Write-Warning
Hiermee schrijft u een waarschuwingsbericht.
Syntax
Default (Standaard)
Write-Warning
[-Message] <String>
[<CommonParameters>]
Description
De Write-Warning cmdlet schrijft een waarschuwingsbericht naar de PowerShell-host. Het antwoord op de waarschuwing is afhankelijk van de waarde van de variabele van de gebruiker $WarningPreference en het gebruik van de algemene parameter WarningAction .
Voorbeelden
Voorbeeld 1: Een waarschuwingsbericht schrijven
Met deze opdracht wordt het bericht 'WAARSCHUWING: dit is alleen een testwaarschuwing' weergegeven.
Write-Warning "This is only a test warning."
Voorbeeld 2: Een tekenreeks doorgeven aan Write-Warning
Met deze opdracht ziet u dat u een pijplijnoperator (|) kunt gebruiken om een tekenreeks naar te Write-Warningverzenden.
U kunt de tekenreeks opslaan in een variabele, zoals wordt weergegeven in deze opdracht, of de tekenreeks rechtstreeks doorsluisen naar Write-Warning.
$w = "This is only a test warning."
$w | Write-Warning
Voorbeeld 3: De $WarningPreference-variabele instellen en een waarschuwing schrijven
In dit voorbeeld ziet u het effect van de waarde van de $WarningPreference variabele op een Write-Warning opdracht.
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.
Met de eerste opdracht wordt de standaardwaarde van de $WarningPreference variabele weergegeven.Continue Als u een waarschuwing schrijft, wordt het waarschuwingsbericht weergegeven en wordt de uitvoering voortgezet.
Wanneer u de waarde van de $WarningPreference variabele wijzigt, wordt het effect van de Write-Warning opdracht opnieuw gewijzigd. Een waarde voor het onderdrukken van SilentlyContinue de waarschuwing. Een waarde van het weergeven van Stop de waarschuwing en de uitvoering van de opdracht wordt gestopt.
Zie $WarningPreferencevoor meer informatie over de variabele .
Voorbeeld 4: De parameter WarningAction instellen en een waarschuwing schrijven
In dit voorbeeld ziet u het effect van de algemene parameter WarningAction op een Write-Warning opdracht. U kunt de algemene parameter WarningAction met elke cmdlet gebruiken om te bepalen hoe PowerShell reageert op waarschuwingen die voortvloeien uit die opdracht. De algemene parameter WarningAction overschrijft de waarde van de $WarningPreference enige voor die specifieke opdracht.
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"):
Met deze opdracht wordt de Write-Warning cmdlet gebruikt om een waarschuwing weer te geven. De algemene parameter WarningAction met een waarde van Inquire stuurt het systeem om de gebruiker te vragen wanneer de opdracht een waarschuwing weergeeft.
Zie about_CommonParameters voor meer informatie over de algemene parameter WarningAction.
Parameters
-Message
Hiermee geeft u het waarschuwingsbericht.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Msg |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
String
U kunt een tekenreeks met de waarschuwing voor deze cmdlet doorsluisen.
Uitvoerwaarden
None
Deze cmdlet retourneert geen uitvoer. Het schrijft alleen naar de waarschuwingsstroom.
Notities
De standaardwaarde voor de $WarningPreference variabele is Continue, die de waarschuwing weergeeft en vervolgens doorgaat met het uitvoeren van de opdracht. Als u geldige waarden wilt bepalen voor een voorkeursvariabele zoals $WarningPreference, stelt u deze in op een tekenreeks met willekeurige tekens, zoals 'abc'. Het resulterende foutbericht bevat de geldige waarden.