Usar cmdlets do Mecanismo de Banco de Dados

Artigo
06/13/2017

Os cmdlets Windows PowerShell são comandos de função única que normalmente contêm uma convenção de nomenclatura formada por verbo-substantivo, como Get-Help ou Set-MachineName. O provedor de SQL Server para Windows PowerShell fornece cmdlets específicos para SQL Server.

cmdlets do Mecanismo de Banco de Dados

SQL Server implementa um pequeno número de cmdlets para o Mecanismo de Banco de Dados. Estes cmdlets são usados para executar principalmente scripts Transact-SQL existentes de novos scripts PowerShell, avaliar políticas de gerenciamento baseadas em política e ajudar a especificar identificadores do SQL Server em caminhos do provedor do SQL Server.

A maioria dos scripts Windows PowerShell funcionam com o Mecanismo de Banco de Dados usando o provedor SQL Server PowerShell e os modelos de objeto de capacidade de gerenciamento SQL Server. Para obter mais informações, confira SQL Server PowerShell.

Obter a ajuda do cmdlet

No ambiente Windows PowerShell, o cmdlet Get-Help fornece informações de ajuda para cada cmdlet. OGet-Help retorna informações como sintaxe, definições de parâmetro, tipos de entrada e saída e uma descrição da ação executada pelo cmdlet. Para obter mais informações, consulte Get Help SQL Server PowerShell.

Nomes de parâmetro parciais

Você não tem que especificar o nome inteiro de um parâmetro cmdlet. Você só tem que especificar uma parte suficiente do nome para separá-lo exclusivamente dos outros parâmetros que são suportados pelo cmdlet. Por exemplo, estes exemplos mostram três modos de especificar o parâmetro Invoke-Sqlcmd -QueryTimeout :

Invoke-Sqlcmd -Query "SELECT @@VERSION;" -QueryTimeout 3  
Invoke-Sqlcmd -Query "SELECT @@VERSION;" -QueryTime 3  
Invoke-Sqlcmd -Query "SELECT @@VERSION;" -QueryT 3

Tarefas cmdlet do Mecanismo de Banco de Dados

Descrição da tarefa	Tópico
Descreve o uso de Invoke-Sqlcmd para executar scripts ou comandos sqlcmd que contêm instruções Transact-SQL ou XQuery. Ele pode aceitar a entrada sqlcmd como um parâmetro de entrada da cadeia de caracteres do caractere ou como o nome de um arquivo de script a ser aberto.	cmdlet Invoke-Sqlcmd
Descreve o uso de Invoke-PolicyEvaluation para relatar se um conjunto de destino de objetos SQL Server está em conformidade com as condições definidas nas políticas de gerenciamento baseadas em políticas. Opcionalmente, o cmdlet pode ser usado para reconfigurar qualquer opção definível nos objetos de destino que não obedecem às condições de políticas.	cmdlet Invoke-PolicyEvaluation
Descreve o uso de `Encode-Sqlname` e `Decode-Sqlname` para tratar identificadores SQL Server que contêm caracteres sem suporte em caminhos do Windows PowerShell.	Codificar e decodificar identificadores do SQL Server
Descreve o uso de `Convert-UrnToPath` para converter um URN (Nome de Recurso Uniforme) de Objeto de Gerenciamento SQL Server no caminho de provedor SQL Server equivalente.	Converter URNs em caminhos do Provedor do SQL Server

Consulte Também

Provedor do SQL Server PowerShell
SQL Server PowerShell
Visão geral de cmdlets do PowerShell para grupos de disponibilidade AlwaysOn (SQL Server)

Compartilhar via