Instalación del módulo SQL Server PowerShell

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

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.

Nota:

Las versiones del módulo SqlServer de la Galería de PowerShell admiten el control de versiones y requieren la versión 5.1 de PowerShell o posteriores.

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

Para obtener artículos de ayuda, vaya a:

Nota:

En el contexto de los módulos SqlServer y SQLPS, es posible que determinados nombres de comando existan en ambos módulos.

Esto puede crear un conflicto cuando ya haya un módulo instalado y el otro se esté instalando o actualizando. Para evitar este conflicto, se puede usar el parámetro -AllowClobber al instalar o actualizar el módulo. Además, al importar un módulo, es necesario quitar primero el otro módulo o usar el parámetro -DisableNameChecking para evitar un error. Estas medidas garantizan que los módulos puedan coexistir sin causar problemas.

SQL Server Management Studio

Descargue 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:

SQL Server Management Studio (SSMS) 16.x (y versiones anteriores) incluían el módulo SQLPS.

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 y ejecute Install-Module SQLServer.

Install-Module -Name SqlServer

Si se ejecuta en Windows PowerShell, puede usar Install-Module SQLServer -Scope CurrentUser a fin de instalar el módulo para el usuario actual y evitar la necesidad de permisos elevados.

Instalación del módulo SqlServer para todos los usuarios

Si desea instalar el módulo SqlServer para todos los usuarios, ejecute el comando a continuación en una sesión elevada de PowerShell; inicie una sesión de PowerShell como administrador:

Install-Module -Name SqlServer

Instalación del módulo SqlServer en un equipo sin conexión

En esta sección se describen los pasos para instalar el módulo SqlServer de PowerShell en un equipo que no tenga acceso a Internet. Necesita dos equipos para realizar esta instalación: un equipo conectado a Internet y un equipo de destino sin conexión (no conectado a Internet).

  1. En un equipo conectado a Internet, descargue el módulo de PowerShell de SQLServer. Este comando descarga y guarda todos los archivos del módulo en la carpeta de ejemplo $env:TEMP\SQLServer\<SomeVersion>, que se define en el parámetro -Path. Puede elegir una carpeta de su preferencia como destino en el equipo conectado a Internet.

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

  2. Vaya a la ubicación de la carpeta en el Explorador de archivos para comprobar que existe una carpeta $env:TEMP\SQLServer\<SomeVersion> o ejecute este comando:

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

  3. Copie la carpeta $env:TEMP\SQLServer\<SomeVersion> que encontró en el paso 2 en el equipo sin conexión de destino en la carpeta %ProgramFiles%\WindowsPowerShell\Modules\SqlServer (esta carpeta puede funcionar para PS5 y PS7). Asegúrese de reemplazar <SomeVersion> por el valor que encontró en el paso anterior.

  4. Confirme que el módulo SqlServer de PowerShell está disponible en el equipo sin conexión mediante la ejecución del siguiente cmdlet de PowerShell:

    Get-Module SqlServer -ListAvailable

    La salida puede tener este aspecto (la versión real puede ser diferente y debe coincidir con <SomeVersion> mencionado anteriormente):

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

Visualización de 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

Para ver la versión del módulo SqlServer cargado en la sesión actual

(Get-Module SqlServer).Version

Sobrescritura de 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:

Update-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. Instale 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>"

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 abra una sesión nueva.

Detección de las versiones preliminares del módulo SqlServer

Para detectar las versiones preliminares del módulo SqlServer, ejecute el comando siguiente:

Find-Module SqlServer -AllowPrerelease

Instalación de una versión preliminar específica del módulo SqlServer

Para instalar una versión 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 de servicio de SQL para Azure Resource Manager en Windows PowerShell y PowerShell.

  • SqlServerDsc: módulo con recursos de DSC para la implementación y configuración de Microsoft SQL Server.

Referencia de cmdlets

Contenido relacionado