Utilitário sqlps

Artigo
03/08/2017

O sqlps utilitário inicia uma sessão Windows PowerShell 2.0 com o SQL Server provedor do PowerShell e cmdlets carregados e registrados. Você pode inserir comandos ou scripts do PowerShell que usam os componentes do SQL Server PowerShell para trabalhar com instâncias do SQL Server e os respectivos objetos.

Importante

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Use o módulo sqlps do PowerShell. Para obter mais informações sobre o sqlps módulo, consulte Importar o módulo SQLPS.

Sintaxe

  
      sqlps   
[ [ [ -NoLogo ][ -NoExit ][ -NoProfile ]  
    [ -OutPutFormat { Text | XML } ] [ -InPutFormat { Text | XML } ]  
  ]  
  [ -Command { -  
             | script_block [ -argsargument_array ]  
             | string [ command_parameters ]  
             }  
  ]  
]  
[ -? | -Help ]

Argumentos

-NoLogo
Especifica que o utilitário sqlps oculta a faixa de direitos autorais quando é iniciado.

-NoExit
Especifica que o utilitário sqlps continua em execução após a conclusão dos comandos de inicialização.

-NoProfile
Especifica que o utilitário sqlps não carrega um perfil de usuário. Os perfis de usuário registram alias, funções e variáveis usados com frequência para uso em sessões do PowerShell.

-OutPutFormat { Text | XML }
Especifica que a saída do sqlps utilitário seja formatada como cadeias de caracteres de texto (Texto) ou em um formato CLIXML serializado (XML).

-InPutFormat { Text | XML }
Especifica que a entrada para o sqlps utilitário é formatada como cadeias de caracteres de texto (Texto) ou em um formato CLIXML serializado (XML).

-Command
Especifica o comando para a execução do utilitário sqlps. O sqlps utilitário executa o comando e, em seguida, é encerrado, a menos que -NoExit também seja especificado. Não especifique outras opções depois de -Command, pois elas serão lidas como parâmetros de comando.

-
-Command- especifica que o sqlps utilitário leu a entrada da entrada padrão.

script_block [ -argsargument_array ]
Especifica um bloco de comandos de PowerShell para executar. O bloco deve ficar entre chaves: {}. Script_block só pode ser especificado quando o sqlps utilitário é chamado do PowerShell ou de outra sqlps sessão de utilitário. O argument_array é uma matriz de variáveis do PowerShell que contêm os argumentos para os comandos do PowerShell em script_block.

string [ command_parameters ]
Especifica que uma cadeia de caracteres contendo os comandos do PowerShell seja executada. Use o formato "&{command}". As aspas indicam uma cadeia de caracteres e o operador de invocação (&) faz com que o sqlps utilitário execute o comando.

[ -? | -Help ]
Mostra o resumo da sintaxe de opções do utilitário sqlps.

Comentários

O sqlps utilitário inicia o ambiente do PowerShell (PowerShell.exe) e carrega o módulo SQL Server PowerShell. O módulo, também chamado sqlps, carrega e registra estes SQL Server snap-ins do PowerShell:

Microsoft.SqlServer.Management.PSProvider.dll

Implementa o provedor do PowerShell do SQL Server e os cmdlets associados, como Encode-SqlName e Decode-SqlName.
Microsoft.SqlServer.Management.PSSnapin.dll

Implementa os cmdlets Invoke-Sqlcmd e Invoke-PolicyEvaluation .

É possível usar o utilitário sqlps para fazer o seguinte:

Executar comandos do PowerShell de forma interativa.
Executar arquivos de script do PowerShell.
Executar cmdlets do SQL Server.
Usar os caminhos do provedor do SQL Server para navegar pela hierarquia de objetos SQL Server.

Por padrão, o sqlps utilitário é executado com a política de execução de script definida como Restrito. Isso impede a execução de quaisquer scripts do PowerShell. Você pode usar o cmdlet Set-ExecutionPolicy a fim de habilitar a execução de scripts assinados ou de qualquer script. Execute apenas scripts de fontes confiáveis e proteja todos os arquivos de entrada e saída usando as permissões NTFS adequadas. Para obter mais informações sobre como habilitar scripts do PowerShell, consulte Running Windows PowerShell Scripts(a página pode estar em inglês).

A versão do sqlps utilitário no SQL Server 2008 e SQL Server 2008 R2 foi implementada como um mini shell Windows PowerShell 1.0. Os minishells têm determinadas restrições, como não permitir que os usuários carreguem snap-ins diferentes dos carregados pelo minishell. Essas restrições não se aplicam às versões SQL Server 2012 e superiores do utilitário , que foram alteradas para usar o sqlps módulo.

Exemplos

sqlps -NoLogo

B. Executar um script do SQL Server PowerShell no prompt de comando

sqlps -Command "&{.\MyFolder.MyScript.ps1}"

C. Executar um script do SQL Server PowerShell a partir do prompt de comando, e manter a execução após a conclusão do script

sqlps -NoExit -Command "&{.\MyFolder.MyScript.ps1}"

Consulte Também

Habilitar ou desabilitar um protocolo de rede do servidor
SQL Server PowerShell

Partilhar via