Compartilhar via

Importar o módulo SQLPS

  • Artigo

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

  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 gerenciamento SQL Server (como Microsoft.SqlServer.Management.Smo) para gerenciar objetos 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

Consulte Também

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