Delen via

Write-Warning

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee schrijft u een waarschuwingsbericht.

Syntaxis

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 $WarningPreference-variabele van de gebruiker en het gebruik van de WarningAction algemene parameter.

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 Write-Warningte verzenden. 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 variabele $WarningPreference 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 variabele $WarningPreference weergegeven. Dit is Continue. Als u een waarschuwing schrijft, wordt het waarschuwingsbericht weergegeven en wordt de uitvoering voortgezet.

Wanneer u de waarde van de variabele $WarningPreference wijzigt, wordt het effect van de opdracht Write-Warning opnieuw gewijzigd. Een waarde van SilentlyContinue onderdrukt de waarschuwing. Een waarde van Stop geeft de waarschuwing weer en stopt de uitvoering van de opdracht.

Zie about_Preference_Variablesvoor meer informatie over de variabele $WarningPreference.

Voorbeeld 4: De parameter WarningAction instellen en een waarschuwing schrijven

In dit voorbeeld ziet u het effect van de WarningAction algemene parameter voor een Write-Warning opdracht. U kunt de WarningAction algemene parameter gebruiken met een cmdlet om te bepalen hoe PowerShell reageert op waarschuwingen die het gevolg zijn van die opdracht. De WarningAction algemene parameter overschrijft de waarde van de $WarningPreference alleen voor die bepaalde 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 cmdlet Write-Warning gebruikt om een waarschuwing weer te geven. De WarningAction algemene parameter met een waarde van Inquire leidt het systeem om de gebruiker te vragen wanneer de opdracht een waarschuwing weergeeft.

Zie about_CommonParametersvoor meer informatie over de WarningAction algemene parameter.

Parameters

-Message

Hiermee geeft u het waarschuwingsbericht.

Type:String
Aliassen:Msg
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

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 variabele $WarningPreference is Continue, waarin de waarschuwing wordt weergegeven 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.