HOWTO · PowerShell

L'équivalent echo dans PowerShell

Ce didacticiel présentera les commandes équivalentes echo dans PowerShell pour les scripts et les fonctions.

Sur cette page

Dans PowerShell, echo est un alias de Write-Output. Utilisez-le, ou appelez directement Write-Output, pour envoyer une valeur dans le flux de sortie de réussite. Si cette valeur n’est pas transmise à une autre commande par le pipeline, le shell interactif l’affiche. Pour les messages destinés uniquement à la personne devant la console, utilisez Write-Host ; pour les diagnostics facultatifs, utilisez Write-Debug ou Write-Verbose.

Exécutez cet exemple :

Le code et les libellés ou sorties affichés dans cette section restent en anglais.

Write-Output "Hello World!"

Quelle commande PowerShell remplace echo ?

echo est un alias pratique de Write-Output : les scripts existants qui utilisent echo "Hello World!" envoient donc la chaîne dans le même flux de sortie. Dans les scripts réutilisables, écrire Write-Output en toutes lettres rend le comportement plus facile à reconnaître. C’est l’équivalent PowerShell le plus proche lorsque vous voulez produire une valeur qui peut être affichée ou transmise à une autre commande.

Envoyer une sortie dans le pipeline avec Write-Output

Write-Output écrit un objet dans le flux de sortie de réussite de PowerShell. Le shell affiche cet objet si aucune commande ne le consomme, mais le pipeline peut aussi le traiter. Par exemple, Write-Output "Hello World!" | Set-Content -Path message.txt transmet la chaîne à la commande suivante au lieu de l’afficher comme résultat final. En général, vous passez la valeur comme argument ; il n’est pas nécessaire de nommer le paramètre -InputObject.

Choisissez cette cmdlet lorsqu’une fonction doit renvoyer des données à son appelant ou lorsqu’une étape ultérieure du pipeline doit filtrer, transformer ou enregistrer la valeur. Évitez l’affichage réservé à l’hôte pour les données que les appelants doivent pouvoir récupérer.

Écrire directement dans la console avec Write-Host

Utilisez Write-Host "Hello World!" pour afficher un message directement dans l’hôte PowerShell actuel. Cette commande sert à présenter une information à l’utilisateur, par exemple un court indicateur de progression ou un message d’état en couleur. La chaîne n’est pas envoyée dans le flux de sortie de réussite pour être traitée comme une donnée ordinaire du pipeline par un appelant.

Write-Host ne nécessite pas de nommer explicitement le paramètre -Object. Préférez Write-Output pour les valeurs que des scripts ou des fonctions doivent renvoyer ; utilisez Write-Host lorsque le but est simplement d’afficher le message.

Utiliser Write-Debug et Write-Verbose pour les messages de diagnostic

Les messages de diagnostic sont distincts de la sortie de réussite ordinaire. Write-Debug "Checking configuration" signale un message de débogage, tandis que Write-Verbose "Loading configuration" signale un détail opérationnel supplémentaire. Leur visibilité est contrôlée séparément par $DebugPreference et $VerbosePreference.

Par défaut, $DebugPreference vaut SilentlyContinue : les messages de débogage sont donc normalement masqués. Définir $DebugPreference = "Continue" les rend visibles pendant que le script continue son exécution. De même, définir $VerbosePreference = "Continue" affiche les messages de Write-Verbose. Dans les fonctions et scripts avancés, les appelants peuvent généralement activer les messages détaillés avec le paramètre commun -Verbose. Utilisez le type de diagnostic approprié au lieu de présenter une sortie ordinaire comme un message de débogage ou détaillé.

Afficher directement un littéral de chaîne

Une chaîne entre guillemets utilisée comme expression PowerShell produit également une valeur dans le flux de sortie de réussite. Pour une vérification rapide dans une session interactive, saisissez "Hello World!" à l’invite. Cette forme concise permet de tester une valeur, mais un appel explicite à Write-Output peut rendre l’intention plus claire dans un script plus long. Comme les autres valeurs de ce flux, la chaîne peut être récupérée ou transmise au pipeline au lieu d’être affichée immédiatement.

Choisir la méthode de sortie adaptée

Choisissez en fonction du destinataire du message :

  • Utilisez Write-Output (ou son alias echo) pour produire des données destinées à l’appelant, au pipeline ou à l’affichage du shell.
  • Utilisez Write-Host pour un message à afficher dans l’hôte, qui ne doit pas être renvoyé comme donnée du pipeline.
  • Utilisez Write-Debug pour les diagnostics de débogage et Write-Verbose pour les détails opérationnels facultatifs ; activez chacun au moyen de son propre contrôle de préférence ou d’un paramètre commun pris en charge.
  • Utilisez une chaîne entre guillemets sans commande pour une expression rapide à l’invite interactive.

Ces méthodes ne sont pas interchangeables. Si l’appelant d’une fonction doit récupérer, transformer ou rediriger une valeur, envoyez-la dans le flux de sortie de réussite. Réservez l’affichage direct dans l’hôte et les flux de diagnostic aux messages destinés à informer une personne, plutôt qu’à fournir le résultat de la fonction.