Partilhar via

about_Tab_Expansion

  • Artigo

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

Consulte também