M365Con 2027 – conferência online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Os módulos Exchange Online e Microsoft Graph falham juntos em um único runbook do Azure Automation

By ·

Cada módulo funciona isoladamente, mas conectar ao Exchange Online e ao Microsoft Graph no mesmo runbook gera erros de carregamento de módulo. Entenda por que as versões entram em conflito e como testar um ambiente de runtime com versão fixada.

Automatically translated with AI from the original post. Read the English original

Um runbook de teste se conecta ao Exchange Online com sua identidade gerenciada e lê uma caixa de correio. Funciona. Um segundo runbook de teste se conecta ao Microsoft Graph com a mesma identidade e lê um usuário. Também funciona. Coloque os dois em um único runbook e ele falha.

Pontos-chave

  • Os erros são falhas de carregamento de módulo, não erros de permissão. Conceder mais direitos não vai resolvê-los.
  • Uma correção comunitária confirmada em 2024 identificou a causa: os dois módulos carregam versões diferentes de System.Text.Json no mesmo processo, e o módulo carregado primeiro prevalece.
  • Uma discussão de março de 2026 contornou o problema com um novo ambiente de runtime PowerShell 7.4 e o ExchangeOnlineManagement 3.5.0, mas quem perguntou ainda não tinha testado o script real.
  • A Learn informa que o ExchangeOnlineManagement 3.10.0 ou posterior exige o PowerShell 7.6, enquanto a página de runtime do Automation lista 5.1 e 7.4. Fixe a versão do módulo e teste no painel de teste antes de publicar.

Essa é a discussão do Microsoft Q&A de março de 2026 da qual este artigo parte. Ela corresponde a uma discussão mais antiga do Tech Community, de 2024, que chegou a uma correção confirmada por quem perguntou. Este artigo explica a causa, mostra o que a Microsoft Learn diz sobre versões e runtimes e apresenta um plano de teste. É um guia de solução de problemas, não um procedimento oficial da Microsoft.

Sintomas

O autor da pergunta de março de 2026 usou uma identidade gerenciada atribuída pelo sistema, com Connect-ExchangeOnline -ManagedIdentity -Organization <tenant>.onmicrosoft.com seguido de Connect-MgGraph -Identity. Foram importados o ExchangeOnlineManagement versão 3.9.2 e vários módulos Microsoft.Graph. Os erros foram:

  • Runtime 5.1: o Connect-MgGraph foi encontrado no módulo Microsoft.Graph.Authentication, mas o módulo não pôde ser carregado.
  • Runtime 7.2: Unable to find type [Microsoft.Exchange.Management.RestApiClient.ExchangeEnvironment].

A discussão de 2024, em um desktop com Windows PowerShell 5.1, mostrou IDX12729: Unable to decode the header ... as Base64Url encoded string e um erro de "method not found" que citava System.Text.Json.Utf8JsonReader. Outro participante viu Connect-MgGraph: Invalid JWT access token quando o Connect-IPPSSession foi usado na mesma sessão.

Todos esses são erros de carregamento ou de execução. Não são mensagens Authorization_RequestDenied nem de acesso negado. Essa diferença importa, porque uma resposta gerada por IA na thread de março orientou quem perguntou a conceder Exchange.ManageAsApp e a função Exchange Administrator. São pré-requisitos reais, mas tratam de autorização e não conseguem corrigir um módulo que não carrega.

Por que acontece

Na thread de 2024, uma resposta de um membro da comunidade (um Silver Contributor, não um funcionário da Microsoft) foi marcada como solução. Ela dizia que os dois módulos carregam, no mesmo processo do PowerShell, cada um a sua própria cópia de System.Text.Json.dll. O Exchange Online 3.5.1 trazia a versão 8.0.x, e o Microsoft.Graph.Authentication usava uma versão 6.0.x. O PowerShell mantém apenas uma versão de um assembly por processo, então o módulo que carrega primeiro prevalece, e o segundo pode falhar.

O autor da pergunta nessa thread removeu os módulos do Graph antes de conectar, atualizou os dois módulos e limpou o cache do MSAL. Nada disso resolveu. Depois de voltar para o ExchangeOnlineManagement 3.4.0, ele escreveu que funcionou. Outros participantes relataram a mesma solução. Um outro participante relatou melhora com a 3.6.0, mas o Connect-IPPSSession baseado em certificado continuou falhando para ele. Um participante relatou que definir -LogLevel como Default, em vez de All, resolveu em seu teste. O Learn não menciona essa configuração, então trate isso como um relato da comunidade.

Um moderador voluntário (um MVP) na thread de 2026 deu uma explicação semelhante. Os módulos dependem de binários adicionais que não estão alinhados entre as equipes, então talvez seja preciso combinar versões de módulos e hosts do PowerShell.

O Learn não descreve o conflito do System.Text.Json. Nas notas de versão do ExchangeOnlineManagement 3.6.0, ele lista o item "Added fix for compatibility issue with the Microsoft.Graph module", mas sem nenhum detalhe.

Passo 1: confirme que tipo de erro você tem

  1. Execute cada conexão isoladamente em um runbook de teste. Se as duas funcionarem sozinhas, você tem um conflito, não um problema de permissão.
  2. Copie a primeira linha do erro. Qualquer coisa sobre carregamento de um módulo, de um tipo ou de um método é um conflito. Forbidden, Access denied ou Authorization_RequestDenied indicam problema de permissão.
  3. Para problemas de permissão, siga a página do Learn sobre identidade gerenciada para o Exchange. Ela exige que a identidade tenha a permissão de API Exchange.ManageAsApp atribuída e uma função do Entra, como Exchange Administrator. A nota do Learn diz que a função Security Administrator não tem as permissões necessárias para essas tarefas.

