Installer le module SQL Server PowerShellInstall the SQL Server PowerShell module

S’APPLIQUE À : OuiSQL Server OuiAzure SQL Database OuiAzure Synapse Analytics (SQL Data Warehouse) OuiParallel Data Warehouse APPLIES TO: YesSQL Server YesAzure SQL Database YesAzure Synapse Analytics (SQL Data Warehouse) YesParallel Data Warehouse

Cet article fournit des instructions pour installer le module PowerShell SqlServer.This article provides directions for installing the SqlServer PowerShell module.

Modules PowerShell pour SQL ServerPowerShell modules for SQL Server

Il existe deux modules SQL Server PowerShell :There are two SQL Server PowerShell modules:

  • SqlServer : Le module SqlServer inclut de nouvelles applets de commande pour prendre en charge les dernières fonctionnalités SQL.SqlServer: The SqlServer module includes new cmdlets to support the latest SQL features. Le module contient également des versions mises à jour des applets de commande dans SQLPS.The module also contains updated versions of the cmdlets in SQLPS. Pour télécharger le module SqlServer, accédez à Module SqlServer dans PowerShell Gallery.To download the SqlServer module, go to SqlServer module in the PowerShell Gallery.
  • SQLPS : Le module SQLPS fait partie de l’installation de SQL Server (à des fins de compatibilité descendante), mais il n’est plus mis à jour.SQLPS: The SQLPS module is included with the SQL Server installation (for backward compatibility), but is no longer being updated. Le module PowerShell le plus récent est SqlServer.The most up-to-date PowerShell module is the SqlServer module.

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.The versions of the SqlServer module in the PowerShell Gallery support versioning and require PowerShell version 5.0 or greater.

Pour consulter les rubriques d’aide, accédez à :For help topics, go to:

SQL Server Management StudioSQL Server Management Studio

SQL Server Management Studio (SSMS), à partir de la version 17,0, n’installe aucun module PowerShell.SQL Server Management Studio (SSMS), beginning with version 17.0, doesn't install either PowerShell module. Pour utiliser PowerShell avec SSMS, installez le module SqlServer à partir de PowerShell Gallery.To use PowerShell with SSMS, install the SqlServer module from the PowerShell Gallery.

Notes

Avec la version 16.x de SSMS, une version antérieure du module SqlServer est incluse avec SQL Server Management Studio (SSMS)With version 16.x of SSMS, an earlier version of the SqlServer module is included with SQL Server Management Studio (SSMS)

Azure Data StudioAzure Data Studio

Azure Data Studio n’installe aucun module PowerShell.Azure Data Studio doesn't install either PowerShell module. Pour utiliser PowerShell avec Azure Data Studio, installez le module SqlServer à partir de PowerShell Gallery.To use PowerShell with Azure Data Studio, install the SqlServer module from the PowerShell Gallery.

Vous pouvez utiliser l’extension PowerShell, qui fournit une prise en charge complète de l’éditeur PowerShell dans Azure Data Studio.You can use the PowerShell extension, which provides rich PowerShell editor support in Azure Data Studio.

Installation ou mise à jour du module SqlServerInstalling or updating the SqlServer module

Pour installer le module SqlServer à partir de PowerShell Gallery, démarrez une session PowerShell en tant qu’administrateur.To install the SqlServer module from the PowerShell Gallery, start a PowerShell session as an administrator. Démarrez également Azure Data Studio en tant qu’administrateur et exécutez ces commandes dans une session PowerShell du terminal intégré.You also start Azure Data Studio as an administrator and run these commands in a PowerShell session in the integrated terminal.

Installer le module SqlServerInstall the SqlServer module

Exécutez la commande suivante dans votre session PowerShell afin d’installer le module SqlServer pour tous les utilisateurs :Run the following command in your PowerShell session to install the SqlServer module for all users:

Install-Module -Name SqlServer

Pour afficher les versions du module SqlServer installées :To view the versions of the SqlServer module installed

