Partilhar via

Clear-History

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

Elimina 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 elimina o histórico de comandos de uma sessão do PowerShell. Cada sessão do PowerShell tem o seu próprio histórico de comandos. Para apresentar o histórico de comandos, utilize o Get-History cmdlet.

Por predefinição, Clear-History elimina todo o histórico de comandos de uma sessão do PowerShell. Pode utilizar parâmetros com Clear-History para eliminar comandos selecionados.

Clear-History não limpa o ficheiro do PSReadLine histórico de comandos. O PSReadLine módulo armazena um ficheiro de histórico que contém todos os comandos do PowerShell de todas as sessões do PowerShell. A partir de uma linha de comandos do PowerShell, utilize as setas para cima e para baixo no teclado para percorrer o histórico de comandos. Para apresentar a configuração do PSReadLine histórico de comandos, utilize Get-PSReadLineOption. PSReadLine enviado com o PowerShell 5.0 e superior. Para obter mais informações, veja PSReadLine e about_PSReadLine.

Exemplos

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

Este comando elimina 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 apresenta o histórico da sessão do PowerShell. Clear-History elimina todo o histórico de comandos. Get-History apresenta o histórico de comandos atualizado e confirma que o histórico anterior foi eliminado.

Exemplo 2: eliminar os comandos mais recentes

Este comando utiliza os parâmetros Contar e Mais Recentes para eliminar 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 apresenta o histórico da sessão do PowerShell. Clear-History é utilizado para eliminar o histórico de comandos. O parâmetro Contar especifica o número de comandos a eliminar, incluindo o ID especificado. O parâmetro Mais Recente especifica que os comandos mais recentes são limpos do histórico. Get-History apresenta o histórico de comandos atualizado e confirma que os cinco comandos mais recentes foram eliminados, ID 6 - ID 10.

Exemplo 3: eliminar comandos que correspondam a critérios específicos

Este comando elimina comandos que correspondem a critérios específicos definidos pelo parâmetro Linha de Comandos .

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 apresenta o histórico da sessão do PowerShell. Clear-History elimina o histórico de comandos. O parâmetro Linha de Comandos especifica comandos que contêm Ajuda ou terminam com Sintaxe. Get-History apresenta o histórico de comandos atualizado e confirma que os comandos ID 3, ID 5, ID 6 e ID 7 foram eliminados.

Exemplo 4: Eliminar comandos por número de ID

Este comando elimina itens de histórico específicos com o ID. Para eliminar vários comandos, submeta 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 apresenta o histórico da sessão do PowerShell. Clear-History elimina o histórico de comandos. O parâmetro ID especifica os comandos a eliminar. Get-History apresenta o histórico de comandos atualizado e confirma que o ID 3 e o ID 5 foram eliminados.

Exemplo 5: Eliminar comandos por número de ID e contar

Este comando utiliza os parâmetros ID e Contagem para eliminar o histórico de comandos. Os comandos são eliminados do ID especificado por ordem inversa, 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 Get-History cmdlet apresenta o histórico da sessão do PowerShell. Clear-History elimina o histórico de comandos. O parâmetro ID especifica para começar com o ID 7. O parâmetro Contar especifica para eliminar cinco comandos, incluindo o ID especificado. Get-History apresenta o histórico de comandos atualizado e confirma que cinco comandos foram eliminados, ID 3 - ID 7.

Parâmetros

-CommandLine

Elimina o histórico de comandos de uma sessão do PowerShell. A cadeia tem de ser uma correspondência exata ou utilizar carateres universais para corresponder aos comandos no histórico de sessões do PowerShell apresentado por Get-History. Se introduzir mais do que uma cadeia, Clear-History elimina comandos que correspondem a qualquer uma das cadeias. O parâmetro Linha de Comandos pode ser utilizado com Contagem.

Para cadeias com um espaço, utilize aspas individuais. Para obter mais informações, veja about_Quoting_Rules.

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

-Confirm

Pede-lhe 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 do histórico que Clear-History elimina. Os comandos são eliminados por ordem, começando pela entrada mais antiga do histórico.

Os parâmetros Contar e ID podem ser utilizados em conjunto. O parâmetro Contar especifica o número de comandos a eliminar, incluindo o ID especificado. A partir do ID especificado, os comandos são eliminados por ordem sequencial inversa. Por exemplo, se o ID for 30 e a Contagem for 10, Clear-History elimina os itens 21 a 30.

Os parâmetros Contar e Linha de Comandos podem ser utilizados em conjunto. A contagem especifica o número de comandos a eliminar que correspondem ao valor do parâmetro Linha de Comandos . Os comandos são eliminados por ordem sequencial.

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

-Id

Especifica o ID do histórico de comandos que Clear-History elimina. Para apresentar números de ID , utilize o Get-History cmdlet. Os números de ID são sequenciais e os comandos mantêm o respetivo número de ID numa sessão do PowerShell. O parâmetro ID pode ser utilizado 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 Mais Recente é utilizado, Clear-History elimina as entradas mais recentes do histórico. Por predefinição, Clear-History elimina as entradas mais antigas do histórico.

O parâmetro Mais Recente pode ser utilizado com ID e Contagem. O parâmetro Contar especifica o número de comandos a eliminar, incluindo o ID especificado. A partir do ID especificado, os comandos são eliminados por ordem sequencial. Por exemplo, se o ID for 30 e a Contagem for 10, Clear-History elimina 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 encaminhar objetos para Clear-History.

Saídas

None

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

Notas

O histórico de sessões do PowerShell é uma lista dos comandos introduzidos durante uma sessão do PowerShell. Pode ver o histórico, adicionar e eliminar comandos e executar comandos do histórico. Para obter mais informações, consulte about_History.