Instalación del módulo SQL Server PowerShell
Se aplica a: 
SQL Server (todas las versiones admitidas) Azure SQL Database Instancia administrada de Azure SQL Azure Synapse Analytics Almacenamiento de datos paralelos
En este artículo se proporcionan instrucciones para instalar el módulo de PowerShell SqlServer.
Módulos de PowerShell para SQL Server
Hay dos módulos de SQL Server PowerShell:
SqlServer: El módulo SqlServer incluye cmdlets nuevos para la compatibilidad con las características más recientes de SQL. El módulo además contiene versiones actualizadas de los cmdlets de SQLPS. Para descargar el módulo SqlServer, vaya al módulo SqlServer en la Galería de PowerShell.
SQLPS: SQLPS es el módulo que usa el Agente SQL para ejecutar trabajos del agente en pasos de trabajo del agente mediante el subsistema de PowerShell.
Nota
Las versiones del módulo SqlServer de la Galería de PowerShell admiten el control de versiones y requieren la versión 5.0 de PowerShell o versiones posteriores.
Para ver los temas de ayuda, vaya a:
SQL Server Management Studio
SQL Server Management Studio (SSMS) no instala ninguno de los módulos de PowerShell. Para usar PowerShell con SSMS, instale el módulo SqlServer desde la Galería de PowerShell.
Nota
Con SSMS 16.x, se incluye una versión anterior del módulo SqlServer con SQL Server Management Studio (SSMS).
Azure Data Studio
Azure Data Studio no instala ninguno de los módulos de PowerShell. Para usar PowerShell con Azure Data Studio, instale el módulo SqlServer desde la Galería de PowerShell.
Puede usar la extensión de PowerShell que proporciona compatibilidad con el editor de PowerShell enriquecida en Azure Data Studio.
Instalación o actualización del módulo SqlServer
Para instalar el módulo SqlServer desde la Galería de PowerShell, inicie una sesión de PowerShell como administrador. También puede iniciar Azure Data Studio como administrador y ejecutar estos comandos en una sesión de PowerShell en el terminal integrado.
También puede usar Install-Module SQLServer -Scope CurrentUser para ejecutar permisos elevados. Este cmdlet es útil para los usuarios que no son administradores de su entorno. Pero como el ámbito se limita al usuario actual, otros usuarios del mismo equipo no pueden usar el módulo.
Instalación del módulo SqlServer
Ejecute el comando siguiente en la sesión de PowerShell para instalar el módulo SqlServer para todos los usuarios:
Install-Module -Name SqlServer
Para ver las versiones del módulo SqlServer instaladas
Ejecute el comando siguiente para ver las versiones del módulo SqlServer que se han instalado.
Get-Module SqlServer -ListAvailable
Instalación para el usuario actual en lugar de como administrador
Si no puede ejecutar la sesión de PowerShell como administrador, haga la instalación para el usuario actual con el comando siguiente:
Install-Module -Name SqlServer -Scope CurrentUser
Para sobrescribir una versión anterior del módulo SqlServer
También puede usar el comando Install-Module para sobrescribir una versión anterior.
Install-Module -Name SqlServer -AllowClobber
Nota
PowerShell siempre usa el módulo más reciente instalado.
Actualización de la versión instalada del módulo SqlServer
Cuando haya disponibles versiones actualizadas del módulo SqlServer, puede instalar la versión más reciente con el comando siguiente:
Install-Module -Name SqlServer -AllowClobber
Puede usar el comando Update-Module para instalar la versión más reciente del módulo SQLServer de PowerShell, pero eso no quita las versiones anteriores. Instala la versión más reciente en paralelo para que pueda experimentar con la versión más reciente, pero con los módulos más antiguos todavía instalados.
Sin embargo, si no quiere conservar las versiones anteriores del módulo, puede usar el comando Uninstall-Module para quitarlas.
Puede usar el comando siguiente para enumerar si hay más de una versión instalada:
Get-Module SqlServer -ListAvailable
Puede usar el comando siguiente para quitar versiones anteriores:
Uninstall-module -Name SQLServer -RequiredVersion "<version number>" -AllowClobber
Solución de problemas
Si le surgen problemas durante la instalación, consulte la documentación de instalación de módulos y la referencia de instalación de módulos.
Uso de una versión específica del módulo SqlServer
Para usar una versión específica del módulo, impórtela con un número de versión específico de forma similar al comando siguiente:
Import-Module SqlServer -Version 21.1.18218
Versiones preliminares del módulo SqlServer
Las versiones preliminares del módulo SqlServer pueden estar disponibles en la Galería de PowerShell.
Importante
Estas versiones se pueden detectar e instalar mediante los cmdlets actualizados Find-Module e Install-Module que forman parte del módulo PowerShellGet si se pasa el modificador -AllowPrerelease. Para usar estos cmdlets, instale el módulo PowerShellGet y, a continuación, abra una sesión nueva.
Para detectar las versiones preliminares del módulo SqlServer
Para detectar las versiones preliminares del módulo SqlServer, ejecute el comando siguiente:
Find-Module SqlServer -AllowPrerelease
Para instalar una versión preliminar específica del módulo SqlServer
Para instalar una versión de lanzamiento preliminar específica del módulo, instálela con un número de versión específico.
Puede intentar usar el comando siguiente:
Install-Module SqlServer -RequiredVersion 21.1.18218-preview -AllowPrerelease
SQL Server PowerShell en Linux
Visite Administración de SQL Server en Linux con PowerShell Core para ver cómo instalar SQL Server PowerShell en Linux.
Otros módulos
Az.Sql: cmdlets del servicio SQL para Azure Resource Manager en Windows PowerShell y PowerShell Core.
SqlServerDsc: módulo con recursos de DSC para la implementación y configuración de Microsoft SQL Server.