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

Blog · Mirko Peters

Moduli Exchange Online e Microsoft Graph in conflitto in un unico runbook di Azure Automation

By ·

Ciascun modulo funziona da solo, ma la connessione a Exchange Online e a Microsoft Graph nello stesso runbook genera errori di caricamento dei moduli. Scopri perché le versioni entrano in conflitto e come testare un ambiente di runtime con versione bloccata.

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

Un runbook di test si connette a Exchange Online con la sua identità gestita e legge una casella di posta. Funziona. Un secondo runbook di test si connette a Microsoft Graph con la stessa identità e legge un utente. Funziona anche questo. Se li metti entrambi in un unico runbook, il risultato è un errore.

Punti chiave

  • Gli errori sono errori di caricamento dei moduli, non errori di autorizzazione. Concedere più diritti non li risolverà.
  • Una correzione della community del 2024, confermata, ha individuato la causa: entrambi i moduli caricano in un unico processo versioni diverse di System.Text.Json, e vince il modulo caricato per primo.
  • Una discussione di marzo 2026 ha aggirato il problema con un nuovo ambiente di runtime PowerShell 7.4 e ExchangeOnlineManagement 3.5.0, ma l'autore della domanda non aveva ancora testato lo script reale.
  • Microsoft Learn indica che ExchangeOnlineManagement 3.10.0 o successive richiedono PowerShell 7.6, mentre la sua pagina sui runtime di Automation elenca 5.1 e 7.4. Fissa la versione del modulo e testa nel riquadro Test prima di pubblicare.

È la discussione di Microsoft Q&A di marzo 2026 da cui parte questo articolo. Corrisponde a una discussione più vecchia su Tech Community del 2024, che aveva raggiunto una soluzione confermata dal suo autore. Questo articolo spiega la causa, mostra cosa dice Microsoft Learn su versioni e runtime, e propone un piano di test. È una guida alla risoluzione dei problemi, non una procedura ufficiale Microsoft.

Sintomi

L'autore della domanda di marzo 2026 usava una identità gestita assegnata dal sistema, Connect-ExchangeOnline -ManagedIdentity -Organization <tenant>.onmicrosoft.com seguito da Connect-MgGraph -Identity. Erano importati il modulo ExchangeOnlineManagement versione 3.9.2 e diversi moduli Microsoft.Graph. Gli errori erano:

  • Runtime 5.1: Connect-MgGraph è stato trovato nel modulo Microsoft.Graph.Authentication, ma il modulo non poteva essere caricato.
  • Runtime 7.2: Unable to find type [Microsoft.Exchange.Management.RestApiClient.ExchangeEnvironment].

La discussione del 2024, su un desktop con Windows PowerShell 5.1, mostrava IDX12729: Unable to decode the header ... as Base64Url encoded string e un errore «method not found» che indicava System.Text.Json.Utf8JsonReader. Un altro utente in quella discussione ha visto Connect-MgGraph: Invalid JWT access token quando nella stessa sessione veniva usato Connect-IPPSSession.

Tutti questi sono errori di caricamento o di runtime. Non si tratta di Authorization_RequestDenied né di messaggi di accesso negato. La differenza conta, perché in un thread di marzo una risposta generata dall'IA ha suggerito di concedere Exchange.ManageAsApp e il ruolo Exchange Administrator. Sono prerequisiti reali, ma riguardano l'autorizzazione e non possono risolvere un modulo che non si carica.

Perché succede

Nel thread del 2024, una risposta di un membro della community (un Silver Contributor, non un dipendente Microsoft) è stata contrassegnata come soluzione. Diceva che entrambi i moduli caricano una propria copia di System.Text.Json.dll nello stesso processo PowerShell. Exchange Online 3.5.1 includeva la versione 8.0.x, mentre Microsoft.Graph.Authentication usava una versione 6.0.x. PowerShell mantiene una sola versione di un assembly per processo, quindi vince il modulo caricato per primo e il secondo può fallire.

