Passez à la version 15.14, enregistrez l'application Graph et modifiez vos sources de revues.
Microsoft commence à bloquer le protocole EWS pour les locataires Exchange Online. Pour revenir en arrière, il faut alors obtenir une dérogation temporaire de la part de Microsoft.
Le service EWS est définitivement désactivé. La période de désinscription prend fin.
Exchange Server sur site n' est pas concerné par cette fin de prise en charge.
Dernière mise à jour de ce guide : 17 septembre 2026 pour GFI Archiver AI 15.14.
Microsoft va supprimer progressivement les services Web Exchange dans Exchange Online à partir du 1er octobre 2026, pour les retirer définitivement le 1er avril 2027. GFI Archiver AI 15.14 intègre désormais Microsoft Graph comme solution de remplacement prise en charge pour la lecture de votre boîte aux lettres de journal. Seule la méthode de récupération change.
-Graph suffixeUne source EWS existante n’est jamais convertie par modification directe. Vous devez plutôt ajouter une nouvelle source Graph. Lorsque vous l’enregistrez, la source EWS correspondant à la même boîte aux lettres de journal et au même dossier est automatiquement désactivée, et la dernière page de l’assistant l’identifie par son nom. Conservez cette entrée EWS jusqu’à ce que vous ayez vérifié l’archivage Graph, puis supprimez-la. Chaque source supprime un message de la boîte aux lettres de journalisation après l’avoir archivé ; ainsi, une configuration antérieure à la mise à niveau où les deux sont actives peut archiver deux fois le même message. Le tableau de bord vous en avertit.
Les données d'archives historiques ne sont ni déplacées, ni réindexées, ni réimportées. Aucun élément déjà archivé n'est supprimé.
Effectuez la mise à jour, enregistrez l'application, ajoutez la source Graph et vérifiez. La récupération de la structure des dossiers pourra se faire ultérieurement.
Désactivez Graph, activez EWS. La restauration fonctionne tant qu'EWS fonctionne encore dans votre tenant.
Passez en revue cette liste avant de lancer le programme d'installation. Cochez les éléments au fur et à mesure que vous les vérifiez.
Notez ces informations avant de procéder à la mise à jour. Vous en aurez besoin pour recompiler la même source via Graph et pour revenir en arrière sans problème.
Et le serveur ou le nœud sur lequel il s'exécute.
L'adresse SMTP exacte.
En général, « Inbox ». Utilisez le nom anglais, et non la version localisée.
Qu'il soit actif ou inactif, avant de modifier quoi que ce soit.
Ses paramètres actuels, si vous utilisez cette fonctionnalité.
Mettez à jour tous les nœuds capables d'exécuter GFI Archiver AI ou le service d'interrogation avant d'activer la source Graph.
| Terme | Ce que cela signifie ici |
|---|---|
| EWS | Exchange Web Services. L'interface Exchange, désormais obsolète, que GFI Archiver AI utilisait pour lire les e-mails Microsoft 365. |
| Microsoft Graph | Sa version moderne et prise en charge. |
| Microsoft Entra ID | Le portail d'identité de Microsoft, anciennement Azure AD. C'est là que vous enregistrez l'application. |
| Numéro d'identification du locataire / Numéro d'identification du client | Issus de l'application : l'identifiant du répertoire (locataire) et l'identifiant de l'application (client). |
| Clé secrète du client | Le mot de passe de l'application. Il ne s'affiche qu'une seule fois ; veillez donc à le copier immédiatement dans un emplacement sécurisé. |
| Boîte aux lettres du journal | La boîte aux lettres Microsoft 365 qui reçoit une copie de tous les e-mails destinés à être archivés par GFI Archiver AI. |
Suivez-les dans l'ordre. Aucune donnée n'est enregistrée tant que GFI Archiver AI n'a pas vérifié avec succès la connexion ; ainsi, un test infructueux ne vous laissera jamais avec une migration inachevée.
Le serveur de messagerie du journal peut apparaître comme désactivé jusqu'à ce que la mise à niveau du schéma soit terminée. Consultez la section « Détails supplémentaires » pour en savoir plus sur la variante de connexion Microsoft de l'outil « Bulk Schema Upgrader » et sur la marche à suivre si la mise à niveau a été ignorée ou a échoué.
L'option la plus simple prise en charge est le script d'enregistrement de l'application fourni avec GFI Archiver AI. Un seul script suffit : New-GfiArchiverGraphApp.ps1 pour une nouvelle demande, ou Update-GfiArchiverAzureAdAppForGraph.ps1 à la place d'un élément existant.
New-GfiArchiverGraphApp.ps1..\New-GfiArchiverGraphApp.ps1 -TenantId "<tenant-id>"Vous pouvez exécuter le script depuis n'importe quel ordinateur Windows disposant d'un accès à Internet ; il n'est pas nécessaire de l'exécuter sur le serveur GFI Archiver AI. Il installe les modules PowerShell Microsoft Graph requis s'ils sont manquants, puis vous invite à vous connecter à l'aide du code de l'appareil et à donner votre accord en tant qu'administrateur. Exécutez-le une seule fois: chaque exécution génère un nouveau secret client.
Si GFI Archiver AI dispose déjà d'une application configurée sous Configuration › Azure AD, réutilisez-la.
.\Update-GfiArchiverAzureAdAppForGraph.ps1 -AppId "<application-client-id>" -TenantId "<tenant-id>"Le script ajoute les autorisations « Graph », accorde le consentement d'administrateur et conserve les autorisations EWS existantes. Ajouter -CreateNewClientSecret uniquement si vous avez également besoin d'un nouveau mot de passe. Cliquez sur Suivant Encore une fois, le code source est enregistré lorsque le test réussit.
Mail.ReadWrite séparément, puis valider avec Test-ServicePrincipalAuthorization.Pour la migration, laissez les champs « URL de base du webhook public (facultatif) » et « URL d'écoute locale » vides. GFI Archiver AI vérifie alors la boîte aux lettres toutes les 30 secondes et aucune connexion entrante n'est nécessaire. N'activez les webhooks que si un point de terminaison HTTPS externe et un proxy inverse sont déjà en place.
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 nouvelle entrée apparaît dans Configuration › Serveurs de messagerie avec le suffixe -Graph, afin de pouvoir la distinguer de l'entrée EWS correspondant à cette même boîte aux lettres.
Ouvrez « Configuration » › « Serveurs de messagerie » et actualisez la page. L'entrée « Graph » est « Active » et l'entrée EWS correspondant à cette même boîte aux lettres est « Inactive »: GFI Archiver AI l'a désactivée lors de l'enregistrement de la source Graph. Conservez l'entrée EWS jusqu'à la fin de votre période d'observation ; ne la supprimez pas pour l'instant.
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.
Si plusieurs boîtes aux lettres ou dossiers de journal sont configurés, ajoutez leur équivalent dans Graph pour chacun d'entre eux. Chaque enregistrement désactive son équivalent EWS.
Ouvrez Configuration › Récupération de la structure des dossiers, puis cliquez sur Modifier les paramètres – ou sur Activer la récupération de la structure des dossiers si cette fonctionnalité est désactivée. Sélectionnez Microsoft 365 / Microsoft Graph, cochez « Utiliser la configuration Azure AD/OAuth existante » ou saisissez les identifiants de l’application, puis cliquez sur « Suivant ». GFI Archiver AI teste la connexion et enregistre les paramètres si le test aboutit. Pour tester ultérieurement les paramètres enregistrés, utilisez l’option « Tester la connexion » sur la page « Récupération de la structure des dossiers ».
Tant que vous n'avez pas désactivé cette option, la fonctionnalité « Récupération de la structure des dossiers » continue de récupérer les dossiers via EWS pendant que le serveur de messagerie Graph procède à l'archivage. Veillez à la désactiver avant que Microsoft ne désactive EWS pour votre locataire.
Ces deux scripts accordent précisément ces trois autorisations. Utilisez les autorisations « Application », jamais « Déléguées », et accordez le consentement administrateur après les avoir ajoutées.
| Autorisation | Objectif | Nécessaire à l'archivage |
|---|---|---|
Mail.ReadWrite | Récupérer et traiter les messages du journal. | Obligatoire |
User.Read.All | Rechercher des utilisateurs et des boîtes aux lettres pour la récupération de la structure des dossiers. Autorisation accordée par défaut par le script d'enregistrement. | Structure des dossiers |
Application.Read.All | Permet au tableau de bord d'afficher un avertissement avant l'expiration du secret client. Activé par les deux scripts. | Non obligatoire |
La fonction « Récupération de la structure des dossiers » prend également en charge les alternatives que vous avez peut-être déjà définies : Directory.Read.All à la place de User.Read.All, et Mail.Read à la place de Mail.ReadWrite. Si l'application dispose déjà d'une alternative accordée, la fonctionnalité « Récupération de la structure des dossiers » fonctionne et vous n'avez pas besoin d'ajouter l'autorisation mentionnée dans le tableau.
Enregistrez immédiatement le secret client généré dans un gestionnaire de mots de passe sécurisé. Ne le communiquez jamais par e-mail ni dans un ticket d'assistance.
La restauration s'effectue en deux étapes, et l'ordre dans lequel elles sont effectuées est important. Rien ne s'active automatiquement.
Sélectionnez la source « Graph » dans Configuration › Serveurs de messagerie, puis cliquez sur « Désactiver ».
Sélectionnez la source EWS, puis cliquez sur « Activer ». Vérifiez que l'archivage reprend via EWS pendant que vous examinez les journaux de Graph, et veillez à ne pas modifier la configuration de Graph pendant le dépannage.
“‘<EWS source>’ cannot be activated because the Microsoft Graph source ‘<Graph source>’ for the same mailbox and folder is active. Deactivate ‘<Graph source>’ first.”
Cette fonctionnalité ne fonctionne que tant que le service EWS est encore opérationnel dans votre tenant. Une fois que Microsoft aura commencé à désactiver EWS le 1er octobre 2026, une dérogation temporaire accordée par Microsoft sera nécessaire ; celle-ci prendra fin le 1er avril 2027. Les modifications apportées à EWS au niveau du tenant peuvent mettre plusieurs heures à prendre effet. Consultez l’annonce de Microsoft concernant « EwsAllowedAppIds » pour en savoir plus sur le mécanisme de dérogation.
Prévoyez ces opérations avant la fenêtre de maintenance plutôt que pendant celle-ci.
Les dossiers publics ne peuvent pas être archivés via Microsoft Graph.
Il peut importer des boîtes aux lettres via Graph, mais ne peut pas marquer les messages comme ayant été exportés ; par conséquent, si l'on répète l'exportation, les mêmes messages risquent d'être exportés à nouveau.
Il nécessite un point de terminaison HTTPS public doté d'un certificat émis par une autorité de certification publique. En l'absence d'un tel certificat, GFI Archiver AI vérifie la boîte aux lettres toutes les 30 secondes.
Les problèmes liés à Graph sont signalés uniquement dans l'avertissement concernant la clé secrète du client dans le Dashboard, dans le fichier d'état et dans le journal de Graph.
L'enregistrement de l'application et l'octroi de l'autorisation d'administrateur nécessitent une connexion interactive d'un administrateur Microsoft Entra ; c'est pourquoi on utilise un script PowerShell.
Les messages archivés alors qu'une source EWS et une source Graph étaient toutes deux actives pour la même boîte aux lettres ne sont pas dédupliqués. GFI Archiver AI affiche un avertissement sur le tableau de bord ; il ne supprime jamais l'entrée EWS à votre place.
Recherche par symptôme, message d'erreur ou nom de fichier. Dix-sept cas répertoriés.
Assurez-vous que tous les serveurs de nœuds ont bien été mis à niveau vers la version requise, à savoir la version 15.14 ou une version ultérieure.
Assistant du serveur de messagerie : « Les autorisations de l'application Microsoft Graph sont manquantes. Autorisation requise : Mail.ReadWrite. Mettez à jour l'enregistrement de l'application Azure AD et accordez le consentement d'administrateur. »
Récupération de la structure des dossiers : « Les autorisations de l'application Microsoft Graph sont manquantes. Autorisations requises : Mail.ReadWrite, User.Read.All. Mettez à jour l'enregistrement de l'application Azure AD et accordez le consentement administrateur. Les scripts d'installation accordent également l'autorisation Application.Read.All pour les avertissements d'expiration du secret client du tableau de bord ; cette autorisation n'est pas requise pour l'accès à la messagerie. »
Vérifiez que Demande des autorisations (non déléguées) ont été attribuées et que l'administrateur a donné son accord. Ces deux messages contiennent un Télécharger le script de mise à jour des autorisations lien ; exécuter Update-GfiArchiverAzureAdAppForGraph.ps1 comme indiqué à l'étape 2.
Vérifiez l'identifiant du locataire, l'identifiant client et la clé secrète client, notamment leur validité et leur date d'expiration.
Vérifiez l'adresse SMTP et utilisez une nomenclature explicite pour les dossiers – Inbox plutôt qu'un nom localisé.
Vérifiez le statut actif de la source, les règles de la revue et les horodatages d'exécution dans snapshot.json. Consultez le journal des graphiques à l'adresse …\GFI\Archiver\Core\DebugLogs\MArc.UMPolling.GraphPolling.log. Les messages qui se trouvaient déjà dans le dossier « Éléments supprimés » de la boîte aux lettres du journal ont été archivés.
Une source EWS et une source Graph étaient toutes deux actives pour la même boîte aux lettres, ce qui n'est possible que dans le cadre d'une configuration effectuée avant la mise à niveau.
Dashboard Event Viewer: “EWS source <name> and Microsoft Graph source <name> are both active for <mailbox>. Deactivate the EWS source.”
Désactivez la source EWS. Les messages archivés alors que les deux sources étaient actives ne sont pas dédupliqués.
Veiller à ce que User.Read.All ou Directory.Read.All les autorisations de l'application ont été accordées.
Videz les champs facultatifs relatifs au webhook pour revenir à une interrogation toutes les 30 secondes. Si un seul des deux champs est renseigné, l'assistant affiche le message suivant : « Saisissez une URL d'écoute locale lorsqu'une URL de webhook publique est définie. »
Rediffusion Update-GfiArchiverAzureAdAppForGraph.ps1 avec -CreateNewClientSecret et mettre à jour les paramètres de l'IA de GFI Archiver.
Le journal indique l'erreur 1921 : « Impossible d'arrêter MARCore ». Un redémarrage était en attente avant le lancement du programme d'installation. Redémarrez le serveur et relancez le programme d'installation.
Aucune application n'est enregistrée sous Configuration › Azure AD. Configurez-la d'abord à cet endroit, ou décochez la case et saisissez manuellement l'ID du locataire, l'ID du client et le secret du client.
Application.Read.All est manquant, ou bien le secret est incorrect ou a expiré, ou encore Microsoft Graph est inaccessible. Lire snapshot.json et le journal « Graph » pour savoir lequel.
Reportez-vous à la section « Mise à niveau vers la version 15.14 » ci-dessous, ainsi qu'à l'article de la base de connaissances n° 105532.
La source Graph déplace chaque message vers le dossier « Éléments supprimés » après l'avoir archivé. Recherchez le message dans les archives.
Une seule source de journal par dossier de boîte aux lettres peut être active. Pour revenir à EWS, désactivez d'abord la source Graph, puis activez la source EWS. Voir « Rétrocession ».
La dernière page indique qu’elle « a été désactivée. Supprimez-la… ». Une source Graph correspondant à cette même boîte aux lettres et à ce même dossier est active ; l’entrée EWS a donc été enregistrée comme inactive. La dernière page reprend la formulation utilisée pour la migration : l’entrée qu’elle mentionne est celle qui vient d’être enregistrée, et il n’est pas nécessaire de la supprimer. Pour archiver via EWS à la place, désactivez la source Graph, puis activez l’entrée EWS.
GFI Archiver AI n'enregistre aucun événement Windows et n'envoie aucun e-mail lorsque la source Graph cesse de fonctionner. Consultez la section « État et journaux » pour savoir exactement ce que vous verrez et où chercher.
Les journaux d'état du graphe et d'intégrité des instantanés sont stockés localement sur chaque nœud. Le fichier d'intégrité ne contient aucune information confidentielle.
| Quoi ? | Où |
|---|---|
| Annuaire des départements | %ProgramData%\GFI\Archiver\GraphPolling\state |
| Bilan de santé | %ProgramData%\GFI\Archiver\GraphPolling\state\health\snapshot.json |
| Journal des graphiques | …\GFI\Archiver\Core\DebugLogs\MArc.UMPolling.GraphPolling.log |
| Journaux source du système EWS | EWSProvider.log et DSScheduler.log dans …\Core\DebugLogs |
| Récupération de la structure des dossiers via EWS | UMPoll.EWSPoll.log (processus MArc.UMPolling.EWSPolling.exe) |
Lancez l'outil « GFI MA Debug Logs ». Il récupère le fichier d'état sous la forme GraphPollingHealth.zip ainsi que le journal Graph et le journal de l'outil de mise à niveau en masse des schémas.
Le collecteur de données Graph est MArc.UMPolling.GraphPolling.exe, lancé par le service GFI Archiver Core. Il effectue une interrogation toutes les 30 secondes par défaut.
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.
Trois articles à lire avant la fenêtre de maintenance, même si vous ne les consultez pas.
Pour une source GFI Archiver AI EWS, une fois que le service EWS a été désactivé pour votre locataire ou pour la boîte aux lettres de journalisation :
Pendant ce laps de temps, les messages continuent d'arriver dans la boîte aux lettres du journal et sont archivés dès le démarrage de la source Graph.
La version 15.14 met à jour le schéma de la base de données « archive-store ». À la fin de l'installation, l'outil « Bulk Schema Upgrader » vous invite à mettre à jour chaque « store ». Un « store » ne peut pas être utilisé pour l'archivage tant que son schéma n'a pas été mis à jour ; jusqu'à ce moment-là, le serveur de messagerie du journal peut apparaître comme désactivé.
L'outil vous demande les identifiants d'un administrateur de GFI Archiver AI. Saisissez le compte Microsoft de l'administrateur (nom principal d'utilisateur) comme nom d'utilisateur, et un jeton d'accès Microsoft Graph pour ce compte comme mot de passe : ouvrez Microsoft Graph Explorer, connectez-vous avec ce compte et copiez la valeur figurant dans l'onglet « Jeton d'accès ». Ce jeton est valable pendant environ une heure. Sélectionnez les magasins et cliquez sur « Mettre à niveau ». Si l'outil signale que les identifiants n'ont pas été acceptés pour un magasin, saisissez les identifiants SQL Server de ce magasin à la deuxième invite. Un compte Windows ne peut pas être utilisé ici, et l'étape « Attribuer le rôle d'administrateur » de l'article KB 105532 ne s'applique pas aux installations avec connexion Microsoft.
Exécutez …\GFI\Archiver\BulkSchemaUpgrader\BulkSchemaUpgrader.exe, ou ouvrez Configuration › Stockages d’archives, sélectionnez le stockage à mettre à niveau, cliquez sur Modifier, saisissez à nouveau les identifiants de la base de données et suivez les étapes de l’assistant jusqu’au bout. Réactivez ensuite tout serveur de messagerie désactivé. Journal : …\GFI\Archiver\BulkSchemaUpgrader\DebugLogs\GFIMailArchiverBulkSchemaUpgrader.log.
Windows Server 2022 et les versions ultérieures l'intègrent ; sur les versions antérieures, il faut d'abord l'installer. Une installation en mode silencieux (/qn) La mise à jour est également bloquée lorsqu'il manque.
GFI Archiver AI n'enregistre pas d'événement Windows et n'envoie pas d'e-mail lorsque la source Graph cesse de fonctionner. Voici ce que vous constaterez :
status, lastGraphHttpStatusSummary et lastJournalLocationErrorByDataSource afficher la dernière erreur ; lastJournalRunUtcByDataSource cesse d'avancer. Autres domaines : lastSuccessfulDeltaCheckpointByWorker, webhookListenerStatus.Téléchargez GFI Archiver AI 15.14 depuis le Centre de mise à jour, puis suivez les cinq étapes décrites ci-dessus. Le service d'assistance et votre partenaire GFI peuvent vous aider à planifier la fenêtre de maintenance.