Ajouter une sortie aux scripts Windows PowerShell

Effectué

Quand un script ne fonctionne pas comme prévu, il peut être utile qu’il affiche des informations supplémentaires. Vous pouvez utiliser ces informations pour comprendre ce que fait le script et pourquoi il ne fonctionne pas comme prévu.

L’applet de commande Write-Host est le moyen le plus courant d’afficher des informations supplémentaires pendant l’exécution d’un script. Vous pouvez l’utiliser pour afficher des informations textuelles indiquant des points spécifiques dans un script, ainsi que des valeurs de variables. Des valeurs de variables peuvent être utiles dans la plupart des cas quand un script ne se comporte pas comme attendu parce qu’une variable n’a pas de valeur que vous attendez.

Si vous souhaitez rendre votre texte de résolution des problèmes plus facilement identifiable, vous pouvez utiliser l’applet de commande Write-Warning au lieu d’Write-Host. L’avertissement en écriture affiche le texte que vous spécifiez dans une autre couleur.

Si vous souhaitez ralentir l’exécution d’un script pour vous permettre de passer en revue la sortie mieux, vous pouvez ajouter une applet de commande Start-Sleep et spécifier quelques secondes pour suspendre. Sinon, si vous souhaitez que le script s’interrompe jusqu’à ce que vous soyez prêt à continuer, vous pouvez utiliser l’hôte en lecture.

Le temps de résoudre des problèmes, vous pouvez commenter les informations supplémentaires. Ensuite, si nécessaire, vous pouvez supprimer les marques de commentaire pour voir les informations supplémentaires.

Sortie de script avancé

Si vous avez configuré votre script en tant que script avancé à l’aide de CmdletBinding() dans le bloc Param(), vous pouvez également utiliser les applets de commande dans le tableau suivant dans le cadre de votre script pour la résolution des problèmes.

Tableau 1 : Applets de commande pour la résolution des problèmes

Cmdlet	Descriptif
Write-Verbose	Le texte spécifié par Write-Verbose s’affiche uniquement lorsque vous utilisez le -Verbose paramètre lors de l’exécution du script. La valeur de $VerbosePreference spécifie l’action à entreprendre après la commande Write-Verbose. L’action par défaut est SilentlyContinue.
Write-Debug	Le texte spécifié par write-Debug s’affiche uniquement lorsque vous utilisez le -Debug paramètre lors de l’exécution du script. La valeur de $DebugPreference spécifie l’action à entreprendre après la commande Write-Debug . L’action par défaut est SilentlyContinue, qui n’affiche aucune information à l’écran. Vous devez modifier cette action pour continuer afin que les messages de débogage soient affichés.