L'autore della domanda in quel thread ha rimosso i moduli Graph prima della connessione, ha aggiornato entrambi i moduli e ha svuotato la cache MSAL. Nulla di tutto ciò ha funzionato. Dopo essere tornato a ExchangeOnlineManagement 3.4.0, l'autore ha scritto che il problema era risolto. Altri utenti hanno segnalato la stessa soluzione. Un altro utente ha segnalato un miglioramento con la 3.6.0, ma per lui Connect-IPPSSession basato su certificato continuava a fallire. Un utente ha riferito che impostare -LogLevel su Default invece di All ha risolto il problema nel suo test. Learn non menziona questa impostazione, quindi va considerata una segnalazione della community.

Un moderatore volontario (un MVP) nel thread del 2026 ha fornito una spiegazione simile. I moduli dipendono da binari aggiuntivi che non sono allineati tra i vari team, quindi può essere necessario combinare versioni di moduli e host PowerShell diversi.

Learn non descrive il conflitto su System.Text.Json. Nelle note di rilascio di ExchangeOnlineManagement 3.6.0 riporta però la voce "Added fix for compatibility issue with the Microsoft.Graph module", senza ulteriori dettagli.

Passo 1: stabilisci che tipo di errore hai

  1. Esegui ciascuna connessione da sola in un runbook di test. Se entrambe funzionano da sole, hai un conflitto, non un problema di autorizzazioni.
  2. Copia la prima riga dell'errore. Qualsiasi messaggio relativo al caricamento di un modulo, di un tipo o di un metodo indica un conflitto. Forbidden, Access denied o Authorization_RequestDenied indicano un problema di autorizzazioni.
  3. Per i problemi di autorizzazioni, segui la pagina di Learn sulle identità gestite per Exchange. Occorre assegnare all'identità l'autorizzazione API Exchange.ManageAsApp e un ruolo Entra come Exchange Administrator. La nota di Learn precisa che il ruolo Security Administrator non dispone delle autorizzazioni necessarie per queste attività.

Passo 2: verifica quale versione di assembly richiede ciascun modulo

Nel thread del 2024 si suggeriva di controllare la versione dell'assembly caricato in una sessione nuova, un modulo alla volta. Il riepilogo del thread non mostra il comando esatto. Il comando seguente è un controllo generico di .NET, non proviene da Learn né dal thread, quindi testalo su una macchina di prova. Importa un modulo, poi esegui:

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

Ripeti in una nuova sessione con l'altro modulo. Se le versioni sono diverse, hai il conflitto descritto in quel thread. Usa le stesse versioni dei moduli presenti nel runbook.

Passo 3: fissa le versioni in un ambiente di runtime separato

L'autore della domanda di marzo 2026 ha risolto il caso di test creando un nuovo ambiente di runtime. Il thread non riporta i passaggi, mentre la pagina di Learn sugli ambienti di runtime sì:

  1. Nel portale di Azure, apri l'account di Automation. In Panoramica, seleziona Prova l'esperienza Runtime Environment se non sei già in quella modalità.
  2. In Process Automation, seleziona Runtime Environments, quindi Crea.
  3. In Informazioni di base, inserisci un nome, scegli PowerShell come linguaggio e 7.4 come versione di runtime. Learn precisa che linguaggio e versione non possono essere modificati in seguito.
  4. In Pacchetti, il pacchetto Az viene aggiunto per impostazione predefinita. Usa Aggiungi dalla raccolta per aggiungere ExchangeOnlineManagement con una versione fissata e i moduli Microsoft.Graph che richiami. Il thread ha usato la 3.5.0 per Exchange Online.
  5. Seleziona Crea.
  6. Collega una copia del tuo runbook. In Runbook, selezionalo, quindi Aggiorna Runtime Environment.
  7. Apri il runbook, Modifica nel portale, scegli il nuovo ambiente, quindi Riquadro di test e Avvia. Pubblica solo se il test riesce.

