Envoie les objets spécifiés à la commande suivante dans le pipeline. Si la commande est la dernière commande du pipeline, les objets sont affichés dans la console.
Syntaxe
Description
Lapplet de commande Write-Output envoie lobjet spécifié dans le pipeline à la commande suivante. Si la commande est la dernière commande du pipeline, lobjet saffiche dans la console.
Write-Output envoie des objets dans le pipeline principal, également appelé « flux de sortie » ou « pipeline de réussite ». Pour envoyer des objets derreur dans le pipeline derreur, utilisez Write-Error.
Cette cmdlet est généralement utilisée dans les scripts pour afficher des chaînes et dautres objets sur la console. Lun des alias intégrés pour Write-Output est echo et est similaire à dautres shells qui utilisent echo, le comportement par défaut est dafficher la sortie à la fin dun pipeline. Dans PowerShell, il nest généralement pas nécessaire dutiliser lapplet de commande dans les instances où la sortie est affichée par défaut. Par exemple, Get-Process | Write-Output équivaut à Get-Process. Ou, echo "Home directory: $HOME" peut être écrit, "Home directory: $HOME".
Par défaut, Write-Output énumère les collections fournies à lapplet de commande. Cependant, Write-Output peut également être utilisé pour transmettre des collections dans le pipeline en tant quobjet unique avec le paramètreNoEnumerate.
Exemples
Exemple 1: Récupérez des objets et écrivez-les sur la console
La première commande lance les processus sur lordinateur et les stocke dans le $P variable.
Les deuxième et troisième commandes affichent les objets de processus dans $P sur la console.
Exemple 2: Passer la sortie vers une autre cmdlet
Cette commande redirige la chaîne « test output » vers la cmdlet Get-Member, qui affiche le membres de la classe System.String, démontrant que la chaîne a été transmise le long du pipeline.
Exemple 3: supprimer lénumération dans la sortie
Cette commande ajoute le paramètre NoEnumerate pour traiter une collection ou un tableau comme un objet unique à travers le pipeline.
Paramètres
Spécifie les objets à envoyer dans le pipeline. Entrez une variable contenant les objets, ou tapez une commande ou une expression qui récupère les objets.
| Type: | PSObject |
| Position: | 0 |
| Valeur par défaut: | Aucune |
| Accepter lentrée du pipeline: | Vrai |
| Accepter les caractères génériques: | Faux |
Par défaut, le Write-Output La cmdlet énumère toujours sa sortie. Le paramètre NoEnumerate supprime le comportement par défaut et empêche Write-Output dénumérer la sortie. Le paramètreNoEnumerate na aucun effet si la commande est placée entre parenthèses, car les parenthèses forcent lénumération. Par exemple, (Write-Output 1,2,3) énumère toujours le tableau.
Remarque
Ce commutateur ne fonctionne correctement quavec PowerShell Core 6.2 et plus récent. Sur les anciennes versions de PowerShell Core, la collection est toujours énumérée même avec lutilisation de ce commutateur.
| Type: | SwitchParameter |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Accepter lentrée du pipeline: | False |
| Accepter les caractères génériques: | Faux |
Entrées
PSObject
Vous pouvez diriger les objets vers Write-Output.
Sorties
PSObject
Write-Output renvoie les objets soumis en entrée.
- about_Output_Streams
- about_Redirection
- Tee-Object
- Write-Debug
- Erreur décriture
- Write-Host
- Write-Information
- Write-Progress
- Write-Verbose
- Avertissement décriture