Compartilhar via

Clear-History

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

Exclui entradas do histórico de comandos 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 PSReadLine histórico de 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 PSReadLine histórico de comandos, use Get-PSReadLineOption. PSReadLine fornecido com o PowerShell 5.0 e superior. Para obter mais informações, consulte PSReadLine e 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.

PS> Get-History

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

PS> Clear-History

PS> 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 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.

PS> 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

PS> Clear-History -Count 5 -Newest

PS> 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, inclusive da ID especificada. O parâmetro Newest especifica que os comandos mais recentes são limpos do histórico. Get-History exibe 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 .

PS C:\Test> 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

PS> Clear-History -CommandLine *Help*, *Syntax

PS> 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 se 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 .

PS> 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

PS C:\> Clear-History -Id 3, 5

PS> 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 excluir. Get-History exibe o histórico de comandos atualizado e confirma se a ID 3 e a ID 5 foram excluídas.

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 da ID especificada na ordem inversa, mais recente para a mais antiga.

PS> 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

PS> Clear-History -Id 7 -Count 5

PS> 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 a ID 7. O parâmetro Count especifica a exclusão de cinco comandos, inclusive da ID especificada. 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 caracteres curinga para corresponder aos 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 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 são excluídas. Os comandos são excluídos na 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 da ID especificada. A partir da ID especificada, os comandos são excluídos em ordem sequencial inversa. Por exemplo, se a ID for 30 e a Contagem 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.

Type:Int
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 em uma sessão do PowerShell. O parâmetro Id pode ser usado com Count e Newest.

Type:Int[]
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 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 da ID especificada. A partir da ID especificada, os comandos são excluídos em ordem sequencial. Por exemplo, se a ID for 30 e a Contagem for 10, Clear-History excluirá os itens de 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 redirecionar objetos para Clear-History.

Saídas

None

Clear-History não gera nenhuma saída.

Observações

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 comandos de exclusão e executar comandos por meio do histórico. Para obter mais informações, consulte about_History.