Installieren des SQL Server PowerShell-Moduls

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics 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

SQL Server Management Studio (SSMS) 16.x (und frühere Versionen) enthielten das SQLPS-Modul.

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

Installieren des SqlServer-Moduls auf einem Offlinecomputer

Dieser Abschnitt führt Sie durch die Schritte zum Installieren des SqlServer PowerShell-Moduls auf einem Computer, der keinen Zugriff auf das Internet hat. Für diese Installation benötigen Sie zwei Computer: einen Computer, der mit dem Internet verbunden ist, und den Zielcomputer, der offline ist (nicht mit dem Internet verbunden).

  1. Laden Sie auf einem Computer, der mit dem Internet verbunden ist, das SQLServer-PowerShell-Modul herunter. Mit diesem Befehl werden alle Dateien für das Modul in den Beispielordner $env:TEMP\SQLServer\<SomeVersion>, der im -Path-Parameter definiert ist, heruntergeladen und dort gespeichert. Sie können einen Ordner Ihrer Wahl als Ziel auf Ihrem Computer mit Internetverbindung auswählen.

    Save-Module -Name SqlServer -Path $env:TEMP

  2. Navigiere im Datei-Explorer zum Ordnerspeicherort, um zu überprüfen, ob ein $env:TEMP\SQLServer\<SomeVersion>-Ordner vorhanden ist, oder führe den folgenden Befehl aus:

    Get-ChildItem -Path $env:TEMP\SQLServer\

  3. Kopieren Sie den $env:TEMP\SQLServer\<SomeVersion>-Ordner, den Sie in Schritt 2 gefunden haben, auf dem Zielofflinecomputer in den %ProgramFiles%\WindowsPowerShell\Modules\SqlServer-Ordner (dieser Ordner würde sowohl für PS5 als auch für PS7 funktionieren). Ersetzen Sie <SomeVersion> unbedingt durch den Wert, den Sie im vorherigen Schritt gefunden haben.

  4. Vergewissern Sie sich, dass das SqlServer-PowerShell-Modul auf dem Offlinecomputer verfügbar ist, indem Sie das folgende PowerShell-Cmdlet ausführen:

    Get-Module SqlServer -ListAvailable

    Die Ausgabe kann wie folgt aussehen (die tatsächliche Version kann anders sein und muss mit der zuvor aufgeführten <SomeVersion> übereinstimmen):

       PS C:\Users\user1> Get-Module SqlServer -ListAvailable

       Directory: C:\Program Files\WindowsPowerShell\Modules

   ModuleType Version    Name                     ExportedCommands
   ---------- -------    ----                     ----------------
   Script     22.1.1     SqlServer                {Add-RoleMember, Add-SqlAvail...

Anzeigen der Versionen des installierten SqlServer-Moduls

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

Überschreiben einer früheren 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.

Ermitteln der 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

Installieren einer bestimmten 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