Instalar el módulo de PowerShell de Exchange Online (paso a paso)

Por Mirko Peters · 2026-11-12

Instala el módulo de PowerShell de Exchange Online con Install-Module ExchangeOnlineManagement: requisitos, ámbito, comprobación de versión, actualizaciones y soluciones a errores.

Traducido automáticamente con IA a partir de la publicación original. Lee el original en inglés

Para instalar el módulo de PowerShell de Exchange Online, abre PowerShell como administrador y ejecuta Install-Module -Name ExchangeOnlineManagement. Eso instala el módulo para todos los usuarios del equipo. Si no puedes ejecutarlo como administrador, añade -Scope CurrentUser y se instalará solo para tu propia cuenta. Este artículo está dirigido a administradores de Exchange y Microsoft 365 que configuran un nuevo equipo de administración, un servidor de salto o un agente de compilación. Cubre los requisitos, los pasos de instalación y verificación, la actualización y eliminación del módulo, y los errores que más se encuentran.

Puntos clave

• Instala el módulo de PowerShell de Exchange Online con Install-Module -Name ExchangeOnlineManagement, en una ventana de PowerShell ejecutada como administrador para todos los usuarios.
• Usa -Scope CurrentUser si no puedes usar derechos de administrador. Actualiza el módulo más adelante con el mismo ámbito que usaste para instalarlo.
• Windows PowerShell 5.1 necesita .NET Framework 4.7.2. El soporte en PowerShell 7 depende de la versión del módulo, y la 3.10.0 o posteriores requieren PowerShell 7.6.0.
• Comprueba el resultado con Get-InstalledModule, que muestra la versión y si el módulo está en la ubicación de todos los usuarios o en la del usuario actual.
• El módulo ya no necesita autenticación básica en WinRM, porque sus conexiones usan REST.

Qué es el módulo y qué necesitas antes

El módulo se llama ExchangeOnlineManagement. La documentación de Microsoft lo denomina módulo de Exchange Online PowerShell V3. Te conecta con Exchange Online PowerShell, con Security & Compliance PowerShell y con PowerShell para el complemento de seguridad integrado para buzones locales. Utiliza autenticación moderna, por lo que funciona con o sin autenticación multifactor.

Hay un cambio que afecta a los scripts antiguos. Microsoft indica que desde octubre de 2023, las conexiones de la API REST han sustituido a las antiguas conexiones de PowerShell remoto con autenticación básica. Las conexiones del módulo no necesitan autenticación básica en WinRM, así que no hay nada que activar ahí.

Antes de instalar, comprueba estos requisitos previos:

• Versión de PowerShell y .NET. Windows PowerShell 5.1 necesita .NET Framework 4.7.2. Windows 11, Windows Server 2022 y Windows Server 2025 incluyen la versión 4.8.x, así que ahí no tienes problemas. PowerShell 7 también funciona, y la versión mínima depende de la versión del módulo, que explica la siguiente sección.
• Directiva de ejecución. La página de Microsoft indica que, si la directiva de ejecución no es adecuada, aparece el error "No se pueden cargar los archivos porque la ejecución de scripts está deshabilitada en este sistema". La solución documentada es Set-ExecutionPolicy RemoteSigned, ejecutada como administrador. Lee la página de Microsoft sobre las directivas de ejecución antes de cambiarla y consulta primero a tu equipo de seguridad si el equipo está administrado.
• PowerShellGet y PackageManagement. Las conexiones REST en Windows necesitan PowerShellGet, y PowerShellGet depende de PackageManagement. Sin ellos, es posible que veas un error sobre un cmdlet Update-ModuleManifest que falta. Microsoft también indica que las versiones preliminares de estos dos módulos pueden causar problemas de conexión, y ofrece un comando para listar las versiones instaladas: Get-InstalledModule PackageManagement -AllVersions; Get-InstalledModule PowerShellGet -AllVersions.
• TLS 1.2. En Windows PowerShell 5.1 con una versión antigua de Windows, PowerShell Gallery requiere TLS 1.2 o superior. Si la descarga falla con un error de conexión en un servidor antiguo, esto es lo primero que debes comprobar.

Un sistema muy antiguo es un callejón sin salida. Windows 7 SP1 y Windows Server 2008 R2 SP1 solo reciben la versión 2.0.3 del módulo, y Microsoft indica que esa versión no puede conectarse porque no tiene compatibilidad con REST.

Qué versión de PowerShell corresponde a cada versión del módulo

