Installieren des SQL Server PowerShell-Moduls
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).
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
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\
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.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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für