Export (0) Print
Expand All

Out-Null

Updated: May 8, 2014

Applies To: Windows PowerShell 4.0

Out-Null

Deletes output instead of sending it down the pipeline.

Syntax

Parameter Set: Default
Out-Null [-InputObject <PSObject> ] [ <CommonParameters>]




Detailed Description

The Out-Null cmdlet sends output to NULL, in effect, deleting it.

Parameters

-InputObject<PSObject>

Specifies the object that was sent to null (deleted). Enter a variable that contains the objects, or type a command or expression that gets the objects.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see  about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • System.Management.Automation.PSObject

    You can pipe any object to Out-Null.


Outputs

The output type is the type of the objects that the cmdlet emits.

  • None

    Out-Null does not generate any 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 Windows 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.

Examples

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

This command gets the items in the local directory, but then it deletes them instead of passing them through the pipeline or displaying them at the command line. This is useful for deleting output that you do not need.


PS C:\> Get-ChildItem | Out-Null

Related topics


Out-Default

Out-File

Out-Host

Out-Printer

Out-String



Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft