Installieren des SQL Server PowerShell-Moduls

Gilt für: SQL Server (alle unterstützten Versionen) Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

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.1 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, und führen Sie Install-Module SQLServer aus, um das SqlServer-Modul über den PowerShell-Katalog zu installieren.

Install-Module -Name SqlServer

Wenn Sie Windows PowerShell ausführen, können Sie Install-Module SQLServer -Scope CurrentUser verwenden, um das Modul nur für den aktuellen Benutzer bzw. die aktuelle Benutzerin zu installieren, ohne dass erhöhte Berechtigungen benötigt werden.

Installieren des SqlServer-Moduls für alle Benutzer*innen

Um das SqlServer-Modul für alle Benutzer*innen zu installieren, führen Sie den folgenden Befehl in einer PowerShell-Sitzung mit erhöhten Rechten aus. Starten Sie die PowerShell-Sitzung als Administrator:

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

So zeigen Sie die Version des in der aktuellen Sitzung geladenen SqlServer-Moduls an

(Get-Module SqlServer).Version

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:

Update-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>"

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, 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