Passo 2: verifique a versão do assembly que cada módulo usa

A thread de 2024 sugeriu verificar a versão do assembly carregado em uma sessão nova, um módulo por vez. O resumo da thread não mostra o comando exato. O comando abaixo é uma verificação geral do .NET, não vem do Learn nem da thread, então teste-o em uma máquina de reserva. Importe um módulo e depois execute:

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

Repita em uma nova sessão com o outro módulo. Se as versões forem diferentes, você tem o conflito descrito nessa thread. Use as mesmas versões de módulo do runbook.

Passo 3: fixe as versões em um ambiente de runtime separado

O autor da pergunta de março de 2026 resolveu o caso de teste criando um novo ambiente de runtime. A thread não mostra os cliques. A página do Learn sobre ambientes de runtime mostra:

  1. No portal do Azure, abra a conta de Automation. Em Visão geral, selecione Try Runtime Environment experience se você ainda não estiver nessa experiência.
  2. Em Process Automation, selecione Runtime Environments e, em seguida, Create.
  3. Em Basics, informe um nome, escolha PowerShell como linguagem e 7.4 como versão de runtime. O Learn diz que a linguagem e a versão não podem ser alteradas depois.
  4. Em Packages, o pacote Az é adicionado por padrão. Use Add from gallery para adicionar o ExchangeOnlineManagement em uma versão fixada, junto com os módulos Microsoft.Graph que você chama. A thread usou a 3.5.0 para o Exchange Online.
  5. Selecione Criar.
  6. Vincule uma cópia do seu runbook. Em Runbooks, selecione-o e depois Update Runtime Environment.
  7. Abra o runbook, Edit in Portal, escolha o novo ambiente e depois Test pane e Start. Publique somente se o teste passar.

O Learn observa que importar um pacote pode levar vários minutos, que você pode adicionar até 10 pacotes por vez e que o painel Módulos é substituído por ambientes de runtime na nova experiência.

A versão a fixar depende do runtime:

  • O Learn informa que o ExchangeOnlineManagement 3.10.0 e versões posteriores exigem PowerShell 7.6.0 ou posterior por causa das dependências de assemblies do .NET 10. A página de runtimes do Learn cita 5.1 e 7.4 como opções. Portanto, um runtime 7.4 precisa de uma versão anterior à 3.10.0. Esta é uma conclusão tirada de duas páginas do Learn, e não uma afirmação de nenhuma delas. Confirme o que a sua conta oferece.
  • O Learn lista problemas para as versões 3.7.0 a 3.9.2 no Ubuntu 20.04 e 18.04, e indica a 3.9.2 como a versão mais recente para algumas plataformas mais antigas. Essas observações se referem a plataformas de desktop, não ao Automation.
  • O teste do próprio tópico de março usou a 3.5.0 no 7.4. O autor da pergunta acrescentou um comentário dizendo que o script real ainda não tinha sido testado, portanto não existe resposta confirmada para a 3.9.x no 7.4.
  • O runtime 5.1 não evitou o conflito no tópico de março, que falhou no 5.1 com a 3.9.2.

Teste pelo menos duas combinações, como a versão fixada do Exchange com os módulos mais recentes do Graph e com uma versão mais antiga do Graph. O Learn alerta que versões de prévia do PackageManagement ou do PowerShellGet podem causar problemas de conexão, então use as versões lançadas.

Etapa 4: considere dividir o trabalho

Se nenhuma combinação funcionar, evite carregar os dois módulos no mesmo processo. Por exemplo, deixe um runbook fazer a parte do Exchange e outro fazer a parte do Graph, iniciando o segundo a partir do primeiro. Isso decorre da causa apontada no tópico de 2024. Nenhum dos dois tópicos testou essa abordagem, então crie uma pequena prova de conceito antes.

Verifique também se o Graph pode substituir os cmdlets do Exchange no seu script. A página do Exchange no Learn faz essa observação para quatro cmdlets de Grupos do Microsoft 365, como New-UnifiedGroup, que, segundo ela, não podem ser usados com identidade gerenciada e para os quais recomenda o Graph. Para outras tarefas, não presuma que o Graph tenha um equivalente.

Verificar

  1. No painel de Teste, a saída do trabalho mostra as duas conexões e um resultado de cada serviço.
  2. Execute o runbook publicado por meio de uma agenda ou de um início manual e verifique os fluxos do trabalho em busca de avisos sobre carregamento de assemblies.
  3. Anote as versões exatas dos módulos e o runtime. Uma atualização posterior na galeria pode quebrar uma configuração que funcionava. A fixação de versões só protege enquanto você não alterar essas versões.

Limitações

  • O tópico de 2024 é mais antigo do que o período habitual e usou o Windows PowerShell de desktop. Ele foi incluído porque identifica a causa e tem um resultado confirmado.
  • A solução do tópico de 2026 é um primeiro teste, não uma correção de produção verificada.
  • A página do Learn sobre identidade gerenciada do Exchange ainda menciona os runtimes 5.1 e 7.1 (Prévia) ao adicionar o módulo, o que difere da página de ambientes de runtime. Use a página de ambientes de runtime para os runtimes atuais.
  • O Learn não documenta o próprio conflito. A causa vem de um especialista da comunidade.

Relacionados

Fontes

Entities in this article

Azure Automation Exchange Online PowerShell Microsoft Graph PowerShell Managed identity

Related articles

RSS