Exécutez la commande suivante pour afficher les versions du module SqlServer qui ont été installéesExecute the following command to see the versions of the SqlServer module that have been installed

Get-Module SqlServer -ListAvailable

Effectuez l’installation pour l’utilisateur actuel plutôt que comme administrateurInstall for the current user rather than as an administrator

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 :If you aren't able to run the PowerShell session as an administrator, install for the current user using the following command:

Install-Module -Name SqlServer -Scope CurrentUser

Pour remplacer une version précédente du module SqlServerTo overwrite a previous version of the SqlServer module

Vous pouvez également utiliser la commande Install-Module pour remplacer une version précédente.You can also use the Install-Module command to overwrite a previous version.

Install-Module -Name SqlServer -AllowClobber

Notes

PowerShell utilise toujours le dernier module installé.PowerShell always uses the latest module installed.

Mettre à jour la version installée du module SqlServerUpdate the installed version of the SqlServer module

Quand des versions mises à jour du module SqlServer sont disponibles, vous pouvez installer la dernière version à l’aide de la commande suivante :When updated versions of the SqlServer module are available, you can install the newer version using the following command:

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.You can use the Update-Module command to install the newest version of the SQLServer PowerShell module, but that doesn't remove older versions. 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.It installs the newer version side by side to allow you the ability to experiment with the latest version, yet still have older modules installed.

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.However, if you don’t want to keep older module versions, then you can use the Uninstall-Module command to remove previous versions.

Vous pouvez utiliser la commande suivante pour répertorier les différentes versions installées :You can use the following command to list if more than one version is installed:

Get-Module SqlServer -ListAvailable

Vous pouvez utiliser la commande suivante pour supprimer les anciennes versions :You can use the following command to remove older versions:

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

DépannageTroubleshooting

Si vous rencontrez des problèmes d’installation, consultez la documentation sur Install-Module et les informations de référence sur Install-Module.If you run into problems installing, see the Install-Module documentation and Install-Module reference.

Utilisation d’une version spécifique du module SqlServerUsing a specific version of the SqlServer module

Pour utiliser une version spécifique du module, importez-la avec un numéro de version spécifique comme dans la commande suivante :To use a specific version of the module, import it with a specific version number similar to the following command:

Import-Module SqlServer -Version 21.1.18080

Versions préliminaires du module SqlServerPre-release versions of the SqlServer module

Les versions préliminaires (ou « préversions ») du module SqlServer peuvent être disponibles dans PowerShell Gallery.Pre-release (or "preview") versions of the SqlServer module may be available in the 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.These versions may be discovered and installed by using the updated Find-Module and Install-Module cmdlets that are part of the PowerShellGet module by passing the -AllowPrerelease switch. Pour utiliser ces applets de commande, installez le module PowerShellGet, puis ouvrez une nouvelle session.To use these cmdlets, install the PowerShellGet module and then open a new session.

Pour découvrir les versions préliminaires du module SqlServerTo discover pre-release versions of the SqlServer module

Pour découvrir les versions préliminaires (préversions) du module SqlServer, exécutez la commande suivante :To discover the pre-release (preview) versions of the SqlServer module, run the following command:

Find-Module SqlServer -AllowPrerelease

Pour installer une version préliminaire spécifique du module SqlServerTo install a specific pre-release version of the SqlServer module

Pour installer une version préliminaire spécifique du module, installez-la avec un numéro de version spécifique.To install a specific pre-release version of the module, install it with a specific version number.

Vous pouvez essayer d’utiliser la commande suivante :You can try to use the following command:

Install-Module SqlServer -RequiredVersion 21.1.18040-preview -AllowPrerelease

SQL Server PowerShell sur LinuxSQL Server PowerShell on Linux

Visitez Gérer SQL Server sur Linux avec PowerShell Core pour savoir comment installer SQL Server PowerShell sur Linux.Visit Manage SQL Server on Linux with PowerShell Core to see how to install SQL Server PowerShell on Linux.