Compartilhar via

about_Tab_Expansion

  • Artigo

Descrição breve

O PowerShell fornece preenchimentos de entrada para fornecer dicas, habilitar a descoberta e acelerar a entrada de informações. Nomes de comando, nomes de parâmetros, valores de argumento e caminhos de arquivo podem ser preenchidos pressionando a tecla Tab.

Descrição longa

A expansão de guias é controlada pela função interna TabExpansion2. Como essa função pode ser modificada ou substituída, essa discussão é um guia para o comportamento da configuração padrão do PowerShell.

O comportamento de expansão da guia também pode ser modificado pelo recurso IntelliSense preditivo do módulo PSReadLine. Para obter mais informações, consulte IntelliSense preditivo.

A tecla Tab é a associação de teclas padrão no Windows. Você pode alterar a vinculação de chave usando o módulo PSReadLine ou o aplicativo que está hospedando o PowerShell. Para obter mais informações, confira about_PSReadLine.

Observação

Uma limitação do processo de expansão de guia é que as guias são sempre interpretadas como tentativas de preencher uma palavra. Se você copiar e colar exemplos de comando em um console do PowerShell, verifique se o exemplo não contém guias. Se isso acontecer, os resultados serão imprevisíveis e quase certamente não serão os que você pretendia.

Conclusão do nome do arquivo e do cmdlet

Para preencher automaticamente um nome de arquivo ou um caminho com as opções disponíveis automaticamente, digite parte do nome e pressione a tecla Tab. O PowerShell expande automaticamente o nome para a primeira correspondência que encontra. Pressionar a tecla Tab repetidamente percorre todas as opções disponíveis.

A expansão com Tab de nomes de cmdlet é ligeiramente diferente. Para usar a expansão com Tab em um nome de cmdlet, digite a primeira parte inteira do nome (o verbo) e o hífen que o segue. Você pode preencher mais do mesmo nome de uma correspondência parcial. Por exemplo, se você digitar get-co e pressionar a tecla Tab, o PowerShell expandirá automaticamente isso para o Get-Command cmdlet. Observe que ele também muda o caso das letras para sua forma padrão. Se você pressionar a tecla Tab novamente, o PowerShell substitui isso pelo outro único nome de cmdlet correspondente, Get-Content.

A conclusão de tabulação também funciona para resolver alias do PowerShell e executáveis nativos.

Você pode usar a expansão com Tab várias vezes na mesma linha. Por exemplo, você pode usar a expansão de guias no nome do cmdlet Get-Content digitando:

Exemplos

PS> Get-Con<Tab>

Quando você pressiona a tecla Tab, o comando se expande para:

PS> Get-Content

Você pode especificar parcialmente o caminho para o arquivo de log Active Setup e usar a expansão com Tab novamente:

PS> Get-Content c:\windows\acts<Tab>

Quando você pressiona a tecla Tab, o comando se expande para:

PS> Get-Content C:\windows\actsetup.log

PSReadLine também tem um recurso de conclusão de menu. A associação de chave padrão no Windows é Ctrl+Space.

PS> fore<Ctrl-Space>

Quando você pressiona Ctrl+Espaço, o PowerShell apresenta a lista completa de valores correspondentes como um menu:

PS> foreach
foreach         ForEach-Object  foreach.cmd

Neste exemplo, a cadeia de caracteres 'fore' é correspondida a foreach (alias do PowerShell), ForEach-Object (cmdlet) e foreach.cmd (comando nativo). Use as teclas de seta para selecionar o valor desejado.

Conclusão do argumento do parâmetro

A conclusão de tabulação também pode funcionar para concluir argumentos de parâmetro. Você pode usar a tecla Tab para percorrer uma lista de valores possíveis que são válidos para algum parâmetro. Para obter mais informações, consulte about_Functions_Argument_Completion.

Confira também