Utilitário sqlps

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.

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

a. Executar o utilitário sqlps no modo interativo padrão, sem a faixa de direitos autorais

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