Compartilhar via


Gerenciar conclusão de guia (SQL Server PowerShell)

Os snap-ins do SQL Server PowerShell apresentam três variáveis ($SqlServerMaximumTabCompletion, $SqlServerMaximumChildItems e $SqlServerIncludeSystemObjects) para controlar a conclusão da guia Windows PowerShell. A conclusão da guia reduz a quantidade de digitação necessária, retornando tabelas de itens cujos nomes iniciam com a cadeia de caracteres que você está digitando.

Antes de começar

Com a tab-completion do Windows PowerShell, quando você digita parte do nome de um caminho ou cmdlet, pode pressionar a tecla Tab para obter uma lista de itens cujos nomes correspondem aos já digitados. Em seguida, é possível selecionar o item desejado da lista sem precisar digitar o restante do nome.

Se você estiver trabalhando em um banco de dados com muitos objetos, as listas tab-completion poderão se tornar muito grandes. Alguns tipos de objetos do SQL Server, como exibições, também têm muitos objetos de sistema.

Os snap-ins do SQL Server apresentam três variáveis de sistema que podem ser usadas para controlar a quantidade de informações apresentadas por tab-completion e Get-ChildItem.

  • $SqlServerMaximumTabCompletion = n
    Especifica o número máximo de objetos que devem ser incluídos em uma lista tab-completion. Se você selecionar Tab em um nó de caminho com mais de n objetos, a lista tab-completion será truncada em n. n é um inteiro. 0 é a configuração padrão e significa que não há limite para o número de objetos na lista.

  • $SqlServerMaximumChildItems = n
    Especifica o número máximo de objetos exibidos por Get-ChildItem. Se Get-ChildItem for executado em um nó de caminho com mais de n objetos, a lista será truncada em n. n é um inteiro. 0 é a configuração padrão e significa que não há limite para o número de objetos na lista.

  • $SqlServerIncludeSystemObjects = { $True | $False }
    Se $True, os objetos de sistema serão exibidos por tab-completion e Get-ChildItem. Se $False, nenhum objeto de sistema será exibido. A configuração padrão é $False.

Definir as variáveis de conclusão de guia do SQL Server

Para qualquer variável a ser alterada do valor padrão, defina a variável como o novo valor.

Exemplo (PowerShell)

O exemplo a seguir define todas as três variáveis e lista suas configurações:

$SqlServerMaximumTabCompletion = 20
$SqlServerMaximumChildItems = 10
$SqlServerIncludeSystemObjects = $False
dir variable:sqlserver*

Consulte também

Conceitos

SQL Server PowerShell