Partager via

Write-Output

Module:
Microsoft.PowerShell.Utility Module

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

Default (Par défaut) 

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:\> $P

La 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-Member

Cette 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    : 1

Cette 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.

Propriétés du paramètre

Type:

PSObject[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 n’a aucun effet sur les collections qui ont été créées en encapsulant des commandes entre parenthèses, car les parenthèses forcent l’énumération.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSObject

Vous pouvez diriger des objets vers de sortie en écriture .

Sorties

PSObject

de sortie en écriture retourne les objets soumis en tant qu’entrée.