Write-Output
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
Write-Output
[-InputObject] <PSObject[]>
[-NoEnumerate]
[<CommonParameters>]Description
La cmdlet Write-Output envoie l’objet spécifié vers le bas du pipeline à la commande suivante. Si la commande est la dernière commande du pipeline, l’objet s’affiche dans la console.
de sortie en écriture envoie des objets vers le bas du pipeline principal, également appelé « flux de sortie » ou « pipeline de réussite ». Pour envoyer des objets d’erreur vers le bas du pipeline d’erreurs, utilisez l’erreur d’écriture.
Cette applet de commande est généralement utilisée dans les 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 généralement pas nécessaire d’utiliser l’applet de commande.
Par exemple, Get-Process | Write-Output équivaut à Get-Process.
Exemples
Exemple 1 : Obtenir des objets et les écrire dans la console
PS C:\> $P = Get-Process
PS C:\> Write-Output $P
PS C:\> $PLa première commande obtient les processus en cours d’exécution sur l’ordinateur et les stocke dans la variable $P.
Les deuxième et troisième commandes affichent les objets de processus dans $P sur la console.
Exemple 2 : Passer la sortie à une autre applet de commande
PS C:\> Write-Output "test output" | Get-MemberCette commande transmet la chaîne « test output » à l’applet de commande Get-Member, qui affiche les membres de la classe System.String, ce qui montre que la chaîne a été transmise le long du pipeline.
Exemple 3 : Supprimer l’énumération dans la sortie
PS C:\> Write-Output @(1,2,3) | measure
Count : 3
...
PS C:\> Write-Output @(1,2,3) -NoEnumerate | measure
Count : 1Cette commande ajoute le paramètre NoEnumerate pour traiter une collection ou un tableau comme un objet unique via le pipeline.
Paramètres
-InputObject
Spécifie les objets à envoyer dans le pipeline. Entrez une variable qui contient les objets, ou tapez une commande ou une expression qui obtient les objets.
| Type: | PSObject[] |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-NoEnumerate
Par défaut, l’applet de commande Write-Output énumère toujours sa sortie.
Le paramètre NoEnumerate supprime le comportement par défaut et empêche d’énumérer la sortie.
Le paramètre NoEnumerate
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
Vous pouvez diriger des objets vers de sortie en écriture .
Sorties
de sortie en écriture retourne les objets soumis en tant qu’entrée.