M365Con 2027 – conferencia online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Los módulos de Exchange Online y Microsoft Graph fallan juntos en un mismo runbook de Azure Automation

Por ·

Cada módulo funciona por separado, pero conectarse a Exchange Online y a Microsoft Graph en el mismo runbook falla con errores de carga de módulos. Descubre por qué chocan las versiones y cómo probar un entorno de ejecución con la versión fijada.

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

Un runbook de prueba se conecta a Exchange Online con su identidad administrada y lee un buzón. Funciona. Un segundo runbook de prueba se conecta a Microsoft Graph con la misma identidad y lee un usuario. También funciona. Si los pones en un mismo runbook, falla.

Puntos clave

  • Los errores son fallos al cargar módulos, no errores de permisos. Conceder más derechos no los solucionará.
  • Una solución comunitaria confirmada de 2024 identificó la causa: ambos módulos cargan versiones distintas de System.Text.Json en un mismo proceso, y el módulo que se carga primero gana.
  • Un hilo de marzo de 2026 lo resolvió provisionalmente con un nuevo entorno de ejecución de PowerShell 7.4 y ExchangeOnlineManagement 3.5.0, pero quien preguntó aún no había probado el script real.
  • Learn indica que ExchangeOnlineManagement 3.10.0 o posteriores requiere PowerShell 7.6, mientras que su página de entornos de ejecución de Automation enumera 5.1 y 7.4. Fija la versión del módulo y prueba en el panel Test antes de publicar.

Ese es el hilo de Microsoft Q&A de marzo de 2026 del que parte este artículo. Coincide con un hilo más antiguo de Tech Community, de 2024, que sí llegó a una solución confirmada por quien preguntó. Este artículo explica la causa, muestra lo que dice Microsoft Learn sobre versiones y entornos de ejecución, y propone un plan de pruebas. Es una guía de resolución de problemas, no un procedimiento oficial de Microsoft.

Síntomas

El autor de la pregunta de marzo de 2026 usaba una identidad administrada asignada por el sistema, con Connect-ExchangeOnline -ManagedIdentity -Organization <tenant>.onmicrosoft.com seguido de Connect-MgGraph -Identity. Se importaron ExchangeOnlineManagement versión 3.9.2 y varios módulos de Microsoft.Graph. Los errores fueron:

  • Entorno de ejecución 5.1: Connect-MgGraph se encontró en el módulo Microsoft.Graph.Authentication, pero el módulo no se pudo cargar.
  • Entorno de ejecución 7.2: Unable to find type [Microsoft.Exchange.Management.RestApiClient.ExchangeEnvironment].

El hilo de 2024, en un escritorio con Windows PowerShell 5.1, mostraba IDX12729: Unable to decode the header ... as Base64Url encoded string y un error "method not found" que nombraba System.Text.Json.Utf8JsonReader. Otro participante vio Connect-MgGraph: Invalid JWT access token al usar Connect-IPPSSession en la misma sesión.

Todos estos son errores de carga o de tiempo de ejecución. No son Authorization_RequestDenied ni mensajes de acceso denegado. La diferencia importa, porque una respuesta generada por IA en el hilo de marzo indicó al autor de la pregunta que concediera Exchange.ManageAsApp y el rol de Exchange Administrator. Son requisitos reales, pero abordan la autorización y no pueden solucionar un módulo que no se carga.

Por qué ocurre

En el hilo de 2024, una respuesta de un miembro de la comunidad (un Silver Contributor, no un empleado de Microsoft) se marcó como solución. Decía que ambos módulos cargan su propia copia de System.Text.Json.dll en el mismo proceso de PowerShell. Exchange Online 3.5.1 incluía la versión 8.0.x y Microsoft.Graph.Authentication usaba una versión 6.0.x. PowerShell mantiene una sola versión de un ensamblado por proceso, así que gana el módulo que se carga primero y el segundo puede fallar.

