Installer le module SQL Server PowerShell

S’applique à : ouiSQL Server (toutes les versions prises en charge) OuiAzure SQL Database OuiAzure SQL Managed Instance ouiAzure Synapse Analytics OuiParallel Data Warehouse

Cet article fournit des instructions pour installer le module PowerShell SqlServer.

Modules PowerShell pour SQL Server

Il existe deux modules SQL Server PowerShell :

  • SqlServer : Le module SqlServer inclut de nouvelles applets de commande pour prendre en charge les dernières fonctionnalités SQL. Le module contient également des versions mises à jour des applets de commande dans SQLPS. Pour télécharger le module SqlServer, accédez à Module SqlServer dans PowerShell Gallery.

  • SQLPS : Le SQLPS est le module utilisé par SQL Agent pour exécuter les travaux de l’agent dans les étapes de travail de l’agent à l’aide du sous-système PowerShell.

Notes

Les versions du module SqlServer dans PowerShell Gallery prennent en charge la gestion des versions et nécessitent PowerShell version 5.0 ou ultérieure.

Pour consulter les rubriques d’aide, accédez à :

SQL Server Management Studio

SQL Server Management Studio (SSMS) n’installe aucun module PowerShell. Pour utiliser PowerShell avec SSMS, installez le module SqlServer à partir de PowerShell Gallery.

Notes

Avec SSMS 16.x, une version antérieure du module SqlServer est incluse avec SQL Server Management Studio (SSMS)

Azure Data Studio

Azure Data Studio n’installe aucun module PowerShell. Pour utiliser PowerShell avec Azure Data Studio, installez le module SqlServer à partir de PowerShell Gallery.

Vous pouvez utiliser l’extension PowerShell, qui fournit une prise en charge complète de l’éditeur PowerShell dans Azure Data Studio.

Installation ou mise à jour du module SqlServer

Pour installer le module SqlServer à partir de PowerShell Gallery, démarrez une session PowerShell en tant qu’administrateur. Vous pouvez également démarrer Azure Data Studio en tant qu’administrateur et exécutez ces commandes dans une session PowerShell du terminal intégré.

Vous pouvez également utiliser Installer-Module SQLServer-Étendue CurrentUser pour exécuter des autorisations élevées. Ce cmdlet est utile pour les utilisateurs qui ne sont pas administrateurs dans leur environnement. Toutefois, étant donné que l’étendue est limitée à l’utilisateur actuel, les autres utilisateurs sur le même ordinateur ne peuvent pas utiliser le module.

Installer le module SqlServer

Exécutez la commande suivante dans votre session PowerShell afin d’installer le module SqlServer pour tous les utilisateurs :

Install-Module -Name SqlServer

Pour afficher les versions du module SqlServer installées :

Exécutez la commande suivante pour afficher les versions du module SqlServer qui ont été installées

Get-Module SqlServer -ListAvailable

Effectuez l’installation pour l’utilisateur actuel plutôt que comme administrateur

Si vous ne pouvez pas exécuter la session PowerShell en tant qu’administrateur, effectuez l’installation pour l’utilisateur actuel à l’aide de la commande suivante :

Install-Module -Name SqlServer -Scope CurrentUser

Pour remplacer une version précédente du module SqlServer

Vous pouvez également utiliser la commande Install-Module pour remplacer une version précédente.

Install-Module -Name SqlServer -AllowClobber

Notes

PowerShell utilise toujours le dernier module installé.

Mettre à jour la version installée du module SqlServer

Quand des versions mises à jour du module SqlServer sont disponibles, vous pouvez installer la dernière version à l’aide de la commande suivante :

Install-Module -Name SqlServer -AllowClobber

Vous pouvez utiliser la commande Update-Module pour installer la version la plus récente du module SQL Server PowerShell, mais cela ne supprime pas les versions antérieures. Cette commande installe la version la plus récente côte à côte pour vous permettre de tester la version la plus récente en conservant les anciens modules installés.

Toutefois, si vous ne souhaitez pas conserver les anciennes versions du module, vous pouvez utiliser la commande Uninstall-Module pour supprimer les versions précédentes.

Vous pouvez utiliser la commande suivante pour répertorier les différentes versions installées :

Get-Module SqlServer -ListAvailable

Vous pouvez utiliser la commande suivante pour supprimer les anciennes versions :

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

Dépannage

Si vous rencontrez des problèmes d’installation, consultez la documentation sur Install-Module et les informations de référence sur Install-Module.

Utilisation d’une version spécifique du module SqlServer

Pour utiliser une version spécifique du module, importez-la avec un numéro de version spécifique comme dans la commande suivante :

Import-Module SqlServer -Version 21.1.18218

Versions préliminaires du module SqlServer

Les versions préliminaires (ou « préversions ») du module SqlServer peuvent être disponibles dans PowerShell Gallery.

Important

Vous pouvez découvrir et installer ces versions à l’aide des applets de commande Find-Module et Install-Module mises à jour (qui font partie du module PowerShellGet) en passant le commutateur - AllowPrerelease. Pour utiliser ces applets de commande, installez le module PowerShellGet, puis ouvrez une nouvelle session.

Pour découvrir les versions préliminaires du module SqlServer

Pour découvrir les versions préliminaires (préversions) du module SqlServer, exécutez la commande suivante :

Find-Module SqlServer -AllowPrerelease

Pour installer une version préliminaire spécifique du module SqlServer

Pour installer une version préliminaire spécifique du module, installez-la avec un numéro de version spécifique.

Vous pouvez essayer d’utiliser la commande suivante :

Install-Module SqlServer -RequiredVersion 21.1.18218-preview -AllowPrerelease

SQL Server PowerShell sur Linux

Visitez Gérer SQL Server sur Linux avec PowerShell Core pour savoir comment installer SQL Server PowerShell sur Linux.

Autres modules

  • Az.Sql : cmdlets de service SQL pour Azure Resource Manager dans Windows PowerShell et PowerShell Core.

  • SqlServerDsc : module avec des ressources DSC pour le déploiement et la configuration de Microsoft SQL Server.

Référence des applets de commande

Étapes suivantes