Verwenden der Cmdlets des Datenbankmoduls

Windows PowerShell-Cmdlets sind Einzelfunktionsbefehle, die in der Regel eine Verb-Nomen-Benennungskonvention aufweisen, z. B. Get-Help oder Set-MachineName. Der SQL Server-Anbieter für Windows PowerShell stellt Cmdlets bereit, die für SQL Server spezifisch sind.

Cmdlets für das Datenbankmodul

SQL Server implementiert eine kleine Anzahl von Cmdlets für das Datenbankmodul. Diese Cmdlets werden in erster Linie verwendet, um vorhandene Transact-SQL Skripts aus neuen PowerShell-Skripts auszuführen, richtlinienbasierte Verwaltungsrichtlinien auszuwerten und die Angabe von SQL Server-Bezeichnern in SQL Server-Anbieterpfaden zu unterstützen.

Die meisten Windows PowerShell-Skripts arbeiten mit dem Datenbankmodul mithilfe des SQL Server PowerShell-Anbieters und der SQL Server-Objektmodelle zur Verwaltbarkeit. Weitere Informationen finden Sie unter SQL Server-PowerShell.

Cmdlet-Hilfe abrufen

In der Windows PowerShell-Umgebung enthält das Cmdlet "Get-Help " Hilfeinformationen für jedes Cmdlet. Get-Help gibt Informationen wie Syntax, Parameterdefinitionen, Eingabe- und Ausgabetypen sowie eine Beschreibung der vom Cmdlet ausgeführten Aktion zurück. Weitere Informationen finden Sie unter Get Help SQL Server PowerShell.

Teilparameternamen

Sie müssen nicht den gesamten Namen eines Cmdlet-Parameters angeben. Sie müssen nur genügend des Namens angeben, um diesen eindeutig von den anderen Parametern zu trennen, die vom Cmdlet unterstützt werden. In diesen Beispielen werden beispielsweise drei Methoden zum Angeben des parametersInvoke-Sqlcmd -QueryTimeout gezeigt:

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

Cmdlet-Aufgaben des Datenbankmoduls

Vorgangsbeschreibung	Thema
Beschreibt die Verwendung von Invoke-Sqlcmd zum Ausführen von sqlcmd-Skripts oder -Befehlen, die Transact-SQL- oder XQuery-Anweisungen enthalten. Sie kann die sqlcmd-Eingabe entweder als Zeichenfolgeneingabeparameter oder als Name einer zu öffnenden Skriptdatei akzeptieren.	Invoke-Sqlcmd-Cmdlet
Beschreibt die Verwendung von Invoke-PolicyEvaluation , um zu melden, ob ein Zielsatz von SQL Server-Objekten den Bedingungen entspricht, die in richtlinienbasierten Verwaltungsrichtlinien definiert sind. Optional kann das Cmdlet verwendet werden, um alle settable-Optionen in den Zielobjekten neu zu konfigurieren, die nicht den Richtlinienbedingungen entsprechen.	Invoke-PolicyEvaluation-Cmdlet
Beschreibt die Verwendung von Encode-Sqlname und Decode-Sqlname zur Verarbeitung von SQL Server-Bezeichnern, die Zeichen enthalten, die in Windows PowerShell-Pfaden nicht unterstützt werden.	Codierung und Decodierung von SQL Server-Bezeichnern
Beschreibt die Verwendung von Convert-UrnToPath, um einen SQL Server Manageability Object Uniform Resource Name (URN) in den entsprechenden SQL Server-Anbieterpfad zu konvertieren.	Konvertieren von URNs in SQL Server-Anbieterpfade

Siehe auch

SQL Server PowerShell-Anbieter
SQL Server-PowerShell
Übersicht über PowerShell-Cmdlets für AlwaysOn-Verfügbarkeitsgruppen (SQL Server)