Table of contents
ISE
TOC
Collapse the table of content
Expand the table of content

Write-Output

JuanPablo Jofre|Last Updated: 11/17/2016
|
2 Contributors

SYNOPSIS

Sends the specified objects to the next command in the pipeline. If the command is the last command in the pipeline, the objects are displayed in the console.

SYNTAX

Write-Output [-InputObject] <PSObject[]> [-NoEnumerate] [<CommonParameters>]

DESCRIPTION

The Write-Output cmdlet sends the specified object down the pipeline to the next command. If the command is the last command in the pipeline, the object is displayed in the console.

Write-Output sends objects down the primary pipeline, also known as the "output stream" or the "success pipeline." To send error objects down the error pipeline, use Write-Error.

This cmdlet is typically used in scripts to display strings and other objects on the console. However, because the default behavior is to display the objects at the end of a pipeline, it is generally not necessary to use the cmdlet. For instance, Get-Process | Write-Output is equivalent to Get-Process.

EXAMPLES

Example 1: Get objects and write them to the console

PS C:\> $P = Get-Process
PS C:\> Write-Output $P
PS C:\> $P

The first command gets processes running on the computer and stores them in the $P variable.

The second and third commands display the process objects in $P on the console.

Example 2: Pass output to another cmdlet

PS C:\> Write-Output "test output" | Get-Member

This command pipes the "test output" string to the Get-Member cmdlet, which displays the members of the System.String class, demonstrating that the string was passed along the pipeline.

Example 3: Suppress enumeration in output

PS C:\> Write-Output @(1,2,3) | measure

Count    : 3
...

PS C:\> Write-Output @(1,2,3) -NoEnumerate | measure

Count    : 1

This command adds the NoEnumerate parameter to treat a collection or array as a single object through the pipeline.

PARAMETERS

-InputObject

Specifies the objects to send down the pipeline. Enter a variable that contains the objects, or type a command or expression that gets the objects.

Type: PSObject[]
Parameter Sets: (All)
Aliases: 

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-NoEnumerate

By default, the Write-Output cmdlet always enumerates its output. The NoEnumerate parameter suppresses the default behavior, and prevents Write-Output from enumerating output. The NoEnumerate parameter has no effect on collections that were created by wrapping commands in parentheses, because the parentheses force enumeration.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

System.Management.Automation.PSObject

You can pipe objects to Write-Output.

OUTPUTS

System.Management.Automation.PSObject

Write-Output returns the objects that are submitted as input.

NOTES

Tee-Object

Write-Debug

Write-Error

Write-Host

Write-Information

Write-Progress

Write-Verbose

Write-Warning

© 2016 Microsoft