El autor de la pregunta en ese hilo eliminó los módulos de Graph antes de conectarse, actualizó ambos módulos y borró la caché de MSAL. Nada de eso ayudó. Tras volver a ExchangeOnlineManagement 3.4.0, el autor escribió que funcionó. Otros participantes informaron de la misma solución. Otro participante notó una mejoría con la 3.6.0, pero Connect-IPPSSession con certificado seguía fallando en su caso. Un participante informó de que, en su prueba, establecer -LogLevel en Default en lugar de All lo solucionó. Learn no menciona ese ajuste, así que tómalo como un informe de la comunidad.

Un moderador voluntario (un MVP) en el hilo de 2026 dio una explicación similar. Los módulos dependen de binarios adicionales que no están alineados entre equipos, así que puede que tengas que combinar versiones de módulos y hosts de PowerShell.

Learn no describe el conflicto de System.Text.Json. Sí incluye, en las notas de la versión 3.6.0 de ExchangeOnlineManagement, un elemento "Added fix for compatibility issue with the Microsoft.Graph module" (corrección añadida para un problema de compatibilidad con el módulo Microsoft.Graph). No ofrece más detalles.

Paso 1: Confirma qué tipo de error tienes

  1. Ejecuta cada conexión por separado en un runbook de prueba. Si ambas funcionan por separado, tienes un conflicto, no un problema de permisos.
  2. Copia la primera línea del error. Cualquier mensaje sobre la carga de un módulo, un tipo o un método es un conflicto. Forbidden, Access denied o Authorization_RequestDenied indican un problema de permisos.
  3. Para los problemas de permisos, sigue la página de Learn sobre identidades administradas para Exchange. Requiere que la identidad tenga asignado el permiso de API Exchange.ManageAsApp y un rol de Entra como Exchange Administrator. La nota de Learn indica que Security Administrator no tiene los permisos necesarios para esas tareas.

Paso 2: Comprueba qué versión de ensamblado necesita cada módulo

El hilo de 2024 sugería comprobar la versión del ensamblado cargado en una sesión nueva, un módulo cada vez. El resumen del hilo no muestra el comando exacto. El siguiente comando es una comprobación general de .NET, no procede de Learn ni del hilo, así que pruébalo en un equipo de pruebas. Importa un módulo y ejecuta:

``powershell (Get-Item -Path "$([System.Text.Json.Utf8JsonReader].Assembly.Location)").VersionInfo ``

Repite en una sesión nueva con el otro módulo. Si las versiones difieren, tienes el conflicto de ese hilo. Usa las mismas versiones de módulo que en el runbook.

Paso 3: Fija versiones en un entorno de ejecución separado

El autor de la pregunta de marzo de 2026 resolvió el caso de prueba creando un entorno de ejecución nuevo. El hilo no indica los pasos en la interfaz. La página de Learn sobre entornos de ejecución sí los describe:

  1. En Azure Portal, abre la cuenta de Automation. En Información general, selecciona Probar la experiencia de entorno de ejecución si todavía no estás en ella.
  2. En Process Automation, selecciona Runtime Environments y, a continuación, Crear.
  3. En Conceptos básicos, escribe un nombre, elige PowerShell como lenguaje y 7.4 como versión de runtime. Learn indica que el lenguaje y la versión no se pueden cambiar después.
  4. En Paquetes, el paquete Az se añade de forma predeterminada. Usa Agregar desde la galería para añadir ExchangeOnlineManagement con una versión fija y los módulos de Microsoft.Graph que llamas. El hilo usó la 3.5.0 para Exchange Online.
  5. Selecciona Crear.
  6. Vincula una copia de tu runbook. En Runbooks, selecciónalo y, después, Actualizar entorno de ejecución.
  7. Abre el runbook, Editar en el portal, elige el nuevo entorno y, después, Panel de pruebas e Iniciar. Publica solo si la prueba se completa correctamente.