Windows PowerShell 5.1 funciona con todas las versiones del módulo, con el requisito de .NET mencionado antes. Para PowerShell 7, Microsoft muestra esta correspondencia:

• El módulo 3.10.0 o posterior necesita PowerShell 7.6.0 o posterior, que usa .NET 10.
• Los módulos 3.5.0 a 3.9.2 necesitan PowerShell 7.4.0 o posterior, que usa .NET 8.
• Los módulos 3.0.0 a 3.4.0 necesitan PowerShell 7.2.0 o posterior, que usa .NET 6.
• El módulo 2.0.4 y las versiones posteriores de la rama 2.x necesitan PowerShell 7.0.3.

Así que si instalaste la última versión del módulo en un equipo con PowerShell 7.4, prepárate para problemas. Puedes actualizar PowerShell o instalar una versión anterior del módulo con -RequiredVersion. En el momento de escribir este artículo, Microsoft indica que la versión actual es la 3.10.1. Consulta la página del módulo para ver el número que corresponda cuando leas esto.

Microsoft también admite el módulo en Linux y macOS. En Linux, conectarse a través de un proxy requiere la versión 3.0.0 del módulo o posterior. En ambos sistemas, Connect-IPPSSession, y con él Security & Compliance PowerShell, no está disponible en PowerShell 7. Si administras Exchange Online desde un Mac, esa es la única limitación que debes conocer antes de planificar tus herramientas.

Windows 10 merece una breve nota. Las ediciones para consumidores llegaron al final del soporte en octubre de 2025, y Microsoft indica que no admiten .NET 8.0 ni .NET 10.0. Para el módulo 3.5.0 o posterior con PowerShell 7.4 o posterior, solo funcionan las ediciones Enterprise e IoT LTSC que siguen en soporte.

Comprueba tu versión de PowerShell antes de instalar

Una comprobación de dos minutos te ahorra muchas suposiciones después. En la ventana donde vas a trabajar, ejecuta $PSVersionTable.PSVersion para ver qué versión de PowerShell estás usando. Compara el resultado con la correspondencia anterior. En Windows PowerShell 5.1 también conviene saber la versión de PowerShellGet, así que ejecuta Get-InstalledModule PowerShellGet -AllVersions. Si ese comando muestra una versión preliminar, elimínala o actualiza a una versión estable antes de continuar. La página del módulo de Microsoft señala las versiones preliminares de PowerShellGet y PackageManagement como una fuente de problemas de conexión.

Anota el resultado junto al nombre del equipo si administras más de unos pocos servidores. Cuando un compañero te informe de una conexión fallida tres meses después, podrás comparar las versiones en segundos.

Cómo instalar paso a paso el módulo de PowerShell de Exchange Online

Estos pasos funcionan en Windows PowerShell 5.1 y en PowerShell 7.

1. Abre PowerShell. Elige Ejecutar como administrador si quieres instalar el módulo para todos los usuarios. Omite este paso si planeas instalarlo solo para el usuario actual.
2. Si este es el primer módulo que instalas en el equipo, actualiza primero PowerShellGet y luego cierra y vuelve a abrir PowerShell. Microsoft recomienda este orden antes de la primera instalación.
3. Ejecuta Install-Module -Name ExchangeOnlineManagement para todos los usuarios. Para tu propia cuenta únicamente, ejecuta Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser.
4. Responde a cualquier solicitud que PowerShell muestre durante la instalación. Tu organización debe permitir el acceso a PowerShell Gallery para que la descarga funcione.
5. Verifica la instalación con Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation.
6. Revisa la línea InstalledLocation. Una ruta dentro de %ProgramFiles%\WindowsPowerShell\Modules\ indica que el módulo está instalado para todos los usuarios. Una ruta en tu carpeta Documentos indica que está instalado solo para el usuario actual.
7. Pruébalo en una ventana nueva con Connect-ExchangeOnline -UserPrincipalName admin@contoso.com. Para los detalles de la conexión, consulta el artículo Connect to Exchange Online PowerShell.

¿Quieres una versión preliminar? Añade -AllowPrerelease. Para elegir una versión preliminar concreta, combínalo con -RequiredVersion. Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease muestra lo que está disponible, y si omites -AllowPrerelease solo se listan las versiones públicas. No instales una versión preliminar en un servidor de administración de producción a menos que tengas un motivo para hacerlo. Pruébala primero en un equipo de reserva.

Actualizar y desinstalar el módulo

