Edit

Share via

Clear-Host

Module:
Microsoft.PowerShell.Core Module

Clears the display in the host program.

Syntax

Default (Default) 

Clear-Host

Description

The Clear-Host function removes all text from the current display, including commands and output that might have accumulated. When complete, it displays the command prompt. You can use the function name or its alias, cls.

Clear-Host affects only the current display. It does not delete saved results or remove any items from the session. Session-specific items, such as variables and functions, are not affected by this function.

Because the behavior of the Clear-Host function is determined by the host program, Clear-Host might work differently in different host programs.

Inputs

None

You can't pipe objects to this cmdlet.

Outputs

None

This cmdlet returns no output.

Notes

PowerShell includes the following aliases for Clear-Host:

  • Windows:

    • clear
    • cls

  • Linux and macOS:

    • cls

Clear-Host is a simple function, not an advanced function. There are no parameters.