about_Output_Streams
Description courte
Explique la disponibilité et l’objectif des flux de sortie dans PowerShell.
Description longue
PowerShell fournit plusieurs flux de sortie. Les flux fournissent des canaux pour différents types de messages. Vous pouvez écrire dans ces flux à l’aide de l’applet de commande ou de la redirection associée. Pour plus d’informations, consultez about_Redirection.
PowerShell prend en charge les flux de sortie suivants.
Stream # | Description | Introduite dans | Écriture de l’applet de commande |
---|---|---|---|
1 | Flux de réussite | PowerShell 2.0 | Write-Output |
2 | Flux d’erreurs | PowerShell 2.0 | Write-Error |
3 | Flux d’avertissement | PowerShell 2.0 | Write-Warning |
4 | Flux détaillé | PowerShell 2.0 | Write-Verbose |
5 | Flux de débogage | PowerShell 2.0 | Write-Debug |
6 | Flux d’informations | PowerShell 5.0 | Write-Information |
n/a | Flux de progression | PowerShell 2.0 | Write-Progress |
Notes
Le flux Progress ne prend pas en charge la redirection.
Flux de réussite
Le flux de réussite est le flux par défaut pour les résultats normaux et réussis.
Utilisez l’applet Write-Output
de commande pour écrire explicitement des objets dans ce flux. Ce flux est utilisé pour passer des objets via le pipeline PowerShell. Le flux réussite est connecté au flux stdout pour les applications natives.
Flux d’erreurs
Le flux d’erreurs est le flux par défaut pour les résultats de l’erreur. Utilisez l’applet Write-Error
de commande pour écrire explicitement dans ce flux. Le flux d’erreurs est connecté au flux stderr pour les applications natives. Dans la plupart des conditions, ces erreurs peuvent arrêter le pipeline d’exécution. Les erreurs écrites dans ce flux sont également ajoutées à la $Error
variable automatique. Pour plus d’informations, consultez about_Automatic_Variables.
Flux d’avertissement
Le flux d’avertissement est destiné aux conditions d’erreur qui sont moins graves que les erreurs écrites dans le flux d’erreurs . Dans des conditions normales, ces avertissements ne mettent pas fin à l’exécution. Les avertissements ne sont pas écrits dans la $Error
variable automatique. Utilisez l’applet Write-Warning
de commande pour écrire explicitement dans ce flux.
flux des commentaires
Le flux détaillé est destiné aux messages qui aident les utilisateurs à résoudre les problèmes de commandes lors de leur exécution interactive ou à partir d’un script. Utilisez l’applet Write-Verbose
de commande pour écrire explicitement des messages dans ce flux. De nombreuses applets de commande fournissent une sortie détaillée qui est utile pour comprendre le fonctionnement interne de l’applet de commande. Les messages détaillés ne sont générés que lorsque vous utilisez le -Verbose
paramètre commun. Pour plus d’informations, consultez about_CommonParameters.
flux de débogage
Le flux Debug est utilisé pour les messages qui aident les scripteurs à comprendre pourquoi leur code échoue. Utilisez l’applet Write-Debug
de commande pour écrire explicitement dans ce flux. Les messages de débogage ne sont générés que lorsque vous utilisez le -Debug
paramètre commun. Pour plus d’informations, consultez about_CommonParameters.
Les messages de débogage sont destinés aux développeurs de scripts et d’applets de commande plus qu’aux utilisateurs finaux. Ces messages de débogage peuvent contenir les détails internes nécessaires à la résolution des problèmes en profondeur.
Flux d’informations
Le flux d’informations est destiné à fournir un message qui aide un utilisateur à comprendre ce que fait un script. Il peut également être utilisé par les développeurs comme un flux supplémentaire utilisé pour transmettre des informations via PowerShell. Le développeur peut baliser les données de flux et avoir une gestion spécifique pour ce flux. Utilisez l’applet Write-Information
de commande pour écrire explicitement dans ce flux.
Flux de progression
Le flux Progression est utilisé pour les messages qui communiquent la progression dans des commandes et des scripts plus longs. Utilisez l’applet Write-Progress
de commande pour écrire explicitement des messages dans ce flux. Le flux Progress ne prend pas en charge la redirection.