Share via


Usar cmdlets do Mecanismo de Banco de Dados

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 do SQL Server para Windows PowerShell fornece cmdlets específicos para o SQL Server.

cmdlets do Mecanismo de Banco de Dados

O SQL Server implementa alguns 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 do Windows PowerShell funcionam com o Mecanismo de Banco de Dados usando o provedor do SQL Server PowerShell e os modelos de objeto de gerenciamento do SQL Server. Para obter mais informações, consulte SQL Server PowerShell.

Obter a ajuda do cmdlet

No ambiente Windows PowerShell, o cmdlet Get-Help fornece informações de ajuda para cada cmdlet. O 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 Obter Ajuda do 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 usando Invoke-Sqlcmd para executar scripts sqlcmd ou comandos contendo Transact-SQL ou instruções 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 Invoke-PolicyEvaluation para relatar se um conjunto de destino de objetos SQL Server é compatível com as condições definidas em 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 de provedor SQL Server

Consulte também

Conceitos

Provedor do SQL Server PowerShell

SQL Server PowerShell

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