Clear-History

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

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

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 PSReadLine e about_PSReadLine.

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

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 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 contagem de especifica o número de comandos a serem excluídos, inclusive do de ID deespecificado. 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 se os cinco comandos mais recentes foram excluídos, ID 6 - ID 10.

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

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.

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

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.

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

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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

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

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.