Learn avverte che l'importazione di un pacchetto può richiedere diversi minuti, che puoi aggiungere fino a 10 pacchetti alla volta e che, nella nuova esperienza, il riquadro Moduli è sostituito dagli ambienti di runtime.

La versione da fissare dipende dal runtime:

  • Learn indica che ExchangeOnlineManagement 3.10.0 e successive richiedono PowerShell 7.6.0 o successivo, a causa delle dipendenze degli assembly di .NET 10. La sua pagina sui runtime cita 5.1 e 7.4 come opzioni. Un runtime 7.4 richiede quindi una versione precedente alla 3.10.0. Si tratta di una conclusione tratta da due pagine di Learn, non di un'affermazione contenuta in nessuna delle due: verifica che cosa offre il tuo account.
  • Learn elenca problemi per le versioni da 3.7.0 a 3.9.2 su Ubuntu 20.04 e 18.04, e indica la 3.9.2 come ultima versione per alcune piattaforme meno recenti. Queste note riguardano le piattaforme desktop, non Automation.
  • Il test riportato nel thread di marzo usava la 3.5.0 con la 7.4. L'autore della domanda ha aggiunto un commento in cui dice che lo script reale non è ancora stato testato, quindi per la 3.9.x con la 7.4 non esiste una risposta confermata.
  • Il runtime 5.1 non ha evitato il conflitto nel thread di marzo, che con la 3.9.2 è fallito anche su 5.1.

Testa almeno due combinazioni, ad esempio la versione di Exchange che hai fissato con i moduli Graph più recenti, e con una versione precedente di Graph. Learn avverte che le versioni in anteprima di PackageManagement o PowerShellGet possono causare problemi di connessione, quindi usa quelle rilasciate.

Passo 4: valuta la suddivisione del lavoro

Se nessuna combinazione funziona, evita di caricare entrambi i moduli nello stesso processo. Ad esempio, fai in modo che un runbook esegua la parte Exchange e un altro la parte Graph, avviando il secondo dal primo. Questo deriva dalla causa indicata nel thread del 2024. Nessuno dei due thread l'ha testato, quindi prima crea una piccola prova di concetto.

Verifica anche se Graph può sostituire i cmdlet di Exchange nel tuo script. La pagina di Learn su Exchange lo indica per quattro cmdlet dei gruppi di Microsoft 365, come New-UnifiedGroup, che secondo Learn non possono essere usati con l'identità gestita e per i quali consiglia Graph. Per gli altri compiti, non dare per scontato che Graph abbia un equivalente.

Verifica

  1. Nel riquadro di test, l'output del processo mostra entrambe le connessioni e un risultato per ciascun servizio.
  2. Esegui il runbook pubblicato tramite una pianificazione o un avvio manuale, e controlla i flussi del processo per eventuali avvisi sul caricamento degli assembly.
  3. Annota le versioni esatte dei moduli e il runtime. Un aggiornamento successivo nella raccolta può interrompere una configurazione funzionante. Fissare le versioni ti protegge solo finché non le modifichi.

Limiti

  • Il thread del 2024 è più vecchio del periodo di riferimento abituale e usava Windows PowerShell desktop. È incluso perché indica la causa e ha un esito confermato.
  • La soluzione del thread del 2026 è un primo test, non una correzione verificata per la produzione.
  • La pagina di Learn sull'identità gestita per Exchange cita ancora i runtime 5.1 e 7.1 (anteprima) durante l'aggiunta del modulo, il che non corrisponde alla pagina sugli ambienti di runtime. Per i runtime attuali usa la pagina sugli ambienti di runtime.
  • Learn non documenta il conflitto in sé. La causa proviene da un esperto della community.

Correlati

Fonti

Entities in this article

Azure Automation Exchange Online PowerShell Microsoft Graph PowerShell Managed identity

Related articles

RSS