Esegui l'aggiornamento alla versione 15.14, registra l'applicazione Graph e modifica le fonti delle tue riviste.
Microsoft inizia a bloccare EWS per i tenant di Exchange Online. Per tornare alla configurazione precedente è necessario ottenere da Microsoft un’autorizzazione temporanea all’esclusione.
L'EWS viene rimosso definitivamente. L'opt-out termina.
Exchange Server on-premises non è interessato da questa dismissione.
Guida aggiornata l'ultima volta il 17 settembre 2026 per GFI Archiver AI 15.14.
Microsoft dismetterà gradualmente Exchange Web Services in Exchange Online a partire dal 1° ottobre 2026 e lo rimuoverà definitivamente il 1° aprile 2027. GFI Archiver AI 15.14 aggiunge Microsoft Graph come alternativa supportata per la lettura della casella di posta del journal. Cambia solo il metodo di recupero.
-Graph suffissoUna fonte EWS esistente non viene mai convertita modificandola. Si aggiunge invece una nuova fonte Graph. Quando la si salva, la fonte EWS relativa alla stessa casella di posta e alla stessa cartella del journal viene disattivata automaticamente e l’ultima pagina della procedura guidata ne riporta il nome. Conservare quella voce EWS fino a quando non si è verificata l’archiviazione tramite Graph, quindi eliminarla. Ogni sorgente rimuove un messaggio dalla casella di posta del journal dopo averlo archiviato; pertanto, una configurazione precedente all’aggiornamento in cui entrambe sono attive può archiviare lo stesso messaggio due volte. La Dashboard avvisa di questa situazione.
I dati dell'archivio storico non vengono spostati, reindicizzati né reimportati. Nulla di quanto sia già stato archiviato viene rimosso.
Eseguire l'aggiornamento, registrare l'applicazione, aggiungere la fonte Graph e verificare. Il recupero della struttura delle cartelle può avvenire in un secondo momento.
Disattiva Graph, attiva EWS. Il rollback funziona finché EWS continua a funzionare nel tuo tenant.
Controlla questa lista prima di aprire il programma di installazione. Spunta le voci man mano che le verifichi.
Prendi nota di questi dati prima di eseguire l'aggiornamento. Ti serviranno per ricompilare lo stesso codice sorgente tramite Graph e per ripristinare correttamente la versione precedente.
E il server o il nodo su cui è in esecuzione.
L'indirizzo SMTP esatto.
Di solito nella Posta in arrivo. Usa il nome in inglese, non quello localizzato.
Attivo o inattivo, prima di apportare qualsiasi modifica.
Le impostazioni attuali, se si utilizza questa funzione.
Eseguire l'aggiornamento di tutti i nodi in grado di eseguire GFI Archiver AI o il servizio di polling prima di attivare la fonte Graph.
| Termine | Cosa significa in questo contesto |
|---|---|
| EWS | Exchange Web Services. L'interfaccia Exchange ormai in disuso che GFI Archiver AI utilizzava per leggere la posta di Microsoft 365. |
| Microsoft Graph | La sua versione moderna e supportata. |
| Microsoft Entra ID | Il portale di gestione delle identità di Microsoft, precedentemente noto come Azure AD. È qui che si registra l'applicazione. |
| ID inquilino / ID cliente | Dall'applicazione: l'ID della directory (tenant) e l'ID dell'applicazione (client). |
| Codice segreto del cliente | La password dell'applicazione. Viene visualizzata una sola volta, quindi copiala subito in un archivio sicuro. |
| Casella di posta della rivista | La casella di posta di Microsoft 365 che riceve una copia di tutti i messaggi che GFI Archiver AI deve archiviare. |
Seguili in ordine. Nulla viene salvato finché GFI Archiver AI non ha verificato con successo la connessione, quindi un test fallito non ti lascerà mai con una migrazione incompleta.
Il server di posta del giornale potrebbe risultare disattivato fino al completamento dell'aggiornamento dello schema. Consulta la sezione " Dettagli aggiuntivi " per informazioni sulla variante di accesso Microsoft del Bulk Schema Upgrader e su cosa fare se l'aggiornamento è stato saltato o non è andato a buon fine.
L'opzione più semplice supportata è lo script di registrazione dell'applicazione fornito con GFI Archiver AI. È sufficiente un solo script: New-GfiArchiverGraphApp.ps1 per una nuova richiesta, oppure Update-GfiArchiverAzureAdAppForGraph.ps1 al posto di uno già esistente.
New-GfiArchiverGraphApp.ps1..\New-GfiArchiverGraphApp.ps1 -TenantId "<tenant-id>"È possibile eseguire lo script da qualsiasi computer Windows dotato di connessione a Internet; non è necessario che venga eseguito sul server GFI Archiver AI. Lo script installa i moduli PowerShell di Microsoft Graph necessari, qualora non fossero presenti, quindi richiede l'autenticazione tramite codice del dispositivo e il consenso dell'amministratore. Eseguirlo una sola volta: ogni esecuzione genera un nuovo segreto client.
Se in GFI Archiver AI è già presente un'applicazione configurata in Configurazione › Azure AD, riutilizzala.
.\Update-GfiArchiverAzureAdAppForGraph.ps1 -AppId "<application-client-id>" -TenantId "<tenant-id>"Lo script aggiunge le autorizzazioni Graph, concede il consenso dell'amministratore e mantiene le autorizzazioni EWS esistenti. Aggiungi -CreateNewClientSecret solo se hai bisogno anche di un nuovo segreto. Clicca su Avanti ancora una volta; la fonte viene salvata quando il test ha esito positivo.
Mail.ReadWrite separatamente, e verificare con Test-ServicePrincipalAuthorization.Per la migrazione, lasciare vuoti i campi " URL di base del webhook pubblico (facoltativo) " e "URL di ascolto locale ". GFI Archiver AI controllerà quindi la casella di posta ogni 30 secondi e non sarà necessaria alcuna connessione in entrata. Abilitare i webhook solo se sono già presenti un endpoint HTTPS esterno e un proxy inverso.
If an active EWS source reads the same journal mailbox and folder, GFI Archiver AI deactivates it and the last page says: “The EWS source ‘<name>’ for this mailbox was deactivated. Delete it once you have verified that Microsoft Graph archiving works.”
La nuova voce compare in Configurazione › Server di posta con il suffisso -Graph, in modo da poterlo distinguere dalla voce EWS relativa alla stessa casella di posta.
Apri Configurazione › Server di posta e aggiorna la pagina. La voce Graph risulta attiva, mentre quella EWS relativa alla stessa casella di posta è inattiva: GFI Archiver AI l’ha disattivata al momento del salvataggio della fonte Graph. Mantieni la voce EWS fino al termine del periodo di osservazione; non cancellarla ancora.
If the EWS entry is still Active, for example because both were active before the upgrade, the Dashboard Event Viewer shows: “EWS source <name> and Microsoft Graph source <name> are both active for <mailbox>. Deactivate the EWS source.” Select the EWS entry and click Deactivate.
Se sono configurate più caselle di posta o cartelle del giornale, aggiungere la corrispondente voce in Graph per ciascuna di esse. Ogni salvataggio disattiva la corrispondente voce in EWS.
Aprire Configurazione › Recupero struttura cartelle e fare clic su Modifica impostazioni – oppure su Abilita recupero struttura cartelle se la funzionalità è disabilitata. Selezionare Microsoft 365 / Microsoft Graph, spuntare la casella "Usa configurazione Azure AD/OAuth esistente " oppure inserire le credenziali dell'applicazione e fare clic su Avanti. GFI Archiver AI verifica la connessione e salva le impostazioni se il test ha esito positivo. Per verificare in un secondo momento le impostazioni salvate, utilizzare "Verifica connessione" nella pagina "Recupero struttura cartelle".
Finché non si attiva questa opzione, la funzione "Folder Structure Retrieval" continua a recuperare le cartelle tramite EWS mentre il server di posta Graph esegue l'archiviazione. Attivarla prima che Microsoft disabiliti EWS per il proprio tenant.
Entrambi gli script concedono esattamente questi tre permessi. Utilizza le autorizzazioni dell’applicazione, mai quelle delegate, e concedi il consenso dell’amministratore dopo averli aggiunti.
| Autorizzazione | Scopo | Necessario per l'archiviazione |
|---|---|---|
Mail.ReadWrite | Recuperare ed elaborare i messaggi di log. | Obbligatorio |
User.Read.All | Trova utenti e caselle di posta per il recupero della struttura delle cartelle. Concesso per impostazione predefinita dallo script di registrazione. | Struttura delle cartelle |
Application.Read.All | Consente alla Dashboard di inviare un avviso prima della scadenza del segreto client. Funzionalità supportata da entrambi gli script. | Non richiesto |
La funzione "Recupero struttura cartelle" accetta anche le alternative che potresti già avere: Directory.Read.All al posto di User.Read.All, e Mail.Read al posto di Mail.ReadWrite. Se alla domanda è già stata concessa un'alternativa, la funzione "Recupero della struttura delle cartelle" funziona e non è necessario aggiungere l'autorizzazione indicata nella tabella.
Salva immediatamente il segreto client generato in un archivio di password sicuro. Non condividerlo mai via e-mail o in un ticket di assistenza.
Il rollback si svolge in due fasi e l'ordine è importante. Nulla viene attivato automaticamente.
Selezionare la fonte Graph in Configurazione › Server di posta e fare clic su Disattiva.
Selezionare la fonte EWS e fare clic su Attiva. Verificare che l'archiviazione riprenda tramite EWS mentre si analizzano i log di Graph e mantenere inalterata la configurazione di Graph durante la risoluzione dei problemi.
“‘<EWS source>’ cannot be activated because the Microsoft Graph source ‘<Graph source>’ for the same mailbox and folder is active. Deactivate ‘<Graph source>’ first.”
Funziona solo finché EWS è ancora attivo nel proprio tenant. Dopo che Microsoft avrà iniziato a disattivare EWS il 1° ottobre 2026, sarà necessaria una deroga temporanea concessa da Microsoft, che scadrà il 1° aprile 2027. Le modifiche a EWS a livello di tenant possono richiedere diverse ore prima di diventare effettive. Per informazioni sul meccanismo di deroga, consultare l’annuncio di Microsoft relativo a EwsAllowedAppIds.
Organizzatevi in base a questi aspetti prima della finestra di manutenzione, piuttosto che durante la stessa.
Le cartelle pubbliche non possono essere archiviate tramite Microsoft Graph.
È in grado di importare le caselle di posta tramite Graph, ma non può contrassegnare i messaggi come esportati; pertanto, se si ripete l'esportazione, gli stessi messaggi potrebbero essere esportati nuovamente.
È necessario un endpoint HTTPS pubblico con un certificato rilasciato da un'autorità di certificazione pubblica. In assenza di tale certificato, GFI Archiver AI controlla la casella di posta ogni 30 secondi.
I problemi relativi a Graph vengono segnalati esclusivamente nell'avviso relativo al segreto client della Dashboard, nel file di integrità e nel log di Graph.
Per registrare l'applicazione e concedere l'autorizzazione di amministratore è necessario che un amministratore di Microsoft Entra effettui l'accesso in modalità interattiva; per questo motivo viene utilizzato uno script PowerShell.
I messaggi archiviati mentre erano attivi sia un EWS che una fonte Graph per la stessa casella di posta non vengono deduplicati. GFI Archiver AI visualizza un avviso sulla Dashboard, ma non elimina mai automaticamente la voce EWS.
Ricerca per sintomo, messaggio di errore o nome del file. Diciassette casi documentati.
Assicurarsi che tutti i server dei nodi siano aggiornati alla versione richiesta, 15.14 o successive.
Procedura guidata del server di posta: “Mancano le autorizzazioni dell'applicazione Microsoft Graph. Autorizzazione richiesta: Mail.ReadWrite. Aggiornare la registrazione dell'applicazione in Azure AD e concedere il consenso dell'amministratore.”
Recupero della struttura delle cartelle: “Mancano le autorizzazioni dell’applicazione Microsoft Graph. Autorizzazioni richieste: Mail.ReadWrite, User.Read.All. Aggiornare la registrazione dell’applicazione in Azure AD e concedere il consenso dell’amministratore. Gli script di configurazione concedono anche l’autorizzazione Application.Read.All per gli avvisi relativi alla scadenza del segreto client della dashboard; tale autorizzazione non è necessaria per l’accesso alla posta.”
Verificare che Applicazione sono state assegnate autorizzazioni (non delegate) ed è stato concesso il consenso dell'amministratore. Entrambi i messaggi includono un Scarica lo script di aggiornamento delle autorizzazioni link; esegui Update-GfiArchiverAzureAdAppForGraph.ps1 come descritto al punto 2.
Verificare l'ID tenant, l'ID cliente e il segreto cliente, compresa la validità e la data di scadenza.
Verifica l'indirizzo SMTP e utilizza nomi di cartelle espliciti – Inbox piuttosto che un nome localizzato.
Verificare lo stato di attività della fonte, le regole della rivista e i timestamp di esecuzione in snapshot.json. Controlla il registro dei grafici all'indirizzo …\GFI\Archiver\Core\DebugLogs\MArc.UMPolling.GraphPolling.log. I messaggi già presenti nella cartella "Elementi eliminati" della casella di posta del diario sono stati archiviati.
Per la stessa casella di posta erano attive sia una sorgente EWS che una sorgente Graph, cosa possibile solo con una configurazione effettuata prima dell'aggiornamento.
Dashboard Event Viewer: “EWS source <name> and Microsoft Graph source <name> are both active for <mailbox>. Deactivate the EWS source.”
Disattivare la fonte EWS. I messaggi archiviati mentre entrambe le fonti erano attive non vengono deduplicati.
Assicurarsi che User.Read.All oppure Directory.Read.All sono state concesse le autorizzazioni dell'applicazione.
Deselezionare i campi relativi ai webhook opzionali per tornare al polling ogni 30 secondi. Se è compilato solo uno dei due campi, la procedura guidata visualizza il messaggio: “Inserire un URL di ascolto locale quando è impostato un URL di webhook pubblico”.
Ripetizione Update-GfiArchiverAzureAdAppForGraph.ps1 con -CreateNewClientSecret e aggiornare le impostazioni dell'intelligenza artificiale di GFI Archiver.
Il log riporta l'errore 1921: "Impossibile arrestare MARCore". Prima dell'avvio del programma di installazione era in sospeso un riavvio. Riavviare il server ed eseguire nuovamente il programma di installazione.
Non è stata salvata alcuna applicazione in Configurazione › Azure AD. Configurala prima in quella sezione oppure deseleziona la casella e inserisci manualmente l'ID tenant, l'ID client e il segreto client.
Application.Read.All manca, oppure la chiave segreta è errata o scaduta, oppure Microsoft Graph non è raggiungibile. Leggi snapshot.json e il log di Graph per capire quale.
Vedere la sezione " Aggiornamento alla versione 15.14 " riportata di seguito e l'articolo della Knowledge Base n. 105532.
La fonte Graph sposta ogni messaggio nella cartella "Elementi eliminati" dopo averlo archiviato. Cerca il messaggio nell'archivio.
È possibile avere attiva una sola fonte di registro per ogni cartella della casella di posta. Per tornare a EWS, disattivare prima la fonte Graph, quindi attivare la fonte EWS. Vedere " Rollback".
L'ultima pagina indica che “è stata disattivata. Eliminarla…”. Una fonte Graph relativa alla stessa casella di posta e alla stessa cartella è attiva, pertanto la voce EWS è stata salvata come inattiva. L'ultima pagina riprende la formulazione relativa alla migrazione: la voce a cui si riferisce è quella appena salvata e non è necessario eliminarla. Per eseguire l'archiviazione tramite EWS, disattivare la fonte Graph, quindi attivare la voce EWS.
GFI Archiver AI non registra alcun evento di Windows né invia alcuna e-mail quando la fonte Graph smette di funzionare. Consulta la sezione " Stato e registri " per sapere esattamente cosa vedrai e dove cercare.
I log relativi allo stato del grafico e all'integrità degli snapshot vengono memorizzati localmente su ciascun nodo. Il file di integrità non contiene alcuna informazione riservata.
| Cosa | Dove |
|---|---|
| Elenco degli Stati | %ProgramData%\GFI\Archiver\GraphPolling\state |
| Panoramica sulla salute | %ProgramData%\GFI\Archiver\GraphPolling\state\health\snapshot.json |
| Registro grafico | …\GFI\Archiver\Core\DebugLogs\MArc.UMPolling.GraphPolling.log |
| Log delle fonti della rivista EWS | EWSProvider.log e DSScheduler.log in …\Core\DebugLogs |
| Recupero della struttura delle cartelle tramite EWS | UMPoll.EWSPoll.log (processo MArc.UMPolling.EWSPolling.exe) |
Eseguire lo strumento GFI MA Debug Logs Tool. Esso raccoglie il file di integrità come GraphPollingHealth.zip insieme al log di Graph e al log di Bulk Schema Upgrader.
Il poller di Graph è MArc.UMPolling.GraphPolling.exe, avviato dal servizio GFI Archiver Core. Per impostazione predefinita, esegue un polling ogni 30 secondi.
Both scripts can also be downloaded without going through a wizard: https://<GFI Archiver server>/Archiver/GraphScriptDownload.aspx?script=update for the permissions update script, and …?script=new for the application registration script.
Tre cose che vale la pena leggere prima della finestra di manutenzione, anche se non le consultate.
Per una sorgente EWS di GFI Archiver AI, una volta disabilitato l'EWS per il proprio tenant o per la casella di posta del journal:
Durante questo periodo continuano ad arrivare messaggi nella casella di posta del diario, che vengono archiviati all'avvio della fonte Graph.
La versione 15.14 aggiorna lo schema del database di archiviazione. Al termine dell'installazione, il Bulk Schema Upgrader richiede di aggiornare ogni archivio. Un archivio non viene utilizzato per l'archiviazione finché il suo schema non viene aggiornato e, fino a quel momento, il server di posta del journal potrebbe risultare disattivato.
Lo strumento richiede le credenziali di un amministratore di GFI Archiver AI. Inserire l’account Microsoft dell’amministratore (nome principale utente) come nome utente e un token di accesso a Microsoft Graph relativo a quell’account come password: aprire Microsoft Graph Explorer, accedere con quell’account e copiare il valore presente nella scheda “Token di accesso ”. È valido per circa un’ora. Selezionare gli archivi e fare clic su Aggiorna. Se lo strumento segnala che le credenziali non sono state accettate per un archivio, inserire le credenziali di SQL Server di quell’archivio alla seconda richiesta. In questo caso non è possibile utilizzare un account Windows e il passaggio “concedere il ruolo di amministratore” descritto nell’articolo KB 105532 non si applica alle installazioni con accesso Microsoft.
Eseguire …\GFI\Archiver\BulkSchemaUpgrader\BulkSchemaUpgrader.exe oppure aprire Configurazione › Archivi, selezionare l'archivio contrassegnato per l'aggiornamento, fare clic su Modifica, reinserire le credenziali del database e completare la procedura guidata. Quindi riattivare eventuali server di posta disattivati. Log: …\GFI\Archiver\BulkSchemaUpgrader\DebugLogs\GFIMailArchiverBulkSchemaUpgrader.log.
Windows Server 2022 e versioni successive lo includono già; nelle versioni precedenti è necessario installarlo prima. Un'installazione silenziosa (/qn) Anche l'aggiornamento viene bloccato se manca.
GFI Archiver AI non registra alcun evento di Windows né invia un'e-mail quando la fonte Graph smette di funzionare. Ecco cosa vedrai:
status, lastGraphHttpStatusSummary e lastJournalLocationErrorByDataSource mostra l'ultimo errore; lastJournalRunUtcByDataSource smette di avanzare. Altri campi: lastSuccessfulDeltaCheckpointByWorker, webhookListenerStatus.Scarica GFI Archiver AI 15.14 dall’Upgrade Center, quindi segui i cinque passaggi sopra indicati. Il servizio di assistenza e il tuo partner GFI possono aiutarti a pianificare la finestra di manutenzione.