Compartilhar via


Clear-History

Exclui entradas do histórico de comandos.

Sintaxe

Clear-History [[-Id] <Int32[]>] [[-Count] <int>] [-Newest] [-Confirm] [-WhatIf] [<CommonParameters>]

Clear-History [[-Count] <int>] [-CommandLine <string[]>] [-Newest] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrição

O cmdlet Clear-History exclui comandos do histórico de comandos, ou seja, a lista de comandos inseridos durante a sessão atual.

Sem parâmetros, Clear-History exclui todos os comandos do histórico da sessão, mas você pode usar os parâmetros de Clear-History para excluir comandos selecionados.

Parâmetros

-CommandLine <string[]>

Exclui comandos com as cadeias de caracteres de texto especificadas. Se você inserir mais de uma cadeia de caracteres, Clear-History excluirá comandos com qualquer uma das cadeias de caracteres.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

true

-Count <int>

Apaga o número especificado de entradas de histórico, começando com a entrada mais antiga no histórico.

Se você usar os parâmetros Count e Id no mesmo comando, o cmdlet apagará o número de entradas especificado pelo parâmetro Count, começando com a entrada especificada pelo parâmetro Id. Por exemplo, se Count for 10 e Id for 30, Clear-History apagará os itens de 21 a 30 (inclusive).

Se você usar os parâmetros Count e CommandLine no mesmo comando, Clear-History apagará o número de entradas especificado pelo parâmetro Count, começando com a entrada especificada pelo parâmetro CommandLine.

Necessário?

false

Posição?

2

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Id <Int32[]>

Exclui comandos com as IDs de histórico especificadas.

Para localizar a ID de histórico de um comando, use Get-History.

Necessário?

false

Posição?

1

Valor padrão

Nenhum

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Newest

Exclui as entradas mais recentes do histórico. Por padrão, Clear-History exclui as entradas mais antigas do histórico.

Necessário?

false

Posição?

named

Valor padrão

False

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

Nenhum

Não é possível canalizar objetos para Clear-History.

Saídas

Nenhum

Este cmdlet não gera nenhuma saída.

Observações

O histórico da sessão é uma lista dos comandos inseridos durante a sessão. Você pode exibir o histórico, adicionar e excluir comandos e executar comandos do histórico. Para obter mais informações, consulte about_History.

Excluir um comando do histórico não altera as IDs de histórico dos itens restantes no histórico de comandos.

Exemplo 1

C:\PS>clear-history

Descrição
-----------
Exclui todos os comandos do histórico da sessão.





Exemplo 2

C:\PS>clear-history -id 23, 25

Descrição
-----------
Exclui os comandos com IDs de histórico 23 e 25.





Exemplo 3

C:\PS>clear-history -command *help*, *command

Descrição
-----------
Exclui comandos que incluem "help" ou terminam em "command".





Exemplo 4

C:\PS>clear-history -count 10 -newest

Descrição
-----------
Exclui os 10 comandos mais recentes do histórico.





Exemplo 5

C:\PS>clear-history -id 10 -count 3

Descrição
-----------
Exclui o três comandos mais antigos que começam com a entrada com ID 10.





Consulte também

Conceitos

about_History
Get-History
Add-History
Invoke-History