Installieren des SQL Server PowerShell-Moduls

Anwendungsbereich: JaSQL Server (alle unterstützten Versionen) JaAzure SQL-Datenbank JaVerwaltete Azure SQL-Instanz JaAzure Synapse Analytics JaParallel Data Warehouse

Dieser Artikel enthält Anleitungen zur Installation des PowerShell-Moduls SqlServer.

PowerShell-Module für SQL Server

Es gibt zwei SQL Server PowerShell-Module:

  • SqlServer: Das SqlServer-Modul enthält neue Cmdlets zur Unterstützung der neuesten SQL-Funktionen. Das Modul enthält ebenso aktualisierte Versionen der Cmdlets in SQLPS. Um das SqlServer-Modul herunterzuladen, navigieren Sie zu SqlServer-Modul im PowerShell-Katalog.

  • SQLPS: SQLPS ist das Modul, das vom SQL-Agent zum Ausführen von Agent-Aufträgen in Agent-Auftragsschritten mithilfe des PowerShell-Subsystems verwendet wird.

Hinweis

Die Versionen des SqlServer-Moduls im PowerShell-Katalog unterstützen die Versionsverwaltung und erfordern Version 5.0 oder höher von PowerShell.

Hilfethemen finden Sie unter:

SQL Server Management Studio

Das SQL Server Management Studio (SSMS) installiert keines der PowerShell-Module. Um PowerShell mit SSMS zu verwenden, installieren Sie das SqlServer-Modul über den PowerShell-Katalog.

Hinweis

Mit SSMS 16.x ist eine frühere Version des SqlServer-Moduls im SQL Server Management Studio (SSMS) enthalten.

Azure Data Studio

Azure Data Studio installiert keines der PowerShell-Module. Um PowerShell mit Azure Data Studio zu verwenden, installieren Sie das SqlServer-Modul über den PowerShell-Katalog.

Sie können die PowerShell-Erweiterung verwenden, die umfassende Unterstützung für den PowerShell-Editor in Azure Data Studio bietet.

Installieren oder Aktualisieren des SqlServer-Moduls

Starten Sie eine PowerShell-Sitzung als Administrator, um das SqlServer-Modul über den PowerShell-Katalog zu installieren. Im integrierten Terminal können Sie Azure Data Studio auch als Administrator starten und diese Befehle in einer PowerShell-Sitzung ausführen.

Sie können auch Install-Module SQLServer -Scope CurrentUser verwenden, um erweiterte Berechtigungen auszuführen. Dieses Cmdlet ist für Benutzer hilfreich, die keine Administratoren in ihrer Umgebung sind. Da der Bereich jedoch auf den aktuellen Benutzer beschränkt ist, können andere Benutzer auf demselben Computer das Modul nicht verwenden.

Installieren des SqlServer-Moduls

Führen Sie den folgenden Befehl in der PowerShell-Sitzung aus, um das SqlServer-Modul für alle Benutzer zu installieren:

Install-Module -Name SqlServer

So zeigen Sie die Versionen des installierten SqlServer-Moduls an

Führen Sie den folgenden Befehl aus, um die installierten Versionen des SqlServer-Moduls anzuzeigen.

Get-Module SqlServer -ListAvailable

Installieren für den aktuellen Benutzer statt als Administrator

Wenn Sie die PowerShell-Sitzung nicht als Administrator ausführen können, installieren Sie mit folgendem Befehl für den aktuellen Benutzer:

Install-Module -Name SqlServer -Scope CurrentUser

So überschreiben Sie eine frühere Version des SqlServer-Moduls

Sie können auch den Install-Module-Befehl verwenden, um eine frühere Version zu überschreiben.

Install-Module -Name SqlServer -AllowClobber

Hinweis

PowerShell verwendet immer das neueste installierte Modul.

Aktualisieren der installierten Version des SqlServer-Moduls

Wenn aktualisierte Versionen des SqlServer-Moduls verfügbar sind, können Sie die neuere Version mit folgendem Befehl installieren:

Install-Module -Name SqlServer -AllowClobber

Sie können den Update-Module-Befehl verwenden, um die neueste Version des SQLServer PowerShell-Moduls zu installieren, aber damit werden keine älteren Versionen entfernt. Er installiert die neuere Version parallel, um Ihnen die Möglichkeit zu geben, mit der aktuellen Version zu experimentieren, aber dennoch die älteren Module zur Verfügung zu haben.

Wenn Sie jedoch keine älteren Modulversionen beibehalten möchten, können Sie den Uninstall-Module-Befehl verwenden, um vorherige Versionen zu entfernen.

Mit dem folgenden Befehl können Sie mehrere installierte Versionen auflisten:

Get-Module SqlServer -ListAvailable

Sie können den folgenden Befehl zum Entfernen älterer Versionen verwenden:

Uninstall-module -Name SQLServer -RequiredVersion "<version number>" -AllowClobber

Problembehandlung

Wenn bei der Installation Probleme auftreten, finden Sie weitere Informationen unter Install-Module documentation (Dokumentation zu „Install-Module“) und Install-Module reference (Referenz zu „Install-Module“).

Verwenden einer spezifischen Version des SqlServer-Moduls

Wenn Sie eine spezifische Version des Moduls verwenden möchten, importieren Sie sie mit einer spezifischen Versionsnummer entsprechend mit dem folgenden Befehl:

Import-Module SqlServer -Version 21.1.18218

Vorabversionen des SqlServer-Moduls

Vorabversionen (oder „Preview“-Versionen) des SqlServer-Moduls sind möglicherweise im PowerShell-Katalog verfügbar.

Wichtig

Diese Versionen können über die aktualisierten Cmdlets Find-Module und Install-Module, die Teil des PowerShellGet-Moduls sind, ermittelt und installiert werden, indem der -AllowPrerelease-Switch übergeben wird. Um diese Cmdlets zu verwenden, installieren Sie das PowerShellGet-Modul, und öffnen Sie dann eine neue Sitzung.

So ermitteln Sie Vorabversionen des SqlServer-Moduls

Sie können den folgenden Befehl ausführen, um die Vorabversion bzw. Preview-Version des SqlServer-Moduls zu ermitteln:

Find-Module SqlServer -AllowPrerelease

So installieren Sie eine bestimmte Vorabversion des SqlServer-Moduls

Wenn Sie eine bestimmte Vorabversion des Moduls installieren möchten, installieren Sie diese mit einer bestimmten Versionsnummer.

Sie können versuchen, den folgenden Befehl zu verwenden:

Install-Module SqlServer -RequiredVersion 21.1.18218-preview -AllowPrerelease

SQL Server PowerShell unter Linux

Besuchen Sie Verwalten von SQL Server für Linux mit PowerShell Core, um zu erfahren, wie Sie SQL Server PowerShell unter Linux installieren.

Sonstige Module

  • Az.Sql: SQL-Dienst-Cmdlets für Azure Resource Manager in Windows PowerShell und PowerShell Core

  • SqlServerDsc: Modul mit DSC-Ressourcen für die Bereitstellung und Konfiguration von Microsoft SQL Server

Cmdlet-Referenz

Nächste Schritte