Clear-History
Exclui entradas do histórico de comandos do PowerShell.
Sintaxe
IDParameter (Predefinição)
Clear-History
[[-Id] <int[]>]
[[-Count] <int>]
[-Newest]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CommandLineParameter
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 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 percorrer o histórico de comandos. Para exibir a configuração de PSReadLine para o 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
Este 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 que o histórico anterior foi excluído.
Exemplo 2: Excluir os comandos mais recentes
Este comando usa os parâmetros Count e Latest 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 Count especifica o número de comandos a serem excluídos, incluindo o especificado Id. 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
Este 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 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 6e Id 7 foram excluídos.
Exemplo 4: Excluir comandos por número de ID
Este comando exclui itens específicos do histórico usando o de Id. Para excluir vários comandos, envie uma lista separada por vírgulas de Id números.
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 Id especifica quais comandos devem ser excluídos.
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 contagem
Este comando usa os parâmetros Id e Count para excluir o histórico de comandos. Os comandos são excluídos do de ID de especificado na ordem inversa, do mais novo 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 para começar com Id 7. O parâmetro Count especifica a exclusão de cinco comandos, incluindo o Id deespecificado. 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 por 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.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
CommandLineParameter
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet Clear-History.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Count
Especifica o número de entradas do 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 eliminar, incluindo o Id especificado. A partir do Id especificado de, os comandos são excluídos em ordem inversa. Por exemplo, se o de Id for 30 e o de Contagem de 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 eliminar que correspondem ao valor do parâmetro CommandLine. Os comandos são excluídos em ordem sequencial.
Propriedades dos parâmetros
| Tipo: | Int |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Id
Especifica o histórico de comandos Id que Clear-History exclui. Para exibir números de identificação , use o cmdlet Get-History. Os números de Id são sequenciais e os comandos mantêm o seu número de Id durante uma sessão do PowerShell. O parâmetro Id pode ser usado com Count e Newest.
Propriedades dos parâmetros
| Tipo: | Int[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
IDParameter
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Newest
Quando o parâmetro mais recente é 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 eliminar, incluindo o Id especificado. A partir do Id especificado, os comandos são eliminados em ordem sequencial. Por exemplo, se o Id for 30 e o Contagem for 10, Clear-History apaga os itens 30 a 39.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet Clear-History fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
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.
Entradas
None
Não é possível canalizar 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 inseridos durante uma sessão do PowerShell. Você pode visualizar o histórico, adicionar e excluir comandos e executar comandos do histórico. Para obter mais informações, consulte about_History.