Microsoft publica nuevas versiones del módulo con regularidad, y las notas de la versión en su página del módulo indican qué ha cambiado. La versión 3.7.0, por ejemplo, dejó de cargar la ayuda de los cmdlets por línea de comandos de forma predeterminada, y la versión 3.9.2 marcó como obsoleto el parámetro UseRpsSession. Actualizarlo se hace con una sola línea: Update-Module -Name ExchangeOnlineManagement. Si el módulo está instalado para el usuario actual, añade -Scope CurrentUser. Microsoft recomienda usar el mismo ámbito que usaste para instalarlo. Si no coinciden, puedes acabar con una instalación en ambas ubicaciones y sin saber con certeza cuál usa PowerShell.

Por eso merece la pena ejecutar la comprobación Get-InstalledModule del paso 5 antes y después de una actualización. Si ves dos versiones, averigua a qué ámbito pertenece cada una.

Para eliminar el módulo, ejecuta Uninstall-Module -Name ExchangeOnlineManagement. Si se instaló para todos los usuarios, hazlo como administrador. Después, cierra las ventanas de PowerShell que tengas abiertas, porque un módulo que ya está cargado permanece en memoria hasta que termina su sesión.

Solucionar errores comunes de instalación

La página del módulo de Microsoft recoge algunos errores concretos y sus soluciones.

• "No match was found for the specified search criteria and module name 'ExchangeOnlineManagement'". Ejecuta Register-PSRepository -Default, que vuelve a registrar PowerShell Gallery como repositorio. Después, vuelve a intentar la instalación.
• Errores sobre PowerShellGetFormatVersion o sobre la imposibilidad de descargar proveedores. Actualiza PowerShellGet y reinicia PowerShell.
• La descarga falla en un equipo con Windows PowerShell 5.1 antiguo. PowerShell Gallery necesita TLS 1.2 o posterior. Microsoft enlaza una entrada de blog sobre la compatibilidad de la galería con TLS para más detalles.
• "Files cannot be loaded because running scripts is disabled on this system". Configura la directiva de ejecución como se describe más arriba, como administrador.
• "Cannot find a cmdlet Update-Manifest" o un mensaje similar sobre Update-ModuleManifest al conectarte. Falta PowerShellGet o PackageManagement. Instala ambos y reinicia PowerShell.

Si la instalación funciona pero la conexión falla más tarde con un extraño error de ensamblado, la causa suele ser otro módulo en la misma sesión. Abre una ventana nueva y conéctate primero.

Errores comunes

• Mezclar ámbitos. Instalar para todos los usuarios una vez y actualizar después con -Scope CurrentUser deja dos versiones en el equipo. Elige un ámbito y mantenlo.
• Usar una versión de PowerShell incompatible con el módulo. El módulo más reciente con una versión anterior de PowerShell 7 falla de maneras que parecen errores de conexión. Compara tus versiones con la tabla de arriba.
• Instalar una versión preliminar en un servidor de producción. Las versiones preliminares son para pruebas. Usa la versión pública para el trabajo diario.
• Ignorar PowerShellGet. Un PowerShellGet que falta o es una versión preliminar puede romper las conexiones REST, como describe la página de Microsoft. Revísalo primero cuando una instalación nueva no se conecte.
• Seguir tutoriales antiguos. Las guías que te indican habilitar la autenticación básica en WinRM describen el método retirado de PowerShell remoto. No lo necesitas.

Temas relacionados que conviene explorar

• Conectarte con el módulo: una vez instalado, la siguiente pregunta es cómo iniciar sesión, con o sin MFA, que es lo que cubren el artículo sobre el módulo de Exchange Online PowerShell y su artículo complementario sobre la conexión.
• Autenticación solo de aplicación: los scripts programados necesitan un certificado o una identidad administrada, no una contraseña escrita.
• Uso del módulo en PowerShell 7 en Linux y macOS: las versiones compatibles varían según el sistema operativo, así que consulta primero la lista de compatibilidad.
• Control de quién puede usar PowerShell: un administrador de Exchange puede habilitar o deshabilitar el acceso a Exchange Online PowerShell por usuario.
• Mantener los módulos actualizados: establece un recordatorio periódico para comprobar si hay nuevas versiones del módulo, porque Microsoft sube de vez en cuando la versión mínima de PowerShell.

Siguiente paso

Para instalar el módulo de Exchange Online PowerShell, ejecuta Install-Module -Name ExchangeOnlineManagement, comprueba la instalación con Get-InstalledModule y mantén el mismo ámbito en todas las actualizaciones posteriores. Después, conéctate con Connect-ExchangeOnline en una ventana nueva y ejecuta Get-AcceptedDomain para confirmar que la configuración funciona.