Utilitário sqlps

O sqlps utilitário inicia uma sessão do Windows PowerShell 2.0 com o provedor do SQL Server 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 ele inicia.

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

-NoProfile
Especifica que o sqlps utilitário 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).

-Comando
Especifica o comando para a execução do sqlps utilitário. O sqlps utilitário executa o comando e sai, 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 lê a entrada do input 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 do 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.

cadeia de caracteres [ parâmetros_de_comando ]
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.

[ -? | -Ajuda ]
Mostra um resumo da sintaxe das opções do utilitário sqlps.

Observações

O sqlps utilitário inicia o ambiente do PowerShell (PowerShell.exe) e carrega o módulo do SQL Server PowerShell. O módulo, também chamado sqlps, carrega e registra estes snap-ins do SQL Server 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 .

Você pode usar o sqlps utilitário para fazer o seguinte:

• Executar comandos do PowerShell de forma interativa.

• Executar arquivos de script do PowerShell.

• Executar cmdlets do SQL Server.

• Use os caminhos dos provedores 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 Executando scripts do Windows PowerShell.

A versão do sqlps utilitário no SQL Server 2008 e no SQL Server 2008 R2 foi implementada como um mini-shell do 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 ao SQL Server 2012 e versões mais altas do utilitário, que foram alteradas para usar o sqlps módulo.

Exemplos

Um. Executar o utilitário sqlps no modo padrão interativo, sem o banner 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