about_Tab_Expansion
Breve descrição
O PowerShell fornece conclusões na entrada para fornecer dicas, habilitar a descoberta e acelerar a entrada de entrada. Nomes de comandos, nomes de parâmetros, valores de argumento e caminhos de arquivo podem ser concluídos pressionando a tecla Tab .
Descrição longa
A expansão de tabulação é controlada pela função interna TabExpansion2. Como essa função pode ser modificada ou substituída, esta 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 Predictive IntelliSense do módulo PSReadLine. Para obter mais informações, consulte IntelliSense preditivo.
A tecla Tab é a ligação de tecla padrão no Windows. Você pode alterar a vinculação de teclas usando o módulo PSReadLine ou o aplicativo que está hospedando o PowerShell. A vinculação de teclas é diferente em plataformas que não são Windows. Para obter mais informações, consulte about_PSReadLine.
Nota
Uma limitação do processo de expansão de guias é que as guias são sempre interpretadas como tentativas de completar uma palavra. Se você copiar e colar exemplos de comandos 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 o que você pretendia.
Conclusão do nome do arquivo e do cmdlet
Para preencher um nome de arquivo ou caminho a partir das 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 encontrada. Pressionar a tecla Tab repetidamente percorre todas as opções disponíveis.
A expansão da guia de nomes de cmdlets é ligeiramente diferente. Para usar a expansão de tabulação em um nome de cmdlet, digite toda a primeira parte do nome (o verbo) e o hífen que o segue. Você pode preencher mais do nome para uma correspondência parcial.
Por exemplo, se você digitar get-co e pressionar a tecla Tab, o PowerShell expandirá isso automaticamente para o Get-Command cmdlet. Note-se que também altera o caso das letras para o seu formulário normalizado. Se você pressionar a tecla Tab novamente, o PowerShell substituirá isso pelo único outro nome de cmdlet correspondente, Get-Content.
Nota
A partir do PowerShell 7.0, o Tab também expande cmdlets e funções abreviados. Por exemplo, i-psdf<tab> retorna Import-PowerShellDataFile.
A conclusão da guia também funciona para resolver o alias do PowerShell e os executáveis nativos.
Você pode usar a expansão de tabulação repetidamente na mesma linha. Por exemplo, você pode usar a expansão de guia no nome do Get-Content cmdlet digitando:
Exemplos
PS> Get-Con<Tab>
Quando você pressiona a tecla Tab , o comando se expande para:
PS> Get-Content
Em seguida, você pode especificar parcialmente o caminho para o arquivo de log da Instalação Ativa e usar a expansão de guia 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 ligação de tecla padrão no Windows é Ctrl+Space.
PS> fore<Ctrl-Space>
Quando você pressiona Ctrl+Space, 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
O preenchimento 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.
Conclusão de valor enumerado
O PowerShell 7.0 adicionou suporte para conclusão de guias de enums. Você pode usar o preenchimento de tabulação para selecionar o valor desejado em qualquer lugar que use um enum. Por exemplo:
enum Suits {
Clubs = 0
Diamonds = 1
Hearts = 2
Spades = 3
}
[Suits]$suit = 'c<Tab>
Os valores enumerados são cadeias de caracteres, portanto, o valor a ser concluído deve começar com um caractere de aspas simples ou duplas.
Quando você pressiona a tecla Tab , você obtém os seguintes resultados:
[Suits]$suit = 'Clubs'
O preenchimento de guias também funciona com enumerações .NET.
[System.IO.FileAttributes]$attr = 'S<Tab><Tab>
Pressionar a tecla Tab duas vezes alterna os dois valores que começam com a letra S. O resultado final é:
[System.IO.FileAttributes]$attr = 'System'
A partir do PowerShell 7.0, a expansão de guia foi adicionada para os valores de ValidateSet ao atribuir a uma variável. Por exemplo, se você estava digitando a seguinte definição de variável:
[ValidateSet('Chocolate', 'Strawberry', 'Vanilla')]
[string]$flavor = 'Strawberry'
$flavor = <tab>
Quando você pressiona a tecla Tab , você obteria o seguinte resultado:
$flavor = 'Chocolate'
Preenchimento de guias para palavras-chave baseadas em comentários
A partir do PowerShell 7.2, foi adicionado suporte para o preenchimento de guias dos #requires parâmetros e das palavras-chave para ajuda baseada em comentários.
Exemplo de #requires instrução
#requires -<Ctrl-Space>
A expansão do menu mostra as seguintes opções de parâmetro:
#requires -<Ctrl-Space>
Modules PSEdition RunAsAdministrator Version
Exemplo de ajuda baseada em comentários
<#
.<Ctrl-Space>
A expansão do menu mostra as seguintes opções de palavra-chave:
<#
.COMPONENT
COMPONENT EXTERNALHELP FUNCTIONALITY NOTES REMOTEHELPRUNSPACE
DESCRIPTION FORWARDHELPCATEGORY INPUTS OUTPUTS ROLE
EXAMPLE FORWARDHELPTARGETNAME LINK PARAMETER SYNOPSIS
