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 information, consultez about_Redirection.
PowerShell prend en charge les flux de sortie suivants.
| Ruisseau # | Description | Introduite dans | Écrire une applet de commande |
|---|---|---|---|
| 1 | Success ruisseau | PowerShell 2.0 | Write-Output |
| 2 | Error ruisseau | PowerShell 2.0 | Write-Error |
| 3 | Warning ruisseau | PowerShell 2.0 | Write-Warning |
| 4 | Verbose ruisseau | PowerShell 2.0 | Write-Verbose |
| 5 | Debug ruisseau | PowerShell 2.0 | Write-Debug |
| 6 | Information ruisseau | PowerShell 5.0 | Write-Information |
| n/a | Progress ruisseau | PowerShell 2.0 | Write-Progress |
Remarque
Le flux ne prend pas en charge la Progress redirection.
Success ruisseau
Le Success flux 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 Success flux est connecté au flux stdout pour les applications natives.
Error ruisseau
Le Error flux est le flux par défaut pour les error résultats. Utilisez l’applet Write-Error de commande pour écrire explicitement dans ce flux. Le Error flux est connecté au flux stderr pour les applications natives. Dans la plupart des conditions, ces erreurs peuvent mettre fin au pipeline d’exécution. Les erreurs écrites dans ce flux sont également ajoutées à la $Error variable automatique. Pour plus d’informations information, consultez about_Automatic_Variables.
Warning ruisseau
Le Warning flux est destiné aux error conditions moins graves que les erreurs écrites dans le Error flux. Dans des conditions normales, ces avertissements ne terminent pas 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.
Verbose ruisseau
Le Verbose flux est destiné aux messages qui aident les utilisateurs à résoudre les problèmes de commandes au fur et à mesure qu’ils sont exécutés de manière 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 verbose sortie utile pour comprendre les fonctionnements internes de l’applet de commande. Les verbose messages sont générés uniquement lorsque vous utilisez le -Verbose paramètre commun. Pour plus d’informations information, consultez about_CommonParameters.
Debug ruisseau
Le Debug flux 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 debug messages sont générés uniquement lorsque vous utilisez le -Debug paramètre commun. Pour plus d’informations information, consultez about_CommonParameters.
Debug les messages sont destinés aux développeurs de scripts et d’applets de commande plus que les utilisateurs finaux. Ces debug messages peuvent contenir des détails internes nécessaires à la résolution des problèmes approfondis.
Information ruisseau
Le Information flux est destiné à fournir des messages qui aident un utilisateur à comprendre ce qu’est un script. Il peut également être utilisé par les développeurs comme flux supplémentaire utilisé pour passer information via PowerShell. Le développeur peut étiqueter les données de flux et disposer d’une gestion spécifique pour ce flux. Utilisez l’applet Write-Information de commande pour écrire explicitement dans ce flux.
Write-Host écrit également dans le Information flux. La différence entre les applets de commande est que Write-Host les écritures dans la console hôte, sauf si vous redirigez le Information flux. Write-Information écrit uniquement dans le Information flux.
Progress ruisseau
Le Progress flux est utilisé pour les messages qui communiquent progress dans des commandes et des scripts en cours d’exécution. Utilisez l’applet Write-Progress de commande pour écrire explicitement des messages dans ce flux. Le flux ne prend pas en charge la Progress redirection.
