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.

O pager em PSReadLine permite-lhe navegar pela ajuda apresentada 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 .

Selecionar argumentos na linha de comandos

Para selecionar e editar rapidamente os argumentos de um cmdlet sem perturbar a sua sintaxe, use o Alt+a. Procura a partir da posição atual do cursor e para quando encontra um argumento na linha de comandos. Seleciona o argumento completo, tornando simples a substituição ou edição do argumento.

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++ gera uma sequência de teclas Control+ em vez da sequência deControl 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.