Usar manipuladores de chave PSReadLine

O módulo PSReadLine fornece manipuladores de teclas que mapeiam funções PSReadLine para combinações de teclado. As combinações de teclado são uma sequência de um ou mais pressionamentos de tecla que são feitos ao mesmo tempo. Por exemplo a combinação CTRL+Barra de espaços é um atalho em que Ctrl e a Barra de espaços são pressionadas ao mesmo tempo. A função PSReadLine é uma ação predefinida que pode ser executada em uma linha de comando. Por exemplo, a função MenuComplete permite que você escolha entre uma lista de opções em um menu para concluir a entrada na linha de comando.

A PSReadLine tem vários manipuladores de teclas predefinidos associados por padrão. Você também pode definir seus próprios manipuladores de teclas personalizados. Execute o seguinte comando para listar os manipuladores de teclas definidos no momento.

Get-PSReadLineKeyHandler

Você também pode obter uma lista de todas as funções PSReadLine não associadas que estão disponíveis para serem associadas a uma combinação de teclas.

Get-PSReadLineKeyHandler -Unbound

Você pode usar o cmdlet Set-PSReadLineKeyHandler para associar uma função a um manipulador de teclas. O comando a seguir associa a função MenuComplete à combinação Ctrl+Barra de espaços.

Set-PSReadLineKeyHandler -Chord 'Ctrl+Spacebar' -Function MenuComplete

Como localizar nomes de teclas e associações de combinação

Os nomes das teclas na combinação são definidos pela enumeração [System.ConsoleKey]. Para obter mais informações, confira a documentação de System.ConsoleKey. Por exemplo, o nome da tecla 2 em [System.ConsoleKey] é D2, enquanto o nome da tecla 2 no teclado numérico é NumPad2. Você pode usar o método [System.Console]::ReadKey() para localizar o nome da tecla pressionada.

[System.Console]::ReadKey()

A saída a seguir mostra as informações retornadas pelo método ReadKey() para a combinação de teclas Ctrl+2.

KeyChar Key Modifiers
------- --- ---------
        D2   Control

Para os cmdlets do manipulador de teclas de PSReadLine, essa combinação é representada como Ctrl+D2. O exemplo a seguir associa essa combinação a uma função.

Set-PSReadLineKeyHandler -Chord 'Ctrl+D2' -Function MenuComplete

Você pode associar várias combinações a uma única função. Por padrão, a função BackwardDeleteChar é associada a duas combinações.

Get-PSReadLineKeyHandler -Chord Backspace, Ctrl+h

Key       Function           Description
---       --------           -----------
Backspace BackwardDeleteChar Delete the character before the cursor
Ctrl+h    BackwardDeleteChar Delete the character before the cursor

No Windows, você também pode usar a combinação de tecla Alt+? para mostrar a função associada à próxima combinação de tecla inserida. Ao digitar Alt+? você vê o seguinte prompt:

what-is-key:

Quando você clica na tecla Backspace, obtém a seguinte resposta:

Backspace: BackwardDeleteChar - Delete the character before the cursor

Manipuladores de teclas em computadores não Windows

Os códigos de teclas gerados pelo seu teclado podem ser diferentes dependendo do sistema operacional e do aplicativo de terminal que você está usando.

macOS

O teclado Macintosh não tem uma tecla Alt como sistemas Windows e Linux. Ele tem a tecla de ⌥ Opção. O macOS usa essa tecla de forma diferente da tecla Alt em outros sistemas. No entanto, você pode configurar os aplicativos de terminal e iTerm2 no macOS para tratá-lo como uma tecla Alt.

Configurando o aplicativo de Terminal

Abra a janela de Configurações na Barra de aplicativos em Terminal.app. Selecione Perfis e escolha o perfil que você deseja configurar. Selecione a guia Teclado nas opções de configuração. Abaixo da lista de teclas, selecione a configuração Usar Opção de Tecla Meta. Essa configuração permite que a tecla de ⌥ Opção atue como Alt no aplicativo de Terminal.

Como configurar o aplicativo iTerm2

Abra a janela de Configurações na Barra de Aplicativos do iTerm.app. Selecione Perfis e escolha o perfil que você deseja configurar. Selecione a guia Teclas nas opções de configuração. Selecione a opção Esc+ para as configurações de Tecla de Opção Esquerda e Tecla de Opção Direita. Essa configuração permite que a tecla de ⌥ Opção atue como Alt no aplicativo iTerm.

Linux

Em plataformas Linux, o código de tecla gerado pode ser diferente de outros sistemas. Por exemplo:

• Ctrl+[ é o mesmo que Escape

• Ctrl+Barra de espaços gera os códigos de chave para Ctrl+D2. Para mapear uma função Ctrl+Barra de espaços, use a combinação Ctrl+D2.

  Set-PSReadLineKeyHandler -Chord 'Ctrl+D2' -Function MenuComplete
  

Use o método ReadKey() para verificar os códigos de tecla gerados pelo teclado.

Manipuladores de teclas comumente usados

Veja aqui alguns manipuladores de teclas comumente usados que são associados por padrão no Windows. Observe que a associação de tecla pode ser diferente em plataformas não Windows.

MenuComplete

Complete a entrada selecionando em um menu de possíveis valores de conclusão.

Combinação padrão: Ctrl+Spacebar

O seguinte exemplo mostra o menu de possíveis conclusões para comandos que começam com select.

PS C:\> select<Ctrl+Spacebar>
select                   Select-Object            Select-PSFPropertyValue  Select-Xml
Select-AzContext         Select-PSFConfig         Select-PSMDBuildProject
Select-AzSubscription    Select-PSFObject         Select-String

Select-Object

Use as teclas de direção para selecionar a conclusão desejada. Pressione a tecla Enter para concluir a entrada. À medida que você percorre as seleções, a ajuda para o comando selecionado é exibida abaixo do menu.

ClearScreen

Essa função limpa a tela semelhante aos comandos cls ou clear.

Combinação padrão: Ctrl+l

SelectCommandArgument

Seleciona o próximo argumento na linha de comando.

Combinação padrão: Alt+a

Você pode ter um comando em seu histórico que deseja executar novamente com valores de parâmetros diferentes. Você pode usar o acorde para percorrer cada parâmetro e alterar o valor conforme necessário.

New-AzVM -ResourceGroupName myRGName -Location eastus -Name myVM

Pressionar Alt+a seleciona o próximo argumento de parâmetro: myRGName, eastus, myVM.

GotoBrace

Move o cursor para a chave correspondente.

Combinação padrão: Ctrl+]

Essa função move o cursor para a chave de fechamento que corresponde à chave na posição atual do cursor na linha de comando. A função funciona para colchetes ([]), chaves ({}) e parênteses, (()).

DigitArgument

Inicie ou acumule um argumento numérico usado para repetir um pressionamento de tecla o número especificado de vezes.

Combinação padrão: de Alt+0 a Alt+9

Por exemplo, digitar Alt+4+# insere #### na linha de comando.

Confira também

• Get-PSReadLineKeyHandler
• Set-PSReadLineKeyHandler