Out-Null

Module:: Microsoft.PowerShell.Core Module

Hides the output instead of sending it down the pipeline or displaying it.

Syntax

Default (Default)

Out-Null
    [-InputObject <PSObject>]
    [<CommonParameters>]

Description

The Out-Null cmdlet sends its output to NULL, in effect, removing it from the pipeline and preventing the output from being displayed on screen.

Examples

Example 1: Delete output

Get-ChildItem | Out-Null

This command gets items in the current ___location/directory, but its output is not passed through the pipeline nor displayed at the command line. This is useful for hiding output that you do not need.

Parameters

-InputObject

Specifies the object to be sent to NULL (removed from pipeline). Enter a variable that contains the objects, or type a command or expression that gets the objects.

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

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.

Inputs

PSObject

You can pipe any object to this cmdlet.

Outputs

None

This cmdlet returns no output.

Notes

The cmdlets that contain the Out verb (the Out cmdlets) do not have parameters for names or file paths. To send data to an Out cmdlet, use a pipeline operator (|) to send the output of a PowerShell command to the cmdlet. You can also store data in a variable and use the InputObject parameter to pass the data to the cmdlet. For more information, see the examples.
Out-Null does not return any output objects. If you pipe the output of Out-Null to the Get-Member cmdlet, Get-Member reports that no objects have been specified.