Write-Warning

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

La cmdlet Write-Warning écrit un message d’avertissement sur l’hôte Windows PowerShell. La réponse à l’avertissement dépend de la valeur de la variable $WarningPreference de l’utilisateur et de l’utilisation du paramètre commun WarningAction.

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

Cette commande affiche le message « AVERTISSEMENT : Il s’agit uniquement d’un avertissement de test ».

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

Cette commande montre que vous pouvez utiliser un opérateur de pipeline (|) pour envoyer une chaîne à d’avertissement en écriture. Vous pouvez enregistrer la chaîne dans une variable, comme indiqué dans cette commande, ou diriger la chaîne directement vers Write-Warning .

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."

Cet exemple montre l’effet de la valeur de la variable $WarningPreference sur une commande Write-Warning.

La première commande affiche la valeur par défaut de la variable $WarningPreference, qui est Continue. Par conséquent, lorsque vous écrivez un avertissement, le message d’avertissement s’affiche et l’exécution se poursuit.

Lorsque vous modifiez la valeur de la variable $WarningPreference, l’effet de la commande Write-Warning change à nouveau. Une valeur de SilentlyContinue supprime l’avertissement. La valeur Stop affiche l’avertissement, puis arrête l’exécution de la commande.

Pour plus d’informations sur la variable $WarningPreference, consultez about_Preference_Variables.

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"):

Cet exemple montre l’effet du paramètre WarningAction commun sur une commande Write-Warning. Vous pouvez utiliser le paramètre WarningAction commun avec n’importe quelle applet de commande pour déterminer comment Windows PowerShell répond aux avertissements résultant de cette commande. Le paramètre WarningAction commun remplace la valeur du $WarningPreference uniquement pour cette commande particulière.

Cette commande utilise l’applet de commande Write-Warning pour afficher un avertissement. La WarningAction paramètre commun avec la valeur Inquire indique au système d’inviter l’utilisateur lorsque la commande affiche un avertissement.

Pour plus d’informations sur le paramètre commun WarningAction, consultez about_CommonParameters.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez diriger une chaîne qui contient l’avertissement pour d’avertissement en écriture.

écriture-avertissement écrit uniquement dans le flux d’avertissement. Elle ne génère aucune autre sortie.

• La valeur par défaut de la variable $WarningPreference est Continuer, qui affiche l’avertissement, puis poursuit l’exécution de la commande. Pour déterminer les valeurs valides d’une variable de préférence telle que $WarningPreference, définissez-la sur une chaîne de caractères aléatoires, comme « abc ». Le message d’erreur résultant répertorie les valeurs valides.