Compartilhar via


Usar os cmdlets do Mecanismo de Banco de Dados

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

Cmdlets do Mecanismo de Banco de Dados

O SQL Server implementa um pequeno número de cmdlets para o Mecanismo de Banco de Dados. Esses cmdlets são usados principalmente para executar scripts Transact-SQL existentes a partir de novos scripts do PowerShell, avaliar políticas de gerenciamento baseadas em políticas já existentes e auxiliar na especificação de identificadores do SQL Server em caminhos do Provedor SQL Server.

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

Obter ajuda do cmdlet

No ambiente do Windows PowerShell, o cmdlet Get-Help fornece informações de ajuda para cada cmdlet. Get-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âmetros parciais

Você não precisa especificar o nome inteiro de um parâmetro de cmdlet. Você só precisa especificar o suficiente do nome para separá-lo de forma única dos outros parâmetros compatíveis com o cmdlet. Por exemplo, esses exemplos mostram três maneiras 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 de cmdlet do Mecanismo de Banco de Dados

Descrição da tarefa Tópico
Descreve como usar 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 de cadeia de caracteres 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 do 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 todas as opções configuráveis nos objetos de destino que não estejam em conformidade com as condições da política. cmdlet Invoke-PolicyEvaluation
Descreve como usar Encode-Sqlname e Decode-Sqlname manipular identificadores do 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 um Objeto de Gerenciamento do SQL Server para o caminho equivalente do Provedor do SQL Server. Converter URNs em caminhos do Provedor do SQL Server

Consulte Também

Provedor do SQL Server PowerShell
SQL Server PowerShell
Visão geral dos cmdlets do PowerShell para Grupos de Disponibilidade AlwaysOn (SQL Server)