Partilhar via

Clear-Host

Módulo:
Microsoft.PowerShell.Core

Limpa a exibição no programa host.

Sintaxe

Clear-Host

Description

A função Clear-Host remove todo o texto da exibição atual, incluindo comandos e saídas que possam ter se acumulado. Quando concluído, ele exibe o prompt de comando. Você pode usar o nome da função ou seu alias, cls.

Clear-Host afeta apenas a exibição atual. Ele não exclui resultados salvos ou remove quaisquer itens da sessão. Itens específicos da sessão, como variáveis e funções, não são afetados por essa função.

Como o comportamento da função Clear-Host é determinado pelo programa host, Clear-Host pode funcionar de forma diferente em diferentes programas host.

Exemplos

Exemplo 1

PS> Get-Process | Select-Object -First 5

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
    843      33    14428      22556    99    17.41   1688 CcmExec
     44       6     2196       4964    52     0.23    692 conhost
    646      12     2332       4896    49     1.12    388 csrss
    189      11     2860       7084   114     0.66   2896 csrss
     78      11     1876       4008    42     0.22   4000 csrss

PS> Clear-Host

Entradas

None

Não é possível canalizar objetos para este cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

O PowerShell inclui os seguintes aliases para Clear-Host:

  • Janelas:

    • clear
    • cls

  • Linux e macOS:

    • cls

Clear-Host é uma função simples, não uma função avançada. Não há parâmetros.