Freigeben über

Importieren des SQLPS-Moduls

  • Artikel

Die empfohlene Methode zum Verwalten von SQL Server aus PowerShell besteht darin, das sqlps Modul in eine Windows PowerShell 2.0-Umgebung zu importieren. Das Modul lädt und registriert die SQL Server-Snap-Ins und Verwaltbarkeitsassemblys.

  1. Vor Beginn: Sicherheit

  2. So laden Sie das Modul: Laden des sqlps-Moduls

Vorbereitungen

Nach dem Importieren des sqlps-Moduls in Windows PowerShell stehen Ihnen folgende Möglichkeiten zur Verfügung:

  • Interaktives Ausführen von Windows PowerShell-Befehlen

  • Ausführen von Windows PowerShell-Skriptdateien

  • Ausführen von SQL Server-Cmdlets

  • Verwenden Sie die SQL Server-Anbieterpfade, um in der Hierarchie von SQL Server-Objekten zu navigieren.

  • Verwenden Sie die SQL Server-Verwaltbarkeitsobjektmodelle (z. B. Microsoft.SqlServer.Management.Smo), um SQL Server-Objekte zu verwalten.

Hinweis

Die in den Namen von zwei SQL Server-Cmdlets (Encode-Sqlname und Decode-Sqlname) verwendeten Verben entsprechen nicht den genehmigten Verben für Windows PowerShell 2.0. Dies hat keine Auswirkungen auf den Vorgang, aber von Windows PowerShell wird eine Warnung ausgegeben, wenn das sqlps-Modul in eine Sitzung importiert wird.

Sicherheit

Standardmäßig wird Windows PowerShell mit auf Restrictedfestgelegter Skriptausführungsrichtlinie ausgeführt. Dadurch wird die Ausführung von Windows PowerShell-Skripts verhindert. Zum Laden des sqlps-Moduls können Sie das Set-ExecutionPolicy-Cmdlet verwenden, um die Ausführung signierter Skripts oder beliebiger anderer Skripts zu ermöglichen. Führen Sie nur Skripts aus vertrauenswürdigen Quellen aus, und sichern Sie alle Eingabe- und Ausgabedateien, indem Sie die geeigneten NTFS-Berechtigungen verwenden. Weitere Informationen zum Aktivieren von Windows PowerShell-Skripts finden Sie unter Ausführen der Windows PowerShell-Skripts.

Laden des sqlps-Moduls

So laden Sie das sqlps-Modul in Windows PowerShell

  1. Verwenden Sie das Set-ExecutionPolicy-Cmdlet, um die entsprechende Skriptausführungsrichtlinie festzulegen.

  2. Verwenden Sie das Import-Module Cmdlet, um das SQLPS-Modul zu importieren. Geben Sie den DisableNameChecking-Parameter an, wenn Sie die Warnung zu Encode-Sqlname und Decode-Sqlname unterdrücken möchten.

Beispiel (PowerShell)

In diesem Beispiel wird das sqlps-Modul bei deaktivierter Namensüberprüfung geladen.

## Import the SQL Server Module.  
  
Import-Module "sqlps" -DisableNameChecking

Weitere Informationen

SQL Server-PowerShell
SQL Server PowerShell-Anbieter
Verwenden der Datenbank-Engine-Cmdlets