Partilhar via

Importar o módulo SQLPS

  • Artigo

A maneira recomendada de gerenciar o SQL Server do PowerShell é importar o sqlps módulo para um ambiente do Windows PowerShell 2.0. O módulo carrega e registra os snap-ins e assemblies de capacidade de gerenciamento do SQL Server.

  1. Antes de começar: Segurança

  2. Para carregar o módulo: Carregar o módulo sqlps

Antes de começar

Depois de importar o módulo sqlps no Windows PowerShell, você poderá:

  • Executar comandos do Windows PowerShell de forma interativa.

  • Executar arquivos de script do Windows PowerShell.

  • Executar cmdlets do SQL Server.

  • Usar os caminhos do provedor do SQL Server para navegar pela hierarquia de objetos SQL Server.

  • Use os modelos de objeto de capacidade de gerenciamento do SQL Server (como Microsoft.SqlServer.Management.Smo) para gerenciar objetos do SQL Server.

Observação

Os verbos usados nos nomes de dois cmdlets de SQL Server (Encode-Sqlname e Decode-Sqlname) não correspondem aos verbos aprovados para o Windows PowerShell 2.0. Isso não tem efeito na sua operação, mas o Windows PowerShell gera um aviso quando o módulo sqlps é importado para uma sessão.

Segurança

Por padrão, o Windows PowerShell é executado em conjunto com a política de execução de scripts definida como Restrita, que evita a execução de qualquer script do Windows PowerShell. Para carregar o módulo sqlps module, você pode usar o cmdlet Set-ExecutionPolicy a fim de habilitar a execução de scripts assinados ou de quaisquer outros scripts. Somente os scripts de origem confiável devem ser executados, e é preciso verificar se todos os arquivos de entrada e de saída estão usando as permissões NTFS adequadas. Para obter mais informações sobre como habilitar scripts do Windows PowerShell, consulte Executando scripts do Windows PowerShell.

Carregar o módulo sqlps

Para carregar o módulo sqlps no Windows PowerShell

  1. Use o cmdlet Set-ExecutionPolicy para definir a política de execução de script adequada.

  2. Use o cmdlet Import-Module para importar o módulo sqlps. Especifique o parâmetro DisableNameChecking se você desejar suprimir o aviso sobre Encode-Sqlname e Decode-Sqlname.

Exemplo (PowerShell)

Este exemplo carrega o módulo sqlps com verificação de nome desligado.

## Import the SQL Server Module.  
  
Import-Module "sqlps" -DisableNameChecking

Confira também

SQL Server PowerShell
Provedor do SQL Server PowerShell
Usar cmdlets do Mecanismo de Banco de Dados