Delen via

Write-Warning

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee schrijft u een waarschuwingsbericht.

Syntaxis

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

Description

De cmdlet Write-Warning schrijft een waarschuwingsbericht naar de Windows 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

PS C:\> Write-Warning "This is only a test warning."

Met deze opdracht wordt het bericht 'WAARSCHUWING: dit is alleen een testwaarschuwing' weergegeven.

Voorbeeld 2: Een tekenreeks doorgeven aan Write-Warning

PS C:\> $w = "This is only a test warning."
PS C:\> $w | Write-Warning

Met deze opdracht ziet u dat u een pijplijnoperator (|) kunt gebruiken om een tekenreeks te verzenden naar schrijfwaarschuwing. U kunt de tekenreeks opslaan in een variabele, zoals wordt weergegeven in deze opdracht, of de tekenreeks rechtstreeks doorsluisen naar schrijfwaarschuwing.

Voorbeeld 3: De $WarningPreference-variabele instellen en een waarschuwing schrijven

PS C:\> $warningpreference
Continue PS C:\> Write-Warning "This is only a test warning."
This is only a test warning. PS C:\> $warningpreference = "SilentlyContinue"
PS C:\> Write-Warning "This is only a test warning."
PS C:\>
PS C:\> $warningpreference = "Stop"
PS C:\> Write-Warning "This is only a test warning."
WARNING: This is only a test message.
Write-Warning : Command execution stopped because the shell variable "WarningPreference" is set to Stop.
At line:1 char:14
     + Write-Warning <<<<  "This is only a test message."

In dit voorbeeld ziet u het effect van de waarde van de variabele $WarningPreference op een opdracht Write-Warning.

Met de eerste opdracht wordt de standaardwaarde van de variabele $WarningPreference weergegeven, namelijk Doorgaan. 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 write-warning opdracht opnieuw gewijzigd. Een waarde van SilentlyContinue onderdrukt de waarschuwing. Met de waarde Stop wordt de waarschuwing weergegeven en wordt de uitvoering van de opdracht gestopt.

Zie about_Preference_Variables voor meer informatie over de variabele $WarningPreference.

Voorbeeld 4: De parameter WarningAction instellen en een waarschuwing schrijven

PS C:\> 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"):

In dit voorbeeld ziet u het effect van de WarningAction algemene parameter voor een opdracht Write-Warning. U kunt de WarningAction algemene parameter gebruiken met een cmdlet om te bepalen hoe Windows PowerShell reageert op waarschuwingen die het gevolg zijn van die opdracht. De WarningAction algemene parameter overschrijft de waarde van de $WarningPreference alleen voor die opdracht.

Deze opdracht maakt gebruik van de cmdlet Write-Warning 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_CommonParameters voor 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 die de waarschuwing bevat, doorsluisen naar schrijfwaarschuwing.

Uitvoerwaarden

None

schrijfwaarschuwing alleen naar de waarschuwingsstroom schrijft. Er wordt geen andere uitvoer gegenereerd.

Notities

  • De standaardwaarde voor de variabele $WarningPreference is Doorgaan, 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'. In het resulterende foutbericht worden de geldige waarden weergegeven.