Instalación del módulo SQL Server PowerShell
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).
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
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\
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.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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de