Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Brève description
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.
| Ruisseau # | Description | Introduite dans | Écrire une applet de commande (Cmdlet) |
|---|---|---|---|
| 1 | Flux Success | PowerShell 2.0 | Write-Output |
| 2 | Flux Error | PowerShell 2.0 | Write-Error |
| 3 | Flux Warning | PowerShell 2.0 | Write-Warning |
| 4 | Flux Verbose | PowerShell 2.0 | Write-Verbose |
| 5 | Flux Debug | PowerShell 2.0 | Write-Debug |
| 6 | Flux Information | PowerShell 5.0 | Write-Information |
| n/a | Flux Progress | PowerShell 2.0 | Write-Progress |
Remarque
Le flux Progress ne prend pas en charge la redirection.
Flux Success
Le flux Success est le flux par défaut pour les résultats normaux et réussis.
Utilisez l’applet de commande Write-Output pour écrire explicitement des objets dans ce flux. Ce flux est utilisé pour passer des objets via le pipeline PowerShell. Le flux Success est connecté au flux stdout pour les applications natives.
Flux Error
Le flux Error est le flux par défaut pour les résultats d’erreur. Utilisez l’applet de commande Write-Error pour écrire explicitement dans ce flux. Le flux Error 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 variable automatique $Error. Pour plus d’informations, consultez about_Automatic_Variables.
Flux Warning
Le flux Warning est destiné à des conditions d’erreur moins graves que les erreurs écrites dans le flux de Error. Dans des conditions normales, ces avertissements ne terminent pas l’exécution. Les avertissements ne sont pas écrits dans la variable automatique $Error. Utilisez l’applet de commande Write-Warning pour écrire explicitement dans ce flux.
Flux Verbose
Le flux de Verbose 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 de commande Write-Verbose pour écrire explicitement des messages dans ce flux. De nombreuses applets de commande fournissent une sortie détaillée qui est utile à la compréhension de leur fonctionnement interne. Les messages détaillés sont générés uniquement lorsque vous utilisez le paramètre commun -Verbose. Pour plus d’informations, consultez about_CommonParameters.
Flux Debug
Le flux Debug est utilisé pour les messages qui aident les scripteurs à comprendre pourquoi leur code échoue. Utilisez l’applet de commande Write-Debug pour écrire explicitement dans ce flux. Les messages de débogage ne sont générés que lorsque vous utilisez le paramètre commun -Debug. Pour plus d’informations, consultez about_CommonParameters.
Debug messages sont destinés aux développeurs de scripts et d’applets de commande plus que les utilisateurs finaux. Ces messages de débogage peuvent contenir des détails internes nécessaires à la résolution des problèmes approfondis.
Flux Information
Le flux Information 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 transmettre des informations 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 de commande Write-Information pour écrire explicitement dans ce flux.
Write-Host écrit également dans le flux Information. La différence entre les cmdlets est que Write-Host écrit également dans la console hôte, sauf si vous redirigez le flux Information.
Write-Information écrit uniquement dans le flux Information.
Flux Progress
Le flux Progress est utilisé pour les messages qui communiquent la progression pour des commandes et des scripts plus longs. Utilisez l’applet de commande Write-Progress pour écrire explicitement des messages dans ce flux. Le flux Progress ne prend pas en charge la redirection.
Voir aussi
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
