Clear-History

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

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

Syntax

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 Get-History cmdlet.

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 PSReadLine comandos. O PSReadLine módulo 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 do histórico de PSReadLine comandos, use Get-PSReadLineOption. PSReadLine fornecido com o PowerShell 5.0 e superior. Para obter mais informações, confira 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 Get-History cmdlet 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 que 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 Get-History cmdlet 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, incluindo a ID especificada. O parâmetro Newest especifica que os comandos mais recentes são limpos do histórico. Get-Historyexibe o histórico de comandos atualizado e confirma que 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 Get-History cmdlet exibe o histórico da sessão do PowerShell. Clear-History Exclui o histórico de comandos. O parâmetro CommandLine especifica comandos que contêm Ajuda ou terminam com Sintaxe. Get-History exibe o histórico de comandos atualizado e confirma que os comandos Id 3, Id 5, Id 6 e Id 7 foram excluídos.

Exemplo 4: Excluir comandos por número de ID

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

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 Get-History cmdlet exibe o histórico da sessão do PowerShell. Clear-History Exclui o histórico de comandos. O parâmetro Id especifica quais comandos devem ser excluídos. Get-History exibe o histórico de comandos atualizado e confirma que o Id 3 e o Id 5 foram excluídos.

Exemplo 5: Excluir comandos por número de ID e contagem

Esse comando usa os parâmetros Id e Count para excluir o histórico de comandos. Os comandos são excluídos do ID especificado na 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 Get-History cmdlet exibe o histórico da sessão do PowerShell. Clear-History Exclui o histórico de comandos. O parâmetro Id especifica para começar com Id 7. O parâmetro Count especifica a exclusão de cinco comandos, incluindo o Id especificado. Get-History exibe o histórico de comandos atualizado e confirma que 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 curingas para corresponder aos comandos no histórico de sessões do PowerShell exibido pelo Get-History. Se você inserir mais de uma cadeia de caracteres, Clear-History excluirá comandos que correspondam a qualquer uma das cadeias de caracteres. O parâmetro CommandLine pode ser usado com Count.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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, incluindo a ID especificada. A partir da ID especificada, os comandos são excluídos na ordem sequencial inversa. Por exemplo, se o Id for 30 e a Contagem for 10, Clear-History excluirá os itens 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.

Type:Int32
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:Int32[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Newest

Quando o parâmetro Newest é usado, Clear-History exclui as entradas mais recentes no 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, incluindo a ID especificada. A partir da ID especificada, os comandos são excluídos em ordem sequencial. Por exemplo, se o Id for 30 e a Contagem for 10, Clear-History excluirá os itens 30 a 39.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Não é possível canalizar objetos para esse 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ões do PowerShell é uma lista dos comandos inseridos durante uma sessão do PowerShell. Você pode exibir o histórico, adicionar comandos de exclusão e executar comandos por meio do histórico. Para obter mais informações, consulte about_History.

O histórico da sessão é gerenciado separadamente do histórico mantido pelo módulo PSReadLine . Ambos os históricos estão disponíveis em sessões onde o PSReadLine é carregado. Esse cmdlet só funciona com o histórico da sessão. Para obter mais informações, consulte about_PSReadLine.