Condividi tramite


Utilizzo di cmdlet del motore di database

I cmdlet di Windows PowerShell sono comandi a una sola funzione che in genere presentano una convenzione di denominazione verbo-nome, ad esempio Get-Help o Set-MachineName. Il provider SQL Server per Windows PowerShell fornisce cmdlet specifici di SQL Server.

Cmdlet del motore di database

In SQL Server è implementato un numero ridotto di cmdlet per Motore di database. Questi cmdlet vengono utilizzati principalmente per eseguire script Transact-SQL esistenti dai nuovi script di PowerShell, valutare criteri di gestione basata su criteri e aiutare nella specifica degli identificatori di SQL Server nei percorsi del provider SQL Server.

La maggior parte degli script di Windows PowerShell funzionano con Motore di database tramite il provider SQL Server PowerShell e i modelli a oggetti di facilità di gestione di SQL Server. Per ulteriori informazioni, vedere SQL Server PowerShell.

Ottenere la Guida sui cmdlet

Nell'ambiente di Windows PowerShell il cmdlet Get-Help fornisce informazioni della Guida per ciascun cmdlet. Get-Help restituisce informazioni come la sintassi, le definizioni dei parametri, i tipi di input e di output e una descrizione dell'azione eseguita dal cmdlet. Per ulteriori informazioni, vedere Visualizzazione della Guida di SQL Server PowerShell.

Nomi di parametri parziali

Non è necessario specificare il nome completo di un parametro di un cmdlet. Basta specificare una parte del nome sufficiente a identificarlo in modo univoco rispetto agli altri parametri che sono supportati dal cmdlet. Negli esempi che seguono vengono illustrati tre modi di specificare il parametro Invoke-Sqlcmd -QueryTimeout:

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

Attività del cmdlet del motore di database

Descrizione dell'attività

Argomento

Viene descritto l'utilizzo di Invoke-Sqlcmd per eseguire script o comandi di sqlcmd che contengono le istruzioni Transact-SQL o XQuery. Può accettare l'input di sqlcmd come parametro di input della stringa di caratteri o come nome di un file script da aprire.

Cmdlet Invoke-Sqlcmd

Viene descritto l'utilizzo di Invoke-PolicyEvaluation per indicare se un set di destinazioni oggetti SQL Server è conforme alle condizioni definite nei criteri di gestione basata su criteri. Facoltativamente, il cmdlet può essere utilizzato per riconfigurare qualsiasi opzione impostabile negli oggetti di destinazione che non sono conformi alle condizioni dei criteri.

cmdlet Invoke-PolicyEvaluation

Viene descritto l'utilizzo di Encode-Sqlname e Decode-Sqlname per gestire identificatori SQL Server che contengono caratteri non supportati nei percorsi di Windows PowerShell.

Codificare e decodificare identificatori di SLQ Server

Viene descritto l'utilizzo di Convert-UrnToPath per convertire un nome di risorsa uniforme (Uniform Resource Name, URN) dell'oggetto facilità di gestione di SQL Server nel percorso del provider SQL Server equivalente.

Conversione di URN in percorsi di provider di SQL Server

Vedere anche

Concetti

Provider PowerShell per SQL Server

SQL Server PowerShell

Panoramica dei cmdlet di PowerShell per Gruppi di disponibilità AlwaysOn (SQL Server)