Compartilhar via

Clear-History

  • Referência
Módulo:
Microsoft.PowerShell.Core

Exclui entradas do histórico de comandos da sessão do PowerShell.

Sintaxe

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

Description

Clear-History exclui o histórico de comandos de uma sessão do PowerShell. Cada sessão do PowerShell tem seu próprio histórico de comandos. Para exibir o histórico de comandos, use o cmdlet Get-History.

Por padrão, Clear-History exclui todo o histórico de comandos de uma sessão do PowerShell. Você pode usar parâmetros com Clear-History para excluir comandos selecionados.

Clear-History não limpa o arquivo de histórico de comandos do PSReadLine. O módulo PSReadLine armazena um arquivo de histórico que contém todos os comandos do PowerShell de cada sessão do PowerShell. Em um prompt do PowerShell, use as setas para cima e para baixo no teclado para rolar pelo histórico de comandos. Para exibir a configuração PSReadLine para o histórico de comandos, use Get-PSReadLineOption. PSReadLine é disponibilizado com PowerShell 5.0 e superior. Para obter mais informações, consulte about_PSReadLine.

Exemplos

Exemplo 1: excluir o histórico de comandos de uma sessão do PowerShell

Esse comando exclui todos os comandos do histórico de uma sessão do PowerShell.

Get-History

Id CommandLine
  -- -----------
   1 Set-Location .\Test
   2 Update-Help
   3 Set-Location C:\Test\Logs
   4 Get-Location

Clear-History
Get-History

Id CommandLine
  -- -----------
   5 Clear-History

O cmdlet Get-History exibe o histórico da sessão do PowerShell. Clear-History exclui todo o histórico de comandos. Get-History exibe o histórico de comandos atualizado e confirma se o histórico anterior foi excluído.

Exemplo 2: excluir os comandos mais recentes

Esse comando usa os parâmetros Count e Newest para excluir os comandos mais recentes do histórico de uma sessão do PowerShell.

Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   3 Get-Command Clear-History -Syntax
   4 Get-Command Clear-History -ShowCommandInfo
   5 Get-Help Get-Alias
   6 Get-Command Get-ChildItem -Syntax
   7 Get-Help Clear-History
   8 Set-Location C:\Test\Logs
   9 Get-Help Get-Variable
  10 Get-Help Get-ChildItem

Clear-History -Count 5 -Newest
Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   3 Get-Command Clear-History -Syntax
   4 Get-Command Clear-History -ShowCommandInfo
   5 Get-Help Get-Alias
  11 Clear-History -Count 5 -Newest

O cmdlet Get-History exibe o histórico da sessão do PowerShell. Clear-History é usado para excluir o histórico de comandos. O parâmetro Count especifica o número de comandos a serem excluídos, inclusive da Id especificada. O parâmetro Newest especifica que os comandos mais recentes são apagados do histórico. Get-History exibe o histórico de comandos atualizado e confirma se os cinco comandos mais recentes foram excluídos, ID 6 - ID 10.

Exemplo 3: excluir comandos que correspondem a critérios específicos

Esse comando exclui comandos que correspondem a critérios específicos definidos pelo parâmetro CommandLine.

Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   3 Get-Command Clear-History -Syntax
   4 Get-Command Clear-History -ShowCommandInfo
   5 Get-Help Get-Alias
   6 Get-Command Get-ChildItem -Syntax
   7 Get-Help Clear-History

Clear-History -CommandLine *Help*, *Syntax
Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   4 Get-Command Clear-History -ShowCommandInfo
   8 Clear-History -CommandLine *Help*, *Syntax

O cmdlet Get-History exibe o histórico da sessão do PowerShell. Clear-History exclui o histórico de comandos. O parâmetro CommandLine especifica os comandos que contêm Help ou terminam com Syntax. Get-History exibe o histórico de comandos atualizado e confirma se os comandos Id 3, Id 5, ID 6e ID 7 foram excluídos.

Exemplo 4: excluir comandos por número de ID

Esse comando exclui itens específicos do histórico usando a Id . Para excluir vários comandos, envie uma lista de números de Id separados por vírgulas.

Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-History
   3 Get-Help Get-Alias
   4 Get-Command Clear-History
   5 Get-Command Clear-History -Syntax
   6 Get-Command Clear-History -ShowCommandInfo

