Clear-History
Exclui entradas do histórico de comandos.
Sintaxe
Clear-History [[-Id] <Int32[]>] [[-Count] <int>] [-Newest] [-Confirm] [-WhatIf] [<CommonParameters>]
Clear-History [[-Count] <int>] [-CommandLine <string[]>] [-Newest] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrição
O cmdlet Clear-History exclui comandos do histórico de comandos, ou seja, a lista de comandos inseridos durante a sessão atual.
Sem parâmetros, Clear-History exclui todos os comandos do histórico da sessão, mas você pode usar os parâmetros de Clear-History para excluir comandos selecionados.
Parâmetros
-CommandLine <string[]>
Exclui comandos com as cadeias de caracteres de texto especificadas. Se você inserir mais de uma cadeia de caracteres, Clear-History excluirá comandos com qualquer uma das cadeias de caracteres.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
true |
-Count <int>
Apaga o número especificado de entradas de histórico, começando com a entrada mais antiga no histórico.
Se você usar os parâmetros Count e Id no mesmo comando, o cmdlet apagará o número de entradas especificado pelo parâmetro Count, começando com a entrada especificada pelo parâmetro Id. Por exemplo, se Count for 10 e Id for 30, Clear-History apagará os itens de 21 a 30 (inclusive).
Se você usar os parâmetros Count e CommandLine no mesmo comando, Clear-History apagará o número de entradas especificado pelo parâmetro Count, começando com a entrada especificada pelo parâmetro CommandLine.
Necessário? |
false |
Posição? |
2 |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Id <Int32[]>
Exclui comandos com as IDs de histórico especificadas.
Para localizar a ID de histórico de um comando, use Get-History.
Necessário? |
false |
Posição? |
1 |
Valor padrão |
Nenhum |
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Newest
Exclui as entradas mais recentes do histórico. Por padrão, Clear-History exclui as entradas mais antigas do histórico.
Necessário? |
false |
Posição? |
named |
Valor padrão |
False |
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Confirm
Solicita confirmação antes da execução do comando.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-WhatIf
Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
Entradas |
Nenhum Não é possível canalizar objetos para Clear-History. |
Saídas |
Nenhum Este cmdlet não gera nenhuma saída. |
Observações
O histórico da sessão é uma lista dos comandos inseridos durante a sessão. Você pode exibir o histórico, adicionar e excluir comandos e executar comandos do histórico. Para obter mais informações, consulte about_History.
Excluir um comando do histórico não altera as IDs de histórico dos itens restantes no histórico de comandos.
Exemplo 1
C:\PS>clear-history
Descrição
-----------
Exclui todos os comandos do histórico da sessão.
Exemplo 2
C:\PS>clear-history -id 23, 25
Descrição
-----------
Exclui os comandos com IDs de histórico 23 e 25.
Exemplo 3
C:\PS>clear-history -command *help*, *command
Descrição
-----------
Exclui comandos que incluem "help" ou terminam em "command".
Exemplo 4
C:\PS>clear-history -count 10 -newest
Descrição
-----------
Exclui os 10 comandos mais recentes do histórico.
Exemplo 5
C:\PS>clear-history -id 10 -count 3
Descrição
-----------
Exclui o três comandos mais antigos que começam com a entrada com ID 10.