Envoie les objets spécifiés à la commande suivante dans le pipeline. Si la commande est la dernière du pipeline, les objets sont affichés sur la console.
Syntaxe
Write-Output [-InputObject] <PSObject[]> [<CommonParameters>]
Description
L'applet de commande Write-Output envoie l'objet spécifié à travers le pipeline vers la commande suivante. Si la commande est la dernière du pipeline, l'objet est affiché sur la console.
Write-Output envoie les objets à travers le pipeline principal, également appelé « flux de sortie » ou « pipeline de réussite ». Pour envoyer des objets erreurs à travers le pipeline d'erreur, utilisez Write-Error.
Cette applet de commande est généralement utilisée dans des scripts pour afficher des chaînes et d'autres objets sur la console. Toutefois, étant donné que le comportement par défaut consiste à afficher les objets à la fin d'un pipeline, il n'est pas généralement nécessaire d'utiliser l'applet de commande. Par exemple, « get-process | write-output » est équivalent à « get-process ».
Paramètres
-InputObject <PSObject[]>
Spécifie les objets à envoyer à travers le pipeline. Entrez une variable contenant les objets, ou tapez une commande ou une expression permettant d'obtenir ces objets.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
System.Management.Automation.PSObject Vous pouvez diriger les objets vers Write-Output. |
|
Sorties |
System.Management.Automation.PSObject Write-Output retourne les objets envoyés en tant qu'entrées. |
Exemple 1
C:\PS>$p = get-process c:\PS> write-output $p c:\PS> $p Description ----------- Ces commandes obtiennent des objets représentant les processus qui s'exécutent sur l'ordinateur et affichent ces objets sur la console.
Exemple 2
C:\PS>write-output "test output" | get-member Description ----------- Cette commande dirige la chaîne « test output » vers l'applet de commande Get-Member, qui affiche les membres de la classe String, en montrant que la chaîne est passée le long du pipeline.
Voir aussi