Tutorials  PowerShell Cmdlet Help for Out-Host


Sends output to the command line.

Out-Host [-InputObject ] [-Paging] []

The Out-Host cmdlet sends output to the Windows PowerShell host for display. The host displays the output at the co
mmand line. Because Out-Host is the default, you do not need to specify it unless you want to use its parameters to
change the display.

Specifies the objects that are written to the console. Enter a variable that contains the objects, or type a co
mmand or expression that gets the objects.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? false

-Paging []
Displays one page of output at a time, and waits for user input before displaying the remaining pages, much lik
e the traditional "more" command. By default, all of the output is displayed on a single page. The page size is
determined by the characteristics of the host.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

You can pipe any object to Out-Host.

Out-Host does not generate any output. However, the host might display the objects that Out-Host sends to it.


You can also refer to Out-Host by its built-in alias, "oh". For more information, see about_Aliases.

The cmdlets that contain the Out verb (the Out cmdlets) do not format objects; they just render them and send t
hem to the specified display destination. If you send an unformatted object to an Out cmdlet, the cmdlet sends
it to a formatting cmdlet before rendering it.

The Out cmdlets do not have parameters for names or file paths. To send data to an Out cmdlet, use a pipeline o
perator (|) to send the output of a Windows PowerShell command to the cmdlet. You can also store data in a vari
able and use the InputObject parameter to pass the data to the cmdlet. For help, see the examples.

Out-Host sends data, but it does not emit any output objects. If you pipe the output of Out-Host to Get-Member,
Get-Member reports that no objects have been specified.

-------------------------- EXAMPLE 1 --------------------------

C:\PS>get-process | out-host -paging

This command displays the processes on the system one page at a time. It uses the Get-Process command to get the pr
ocesses on the system. The pipeline operator (|) sends the results to Out-Host, which displays them at the console.
The Paging parameter displays one page of data at a time.

The same command format is used for the Help function that is built into Windows PowerShell. That function gets dat
a from Get-Help and then uses the Paging parameter of Out-Host to display the data one page at a time by using this
command format: get-help $args[0] | out-host -paging).

-------------------------- EXAMPLE 2 --------------------------

C:\PS>$a = get-history

C:\PS>out-host -InputObject $a

These commands display the session history at the command line. The first command uses the Get-History cmdlet to ge
t the session history, and then it stores the history in the $a variable. The second command uses Out-Host to displ
ay the content of the $a variable, and it uses the InputObject parameter to specify the variable to Out-Host.

Online version: http://go.microsoft.com/fwlink/?LinkID=113365