Learn indica que importar un paquete puede tardar varios minutos, que puedes añadir hasta 10 paquetes a la vez y que, en la nueva experiencia, la hoja Módulos se sustituye por los entornos de tiempo de ejecución.

La versión que debes fijar depende del entorno de tiempo de ejecución:

  • Learn indica que ExchangeOnlineManagement 3.10.0 y posteriores requieren PowerShell 7.6.0 o posterior debido a las dependencias de ensamblados de .NET 10. Su página sobre entornos de tiempo de ejecución menciona 5.1 y 7.4 como opciones. Por tanto, un entorno de tiempo de ejecución 7.4 necesita una versión anterior a 3.10.0. Esta es una conclusión extraída de dos páginas de Learn, no una afirmación de ninguna de ellas, así que confirma qué ofrece tu cuenta.
  • Learn enumera problemas con las versiones 3.7.0 a 3.9.2 en Ubuntu 20.04 y 18.04, y señala la 3.9.2 como la última versión para algunas plataformas más antiguas. Esas notas se refieren a plataformas de escritorio, no a Automation.
  • La prueba del propio hilo de marzo usó la 3.5.0 en 7.4. El autor de la pregunta añadió un comentario indicando que el script real aún no se había probado, por lo que no existe una respuesta confirmada para 3.9.x en 7.4.
  • El entorno de tiempo de ejecución 5.1 no evitó el conflicto del hilo de marzo, que falló en 5.1 con la 3.9.2.

Prueba al menos dos combinaciones, por ejemplo, la versión de Exchange que tienes fijada con los módulos de Graph más recientes, y con una versión anterior de Graph. Learn advierte de que las versiones preliminares de PackageManagement o PowerShellGet pueden causar problemas de conexión, así que usa las versiones publicadas.

Paso 4: Considera dividir el trabajo

Si ninguna combinación funciona, evita cargar ambos módulos en un mismo proceso. Por ejemplo, haz que un runbook se encargue de la parte de Exchange y otro de la parte de Graph, e inicia el segundo desde el primero. Esto se deduce de la causa indicada en el hilo de 2024. Ninguno de los dos hilos lo ha probado, así que crea primero una prueba de concepto pequeña.

Comprueba también si Graph puede sustituir a los cmdlets de Exchange en tu script. La página de Exchange de Learn lo señala para cuatro cmdlets de grupos de Microsoft 365, como New-UnifiedGroup, que según indica no pueden usarse con identidad administrada y para los que recomienda Graph. Para otras tareas, no des por hecho que Graph tenga un equivalente.

Verifica

  1. En el panel de prueba, la salida del trabajo muestra ambas conexiones y un resultado de cada servicio.
  2. Ejecuta el runbook publicado mediante una programación o un inicio manual, y revisa los flujos del trabajo por si hay advertencias sobre la carga de ensamblados.
  3. Anota las versiones exactas de los módulos y del entorno de tiempo de ejecución. Una actualización posterior de la galería puede romper una configuración que funcionaba. Fijar versiones solo te protege mientras no las cambies.

Limitaciones

  • El hilo de 2024 es más antiguo de lo habitual y usó Windows PowerShell de escritorio. Lo incluyo porque nombra la causa y tiene un resultado confirmado.
  • La solución del hilo de 2026 es una primera prueba, no una corrección verificada para producción.
  • La página de identidad administrada de Exchange de Learn todavía menciona los entornos 5.1 y 7.1 (Preview) al añadir el módulo, lo que no coincide con la página de entornos de tiempo de ejecución. Para los entornos actuales, usa la página de entornos de tiempo de ejecución.
  • Learn no documenta el conflicto en sí. La causa procede de un experto de la comunidad.

Relacionado

Fuentes

Entidades en este artículo

Azure Automation Exchange Online PowerShell Microsoft Graph PowerShell Managed identity

Artículos relacionados

RSS