Compartilhar via


Usando a ajuda dinâmica

A Ajuda Dinâmica fornece ajuda just-in-time que permite manter o foco em seu trabalho sem perder seu lugar digitando na linha de comando.

Obtendo ajuda com 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 está no final de um nome de cmdlet totalmente expandido, pressionar F1exibe a ajuda desse cmdlet.
  • Quando o cursor está no final de um nome de parâmetro totalmente expandido, pressionar F1exibe a ajuda do cmdlet que começa no parâmetro.

Ajuda dinâmica em tela cheia

O pager em PSReadLine permite percorrer a ajuda exibida usando as teclas de direção para cima e para baixo. Pressionar Q sai do buffer de tela alternativa e retorna para a posição atual do cursor na linha de comando na tela primária.

Como obter ajuda com parâmetros focados

Pressionar Alt+h fornece ajuda dinâmica para parâmetros. A ajuda aparece 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 focalizada para um parâmetro usando Alt-h

Como selecionar 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 na posição atual do cursor e para quando encontra argumentos na linha de comando.

Seleção de argumento usando Alt-A

Como escolher associações de teclas

Nem todas as associações de teclas funcionam em todos os sistemas operacionais e aplicativos de terminal. Por exemplo, por padrão, associações de teclas para Alt não funcionam no macOS. No Linux, Ctrl+[ é o mesmo que Escape. E a CTRL+Barra de espaços gera uma sequência de teclas Control+2 em vez de uma Control+Barra de espaços 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 associações de chaves e soluções alternativas, confira Como usar manipuladores de teclas PSReadLine.