Condividi tramite


Utilizzare i cmdlets del motore di database

I cmdlet di Windows PowerShell sono comandi a funzione singola che in genere hanno una convenzione di denominazione verbo-sostantivo, 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

SQL Server implementa un numero ridotto di cmdlet per il motore di database. Questi cmdlet vengono usati principalmente per eseguire script Transact-SQL esistenti da nuovi script di PowerShell, valutare le politiche di gestione basate su criteri e facilitare la specifica degli identificatori di SQL Server nei percorsi del provider SQL Server.

La maggior parte degli script di Windows PowerShell funziona con il motore di database usando il provider PowerShell di SQL Server e i modelli a oggetti di gestibilità di SQL Server. Per altre informazioni, vedere SQL Server PowerShell.

Ottenere la Guida dei cmdlet

Nell'ambiente Windows PowerShell, il cmdlet Get-Help fornisce informazioni di guida per ogni cmdlet. Get-Help restituisce informazioni quali la sintassi, le definizioni dei parametri, i tipi di input e output e una descrizione dell'azione eseguita dal cmdlet. Per altre informazioni, vedere Get Help SQL Server PowerShell.

Nomi di parametri parziali

Non è necessario specificare l'intero nome di un parametro del cmdlet. È sufficiente specificare una parte sufficiente del nome per distinguerlo in modo univoco dagli altri parametri supportati dal cmdlet. Ad esempio, questi esempi illustrano tre modi per specificare il parametroInvoke-Sqlcmd -QueryTimeout :

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

Attività dei cmdlet del motore di elaborazione dati

Descrizione attività Argomento
Descrive l'uso di Invoke-Sqlcmd per eseguire script o comandi sqlcmd che contengono istruzioni Transact-SQL o XQuery. Può accettare l'input sqlcmd come parametro di input della stringa di caratteri o come nome di un file di script da aprire. Cmdlet Invoke-Sqlcmd
Viene descritto l'uso di Invoke-PolicyEvaluation per segnalare se un set di destinazione di oggetti DI SQL Server è conforme alle condizioni definite nei criteri di gestione basati su criteri. Facoltativamente, il cmdlet può essere usato per riconfigurare tutte le opzioni impostabili negli oggetti di destinazione che non sono conformi alle condizioni dei criteri. cmdletInvoke-PolicyEvaluation
Descrive l'uso Encode-Sqlname di e Decode-Sqlname per gestire gli identificatori di SQL Server che contengono caratteri non supportati nei percorsi di Windows PowerShell. Codificare e decodificare gli identificatori di SQL Server
Descrive l'uso di Convert-UrnToPath per convertire un Uniform Resource Name (URN) dell'oggetto di gestibilità di SQL Server nel percorso equivalente del provider di SQL Server. Convertire gli URN in percorsi del provider SQL Server

Vedere anche

Provider di PowerShell di SQL Server
SQL Server PowerShell
Panoramica dei cmdlet di PowerShell per i gruppi di disponibilità AlwaysOn (SQL Server)