Sends the specified objects to the next command in the pipeline. If the command is the last command in thepipeline, the objects are displayed in the console.
Write-Output [-InputObject*] <PSObject> [-NoEnumerate] [<CommonParameters>]
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 example, get-process | write-output is equivalent to get-process.
You can pipe objects to Write-Output.
Write-Output returns the objects that are submitted as input.
- 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.
- 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.
- 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.