sobre_Expansão_de_Tab

Breve descrição

O PowerShell fornece completamentos de entrada para sugerir dicas, facilitar a descoberta e acelerar a introdução de dados. 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 Predictive IntelliSense.

A tecla Tab é a associaçã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.

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.

Conclusão do nome do cmdlet

A expansão da guia de nomes de cmdlets é ligeiramente diferente. Para usar a expansão de tabulação num 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 obter uma correspondência parcial. Por exemplo, se você digitar get-co e pressionar a tecla Tab, o PowerShell expandirá isso automaticamente para o cmdlet Get-Command. Note-se que também altera o caso das letras para a sua forma padrão. Se você pressionar tecla Tab novamente, o PowerShell substituirá isso pelo único outro nome de cmdlet correspondente, Get-Content.

A conclusão automática com a tecla Tab também funciona para resolver aliases do PowerShell e 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 tabulação no nome do cmdlet Get-Content inserindo:

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+Espaço.

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' corresponde 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 percorre 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 parâmetros #Requires e das palavras-chave para ajuda baseada em comentários.

Exemplo de declaração #Requires

#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

Consulte também

• TabExpansion2
• sobre_Ajuda_Baseada_em_Comentário
• about_Functions_Argument_Completion
• about_Requires