Clear-History -Id 3, 5
Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-History
   4 Get-Command Clear-History
   6 Get-Command Clear-History -ShowCommandInfo
   7 Get-History
   8 Clear-History -Id 3, 5

O cmdlet Get-History exibe o histórico da sessão do PowerShell. Clear-History exclui o histórico de comandos. O parâmetro de ID especifica quais comandos excluir. Get-History exibe o histórico de comandos atualizado e confirma que ID 3 e ID 5 foram excluídos.

Exemplo 5: excluir comandos por número de ID e quantidade

Esse comando usa os parâmetros Id e Contagem para excluir o histórico de comandos. Os comandos são excluídos de Id especificado em ordem inversa, do mais recente para o mais antigo.

Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   3 Get-Command Clear-History -Syntax
   4 Get-Command Clear-History -ShowCommandInfo
   5 Get-Help Get-Alias
   6 Get-Command Get-ChildItem -Syntax
   7 Get-Help Clear-History
   8 Set-Location C:\Test\Logs
   9 Get-Help Get-Variable
  10 Get-Help Get-ChildItem

Clear-History -Id 7 -Count 5
Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   8 Set-Location C:\Test\Logs
   9 Get-Help Get-Variable
  10 Get-Help Get-ChildItem
  11 Clear-History -Id 7 -Count 5

O cmdlet Get-History exibe o histórico da sessão do PowerShell. Clear-History exclui o histórico de comandos. O parâmetro Id especifica que deve se começar com Id 7. O parâmetro Count especifica que se deve excluir cinco comandos, incluindo Id. Get-History especificado que exibe o histórico de comandos atualizados e confirma que os cinco comandos foram excluídos Id 3 - Id 7.

Parâmetros

-CommandLine

Exclui o histórico de comandos de uma sessão do PowerShell. A cadeia de caracteres deve ser uma correspondência exata ou usar caracteres curinga para fazer a correspondência com os comandos no histórico de sessão do PowerShell exibido por Get-History. Se você inserir mais de uma cadeia de caracteres, Clear-History excluirá os comandos que correspondem a qualquer uma das cadeias de caracteres. O parâmetro CommandLine pode ser usado com Count.

Para as cadeias de caracteres com um espaço, use as aspas simples. Para obter mais informações, consulte about_Quoting_Rules.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-Confirm

Solicita a confirmação antes de executar o cmdlet Clear-History.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Count

Especifica o número de entradas de histórico que Clear-History exclui. Os comandos são excluídos em ordem, começando com a entrada mais antiga do histórico.

Os parâmetros Count e Id podem ser usados juntos. O parâmetro Count especifica o número de comandos a serem excluídos, inclusive de Id especificado. A partir de especificado, os comandos são excluídos em ordem sequencial inversa. Por exemplo, se Id for 30 e Count for 10, Clear-History excluirá os itens de 21 a 30.

Os parâmetros Count e CommandLine podem ser usados juntos. Count especifica o número de comandos a serem excluídos que correspondem ao valor do parâmetro CommandLine. Os comandos são excluídos em ordem sequencial.

Tipo:Int32
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica o histórico de comandos Id que Clear-History exclui. Para exibir os números de Id, use o cmdlet Get-History. Os números de ID são sequenciais e os comandos mantêm seu número de ID em uma sessão do PowerShell. O parâmetro Id pode ser usado com Count e Newest.

Tipo:Int32[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Newest

Quando o parâmetro mais recente é usado, Clear-History exclui as entradas mais recentes do histórico. Por padrão, Clear-History exclui as entradas mais antigas do histórico.

O parâmetro Newest pode ser usado com Id e Count. O parâmetro Count especifica o número de comandos a serem excluídos, inclusive de Id especificado. A partir de Id especificado, os comandos são excluídos em ordem sequencial. Por exemplo, se Id for 30 e Count for 10, Clear-History excluirá os itens de 30 a 39.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet Clear-History fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Você não pode redirecionar objetos para este cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

O PowerShell inclui os seguintes aliases para Clear-History:

  • Todas as plataformas:
    • clhy

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

O histórico de sessão é gerenciado separadamente do histórico mantido pelo módulo PSReadLine. Os dois históricos estão disponíveis nas sessões em que se carrega PSReadLine. Esse cmdlet funciona apenas com o histórico da sessão. Para obter mais informações, consulte about_PSReadLine.