Compartilhar via


Importar o módulo SQLPS

A maneira recomendada para gerenciar o SQL Server no PowerShell é importar o módulo sqlps para um ambiente do Windows PowerShell 2.0. O módulo carrega e registra os snap-ins do 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 de provedor do SQL Server para navegar pela hierarquia dos objetos do SQL Server.

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

ObservaçãoObservaçã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 Restricted, 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

[Início]

Consulte também

Conceitos

SQL Server PowerShell

Provedor do SQL Server PowerShell

Usar cmdlets do Mecanismo de Banco de Dados