Usando ajuda dinâmica

A Ajuda Dinâmica oferece ajuda em tempo real que ajuda você a manter o foco no seu trabalho sem perder a posição enquanto digita na linha de comando.

Obtendo 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 está no final de um nome de cmdlet totalmente expandido, pressionar F1exibe 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 que começa no parâmetro.

O pager no PSReadLine permite rolar 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 primária.

Obtendo ajuda de 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ê pressionar a tecla Alt+h .

Selecionar argumentos na linha de comando

Para selecionar e editar rapidamente os argumentos de um cmdlet sem perturbar sua sintaxe, use Alt a+. A busca inicia a partir da posição atual do cursor e para ao encontrar um argumento na linha de comando. Ele seleciona o argumento completo, simplificando a substituição ou edição do argumento.

Escolhendo associações de chaves

Nem todas as associações de chaves funcionam para todos os sistemas operacionais e aplicativos de terminal. Por exemplo, associações de chave para a chave Alt não funcionam no macOS por padrão. No Linux, Ctrl+[ é o mesmo que Escape. E Ctrl+Barra de espaço gera uma sequência de teclas Controle+2 em vez da sequência de Controle+Barra de espaço esperada.

Para contornar essas peculiaridades, mapeie a função PSReadLine para uma combinação de chaves 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, consulte Usando manipuladores de chave PSReadLine.