Share via


Clear-Host

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 cannot pipe input to Clear-Host.

Outputs

None

Clear-Host does not generate any output

Notes

Clear-Host is a simple function, not an advanced function. As such, you cannot use common parameters, such as Debug, in a Clear-Host command.