Compartilhar via


Especificar instâncias no provedor do SQL Server PowerShell

Os caminhos especificados para o provedor do SQL Server PowerShell devem identificar a instância do Mecanismo de Banco de Dados e o computador no qual ela está sendo executada. A sintaxe para especificar o computador e a instância deve obedecer as regras para identificadores do SQL Server e caminhos do Windows PowerShell.

  1. Antes de começar: Limitações e Restrições

  2. Para especificar uma instância: Exemplos

Antes de começar

O primeiro nó depois de SQLSERVER:\SQL em um caminho de provedor SQL Server é o nome do computador que está executando a instância do Mecanismo de Banco de Dados; por exemplo:

SQLSERVER:\SQL\MyComputer

Se você está executando o Windows PowerShell no mesmo computador que a instância do Mecanismo de Banco de Dados, pode usar localhost ou (local) em vez do nome do computador. Scripts que usam localhost ou (local) podem ser executados em qualquer computador sem necessidade de alterações para refletir os nomes dos computadores diferentes.

Você pode executar várias instâncias do programa executável do Mecanismo de Banco de Dados no mesmo computador. O nó depois do nome do computador em um caminho de provedor SQL Server identifica a instância; por exemplo:

SQLSERVER:\SQL\MyComputer\MyInstance

Cada computador pode ter uma instância padrão do Mecanismo de Banco de Dados. Você não especifica um nome para a instância padrão ao instalá-la. Ao especificar apenas um nome de computador em uma cadeia de conexão, você estabelecerá conexão com a instância padrão nesse computador. Todas as outras instâncias no computador devem ser instâncias nomeadas. Você especifica o nome da instância durante a configuração e as cadeias de conexão devem especificar o nome do computador e o nome da instância.

Limitações e restrições

Você não pode usar um ponto (.) para especificar o computador local em scripts PowerShell. O ponto não é suportado, porque é interpretado como um comando pelo PowerShell.

Os caracteres de parêntese em (local) é tratado normalmente como comandos pelo Windows PowerShell. Você deve codificá-los ou reservá-los para uso em um caminho, ou colocar o caminho entre aspas duplas. Para obter mais informações, consulte Codifique e Decodifique Identificadores do SQL Server.

O provedor do SQL Server requer que o nome da instância sempre seja especificado. Para instâncias padrão, especifique o nome da instância como DEFAULT.

[Início]

Exemplos; Computador e nomes de instância

Este exemplo usa localhost e DEFAULT para especificar a instância padrão no computador local:

Set-Location SQLSERVER:\SQL\localhost\DEFAULT 

Os caracteres de parêntese em (local) é tratado normalmente como comandos pelo Windows PowerShell. Você deve:

  • Incluir as cadeias de caracteres de caminho entre aspas:

    Set-Location "SQLSERVER:\SQL\(local)\DEFAULT"
    
  • Retirar o parêntese usando o caractere de acento grave (`):

    Set-Location SQLSERVER:\SQL\`(local`)\DEFAULT
    
  • Codificar o parêntese usando sua representação hexadecimal:

    Set-Location SQLSERVER:\SQL\%28local%29\DEFAULT
    

[Início]

Consulte também

Conceitos

Identificadores do SQL Server no PowerShell

Provedor do SQL Server PowerShell

SQL Server PowerShell