Especificar instâncias no provedor do SQL Server PowerShell

Artigo
05/23/2023

Aplica-se a:SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System)

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.

Observação

Há dois módulos do SQL Server PowerShell; SqlServer e SQLPS.

O módulo SqlServer é o módulo atual do PowerShell a ser usado.

O módulo SQLPS está incluído na instalação do SQL Server (para compatibilidade com versões anteriores), mas não está mais sendo atualizado.

O módulo do SqlServer contém versões atualizadas dos cmdlets no SQLPS e inclui novos cmdlets para dar suporte aos recursos mais recentes do SQL.

Instale o módulo SqlServer da Galeria do PowerShell.

Para obter mais informações, confira SQL Server PowerShell.

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.

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  
```

Consulte Também

Identificadores do SQL Server no PowerShell
Provedor do SQL Server PowerShell
SQL Server PowerShell

Compartilhar via