Partager via

Installer le module PowerShell SQL Server

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 au module SqlServer dans PowerShell Gallery.

Remarque

Les versions du module SqlServer dans PowerShell Gallery prennent en charge le versioning et nécessitent PowerShell version 5.1 ou ultérieure.

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

Pour consulter des articles d’aide, visitez :

Remarque

Dans le contexte des modules SqlServer et SQLPS , il est possible que certains noms de commandes existent dans les deux modules.

Cela peut créer un conflit lorsqu’un module est déjà installé et que l’autre est installé ou mis à jour. Le -AllowClobber paramètre peut être utilisé pour empêcher ce conflit lors de l’installation ou de la mise à jour du module. En outre, lors de l’importation d’un module, la suppression de l’autre module en premier ou l’utilisation du -DisableNameChecking paramètre pour empêcher une erreur est nécessaire. Ces mesures garantissent que les modules peuvent coexister sans provoquer de problèmes.

SQL Server Management Studio (SSMS)

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

Remarque

SQL Server Management Studio (SSMS) 16.x (et versions antérieures) incluait le module SQLPS.

Installer ou mettre à jour le module SqlServer

Pour installer le module SqlServer à partir de PowerShell Gallery, démarrez une session PowerShell et exécutez Install-Module SQLServer.

Install-Module -Name SqlServer

Si vous êtes sur Windows PowerShell, vous pouvez utiliser Install-Module SQLServer -Scope CurrentUser pour installer le module pour l’utilisateur actuel et éviter d’avoir besoin d’autorisations élevées.

Installer le module SqlServer pour tous les utilisateurs

Pour installer le module SqlServer pour tous les utilisateurs, exécutez la commande ci-dessous dans une session PowerShell avec élévation de privilèges ; démarrez une session PowerShell en tant qu’administrateur :

Install-Module -Name SqlServer

Installer le module SqlServer sur un ordinateur hors connexion

Cette section vous guide tout au long des étapes d’installation du module PowerShell SqlServer sur un ordinateur sans accès à Internet. Vous avez besoin de deux ordinateurs pour effectuer cette installation : un ordinateur connecté à Internet et un ordinateur de destination hors connexion.

  1. Sur un ordinateur connecté à Internet, téléchargez le module SQLServer PowerShell. Cette commande télécharge et enregistre tous les fichiers du module dans l’exemple $env:TEMP\SQLServer\<SomeVersion> de dossier, défini dans le -Path paramètre. Vous pouvez choisir un dossier de votre choix comme destination sur votre ordinateur connecté à Internet.

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

  2. Accédez à l’emplacement du dossier dans Explorateur de fichiers pour vérifier qu’un dossier $env:TEMP\SQLServer\<SomeVersion> existe ou exécutez cette commande :

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

  3. Copiez le dossier $env:TEMP\SQLServer\<SomeVersion> que vous avez trouvé à l’étape 2 de l’ordinateur hors connexion de destination dans le dossier %ProgramFiles%\WindowsPowerShell\Modules\SqlServer (ce dossier fonctionne à la fois pour PS5 et PS7). Veillez à remplacer <SomeVersion> par la valeur que vous avez trouvée à l’étape précédente.

  4. Vérifiez que le module SqlServer PowerShell est disponible sur l’ordinateur hors connexion en exécutant la cmdlet PowerShell suivante :

    Get-Module SqlServer -ListAvailable

    La sortie peut ressembler à ceci (la version réelle peut être différente et doit correspondre <SomeVersion> à la liste précédente) :

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

Afficher les versions du module SqlServer installées

Exécutez la commande suivante pour afficher les versions installées du module SqlServer .

Get-Module SqlServer -ListAvailable

Pour afficher la version du module SqlServer chargée dans la session active

(Get-Module SqlServer).Version

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

Remarque

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 :

Update-Module -Name SqlServer -AllowClobber

Vous pouvez utiliser la Update-Module commande pour installer la version la plus récente du module SQLServer PowerShell, mais cela ne supprime pas les versions antérieures. Il installe les versions plus récentes côte à côte pour vous permettre d’expérimenter la dernière version tout en ayant encore des modules plus anciens 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>"

Résolution des problèmes

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

Utiliser 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éversion ») du module SqlServer peuvent être disponibles dans PowerShell Gallery.

Important

Ces versions peuvent être découvertes et installées à l’aide des applets de commande et mises à jour Find-ModuleInstall-Module qui font partie du module PowerShellGet en passant le -AllowPrerelease commutateur. Pour utiliser ces cmdlets, installez le module PowerShellGet, puis ouvrez une nouvelle session.

Découvrir des versions préliminaires du module SqlServer

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

Find-Module SqlServer -AllowPrerelease

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 /sql/linux/sql-server-linux-manage-powershell-core pour voir comment installer SQL Server PowerShell sur Linux.

Autres modules

  • Az.Sql : applets de commande du service SQL pour Azure Resource Manager dans Windows PowerShell et PowerShell.

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

Référence des applets de commande

Contenu connexe

  • Last updated on