utilitário sqlps

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Base de dados SQL no Microsoft Fabric

O utilitário sqlps inicia uma sessão do Windows PowerShell 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 seus objetos.

Sintaxe

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

Argumentos

-NoLogo

Especifica que o utilitário sqlps oculta o banner de direitos autorais quando ele é iniciado.

-NãoSaída

Especifica que o utilitário sqlps continue 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 aliases, funções e variáveis comumente usados para uso em sessões do PowerShell.

-OutPutFormat { Texto | XML }

Especifica que a saída do utilitário sqlps é formatada como cadeias de texto (Text) ou em um formato CLIXML serializado (XML).

-InPutFormat { Texto | XML }

Especifica que a entrada para o utilitário sqlps é formatada como cadeias de texto (Text) ou em um formato CLIXML serializado (XML).

-Comando

Especifica o comando para a execução do utilitário sqlps . O utilitário sqlps executa o comando e, em seguida, sai, a menos que -NoExit também seja especificado. Não especifique nenhuma outra opção após -Command. Eles são lidos como parâmetros de comando.

-

-Command- Especifica que o utilitário sqlps lê a entrada da entrada padrão.

script_block [ -argsargument_array ]

Especifica um bloco de comandos do PowerShell a ser executado, o bloco deve ser colocado entre chaves: {}. Script_block só pode ser especificado quando o utilitário sqlps é chamado do PowerShell ou de outra sessão do utilitário sqlps . O argument_array é uma matriz de variáveis do PowerShell que contém os argumentos para os comandos do PowerShell no script_block.

fio [ command_parameters ]

Especifica uma cadeia de caracteres que contém os comandos do PowerShell a serem executados. Utilize o formato "{<command>}". As aspas indicam uma cadeia de caracteres e o operador de invocação (&) faz com que o utilitário sqlps execute o comando (<command>).

[ -? | -Ajuda ]

Mostra o resumo da sintaxe das opções do utilitário sqlps .

Observações

O utilitário sqlps 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 esses snap-ins do SQL Server PowerShell:

• Microsoft.SqlServer.Management.PSProvider.dll

  Implementa o provedor do SQL Server PowerShell e 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 utilitário sqlps para executar as seguintes tarefas:

• Execute comandos do PowerShell de forma interativa.

• Execute arquivos de script do PowerShell.

• Execute cmdlets do SQL Server.

• Use os caminhos do provedor do SQL Server para navegar pela hierarquia de objetos do SQL Server.

Por padrão, o utilitário sqlps é 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 para habilitar a execução de scripts assinados ou quaisquer scripts. Execute scripts somente de fontes confiáveis e proteja todos os arquivos de entrada e saída usando as permissões NTFS apropriadas. Para obter mais informações sobre como habilitar scripts do PowerShell, consulte Executando scripts do Windows PowerShell.

A versão do utilitário sqlps no SQL Server 2008 (10.0.x) e no SQL Server 2008 R2 (10.50.x) foi implementada como um minishell do Windows PowerShell 1.0. Os minishells têm certas restrições, como não permitir que os usuários carreguem snap-ins diferentes daqueles carregados pelo minishell. Essas restrições não se aplicam ao SQL Server 2012 (11.x) e versões posteriores do utilitário, que foram alteradas para usar o módulo sqlps .

Exemplos

Um. Execute o utilitário sqlps no modo interativo padrão sem o banner de direitos autorais

sqlps -NoLogo

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

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

C. Execute um script do SQL Server PowerShell a partir do prompt de comando e continue em execução após a conclusão do script

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

Conteúdo relacionado

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