Write-Warning
Hiermee wordt een waarschuwingsbericht geschreven.
Syntax
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
Deze opdracht laat zien dat u een pijplijnoperator (|
) kunt gebruiken om een tekenreeks te verzenden naar Write-Warning
.
U kunt de tekenreeks opslaan in een variabele, zoals wordt weergegeven in deze opdracht, of de tekenreeks rechtstreeks doorsturen naar Write-Warning
.
$w = "This is only a test warning."
$w | Write-Warning
Voorbeeld 3: de variabele $WarningPreference 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, namelijk Continue
. Als gevolg hiervan wordt het waarschuwingsbericht weergegeven wanneer u een waarschuwing schrijft en wordt de uitvoering voortgezet.
Wanneer u de waarde van de $WarningPreference
variabele wijzigt, verandert het effect van de Write-Warning
opdracht opnieuw. De waarde van SilentlyContinue
onderdrukt de waarschuwing. Een waarde van Stop
geeft de waarschuwing weer en stopt vervolgens de uitvoering van de opdracht.
Zie about_Preference_Variables voor meer informatie over de$WarningPreference
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 gebruiken met een cmdlet om te bepalen hoe PowerShell reageert op waarschuwingen die het gevolg zijn van die opdracht. De algemene parameter WarningAction overschrijft de waarde van de $WarningPreference
alleen 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 de waarde Inquire geeft het systeem opdracht 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 op.
Type: | String |
Aliases: | Msg |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Invoerwaarden
U kunt een tekenreeks met de waarschuwing doorspezen naar Write-Warning
.
Uitvoerwaarden
None
Write-Warning
schrijft alleen naar de waarschuwingsstroom. Er wordt geen andere uitvoer gegenereerd.
Notities
De standaardwaarde voor de $WarningPreference
variabele is Continue
, waarmee de waarschuwing wordt weergegeven en vervolgens de opdracht wordt uitgevoerd. Als u geldige waarden wilt bepalen voor een voorkeursvariabele zoals $WarningPreference
, stelt u deze in op een tekenreeks met willekeurige tekens, zoals 'abc'. In het resulterende foutbericht worden de geldige waarden vermeld.