Partilhar via


Usando a ajuda dinâmica

A Ajuda Dinâmica fornece ajuda just-in-time que lhe permite manter o foco no seu trabalho sem perder o seu lugar a escrever na linha de comandos.

Obter ajuda do cmdlet

A Ajuda dinâmica fornece uma exibição da ajuda completa do cmdlet mostrada em um buffer de tela alternativo. PSReadLine mapeia a função ShowCommandHelp para a tecla F1.

  • Quando o cursor estiver no final de um nome de cmdlet totalmente expandido, pressionar F1exibirá a ajuda para esse cmdlet.
  • Quando o cursor está no final de um nome de parâmetro totalmente expandido, pressionar F1exibe a ajuda para o cmdlet começando no parâmetro.

Ajuda dinâmica em tela cheia

O pager em PSReadLine permite que você role a ajuda exibida usando as teclas de seta para cima e para baixo. Pressionar Q sai do buffer de tela alternativo e retorna à posição atual do cursor na linha de comando na tela principal.

Ajuda para obter parâmetros focados

Pressionar Alt+h fornece ajuda dinâmica para parâmetros. A ajuda é mostrada abaixo da linha de comando atual semelhante a MenuComplete. O cursor deve estar no final do nome do parâmetro totalmente expandido quando você pressiona a tecla Alt+h .

Ajuda focada para um parâmetro usando Alt-h

Selecionando argumentos na linha de comando

Para selecionar e editar rapidamente os argumentos de um cmdlet sem perturbar sua sintaxe usando Alt+a. Com base na posição do cursor, ele pesquisa a partir da posição atual do cursor e para quando encontra argumentos na linha de comando.

Seleção de argumentos usando Alt-A

Escolhendo keybindings

Nem todas as ligações de teclas funcionam para todos os sistemas operativos e aplicações de terminal. Por exemplo, as ligações de teclas para a tecla Alt não funcionam no macOS por padrão. No Linux, Ctrl+[ é o mesmo que Escape. E Ctrl++ Spacebar gera uma sequência de teclas Control+2 em vez da sequência de Control Spacebar esperada.

Para contornar essas peculiaridades, mapeie a função PSReadLine para uma combinação de teclas disponível. Por exemplo:

Set-PSReadLineKeyHandler -chord 'Ctrl+l' -Function ShowParameterHelp
Set-PSReadLineKeyHandler -Chord 'Ctrl+k' -Function SelectCommandArgument

Para obter mais informações sobre ligações de teclas e soluções alternativas, consulte Usando manipuladores de chaves PSReadLine.