about_History
Descrição breve
Descreve como obter e executar comandos no histórico de comandos.
Descrição longa
Quando você insere um comando no prompt de comando, o PowerShell salva o comando no histórico de comandos. Você pode usar os comandos no histórico como um registro do seu trabalho. Além disso, você pode recuperar e executar os comandos do histórico de comandos.
O PowerShell tem dois provedores de histórico diferentes: o histórico interno e o histórico gerenciado pelo módulo PSReadLine . Os históricos são gerenciados separadamente, mas ambos os históricos estão disponíveis em sessões em que o PSReadLine é carregado.
Usando o histórico do PSReadLine
O histórico PSReadLine controla os comandos usados em todas as sessões do PowerShell.
O histórico é gravado em um arquivo central por host. Esse arquivo de histórico está disponível para todas as sessões e contém todo o histórico passado. O histórico não é excluído quando a sessão termina. Além disso, esse histórico não pode ser gerenciado pelos *-History
cmdlets. Para obter mais informações, confira about_PSReadLine.
Usando o histórico de sessões interno
O histórico interno rastreia apenas os comandos usados na sessão atual. O histórico não está disponível para outras sessões e é excluído quando a sessão termina.
Cmdlets de histórico
O PowerShell tem um conjunto de cmdlets que gerenciam o histórico de comandos.
Cmdlet | Alias | Descrição |
---|---|---|
Get-History |
h |
Obtém o histórico de comandos. |
Invoke-History |
r |
Executa um comando no histórico de comandos. |
Add-History |
Adiciona um comando ao histórico de comandos. | |
Clear-History |
clhy |
Exclui comandos do histórico de comandos. |
Atalhos de teclado para gerenciar o histórico
No console do PowerShell, você pode usar os seguintes atalhos para gerenciar o histórico de comandos.
- Seta para cima - Exibe o comando anterior.
- Seta para baixo - Exibe o próximo comando.
- F7 - Exibe o histórico de comandos.
- ESC - Para esconder a história.
- F8 - Localiza um comando. Digite um ou mais caracteres e pressione F8. Pressione F8 novamente na próxima instância.
- F9 - Localizar um comando por ID de histórico. Digite o ID do histórico e pressione F9. Pressione F7 para localizar o ID.
- #
<string>
Guia - Pesquise o histórico*<string>*
e retorne a correspondência mais recente. Se você pressionar Tab repetidamente, ele percorrerá os itens correspondentes em seu histórico.
Observação
Essas associações de chave são implementadas pelo aplicativo host do console. Outros aplicativos, como o Visual Studio Code ou o Windows Terminal, podem ter associações de chave diferentes. As ligações podem ser substituídas pelo módulo PSReadLine. PSReadLine é carregado automaticamente quando você inicia uma sessão do PowerShell. Com PSReadLine carregado, F7 e F9 não estão vinculados a nenhuma função. PSReadLine não fornece funcionalidade equivalente. Para obter mais informações, confira about_PSReadLine.
MaximumHistoryCount
A $MaximumHistoryCount
variável de preferência determina o número máximo de comandos que o PowerShell salva no histórico de comandos. O valor padrão é 4096.
Por exemplo, o comando a seguir reduz o $MaximumHistoryCount
para 100 comandos:
$MaximumHistoryCount = 100
Para aplicar a configuração, reinicie o PowerShell.
Para salvar o novo valor de variável para todas as sessões do PowerShell, adicione a instrução de atribuição a um perfil do PowerShell. Para obter mais informações sobre perfis, consulte about_Profiles.
Para obter mais informações sobre a variável de $MaximumHistoryCount
preferência, consulte about_Preference_Variables.
Ordem dos comandos no histórico
Os comandos são adicionados ao histórico quando o comando termina de ser executado, não quando o comando é inserido. Se os comandos levarem algum tempo para serem concluídos ou se os comandos estiverem sendo executados em um prompt aninhado, os comandos podem parecer estar fora de ordem no histórico. Os comandos que estão sendo executados em um prompt aninhado são concluídos somente quando você sai do nível de prompt.