Share via

Out-Default

Module:
Microsoft.PowerShell.Core Module

Sends the output to the default formatter and to the default output cmdlet.

Syntax

Default (Default) 

Out-Default
    [-Transcript]
    [-InputObject <PSObject>]
    [<CommonParameters>]

Description

PowerShell automatically adds Out-Default to the end of every pipeline. Out-Default decides how to format and output the object stream. If the object stream is a stream of strings, Out-Default pipes these directly to Out-Host which calls the appropriate APIs provided by the host. If the object stream does not contain strings, Out-Default inspects the object to determine what to do. First it looks at the object type and determines whether there is a registered view for this object type.

PowerShell defines XML schema and a mechanism (the Update-FormatData cmdlet) where anyone can register views for an object type. You can specify wide, list, table, or custom views for any object type. The views specify which properties to display and how they should be displayed. If a view is registered, it defines which formatter to use. So if the registered view is a table view, Out-Default streams the objects to Format-Table | Out-Host. Format-Table transforms the objects into a stream of Formatting records (driven by the data in the view definition) and Out-Host transforms the formatting records into calls on the Host interface.

Examples

Example 1

While this cmdlet is not intended to be run directly by the end user, it can be.

Get-Process | Select-Object -First 5 | Out-Default

 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     12     2.56       5.20       0.00    7376   0 aesm_service
     48    34.32      18.10      26.64    9320  13 AlertusDesktopAlert
     24    13.97      12.74       0.77   12656  13 ApplicationFrameHost
      8     1.79       4.41       0.00    8180   0 AppVShNotify
      9     1.99       5.07       0.19   19320  13 AppVShNotify

Parameters

-InputObject

Accepts input to the cmdlet.

Parameter properties

Type:PSObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Transcript

Determines whether the output should be sent to PowerShell's transcription services.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.