NAME
Write-Output
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]
[-NoEnumerate] [ ] 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 errorpipeline, 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 thecmdlet. For instance, `Get-Process | Write-Output` is equivalent to `Get-Process`.
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. 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. Required? false Position? named Default value False Accept pipeline input? False Accept wildcard characters? falseThis cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216). INPUTS
System.Management.Automation.PSObjectYou can pipe objects to Write-Output .
OUTPUTS
System.Management.Automation.PSObjectWrite-Output returns the objects that are submitted as input.
NOTES
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.RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=821878Tee-Object
Write-Debug
Write-Error
Write-Host
Write-Information
Write-Progress
Write-Verbose
Write-Warning