Führen Sie ein Upgrade auf Version 15.14 durch, registrieren Sie die Graph-Anwendung und wechseln Sie Ihre Zeitschriftenquellen.
Microsoft beginnt damit, EWS für Exchange Online-Mandanten zu blockieren. Für ein Rollback ist dann eine vorübergehende Ausnahmegenehmigung von Microsoft erforderlich.
EWS wird dauerhaft entfernt. Die Abmeldung endet.
Exchange Server vor Ort ist von dieser Einstellung nicht betroffen.
Diese Anleitung wurde zuletzt am 17. September 2026 für GFI Archiver AI 15.14 überprüft.
Microsoft stellt die Exchange Web Services in Exchange Online ab dem 1. Oktober 2026 schrittweise ein und entfernt sie am 1. April 2027 vollständig. GFI Archiver AI 15.14 fügt Microsoft Graph als unterstützte Alternative zum Auslesen Ihres Journal-Postfachs hinzu. Es ändert sich lediglich die Methode zum Abrufen der Daten.
-Graph SuffixEine vorhandene EWS-Quelle wird niemals durch Bearbeiten konvertiert. Stattdessen fügen Sie eine neue Graph-Quelle hinzu. Beim Speichern wird die EWS-Quelle für dieselbe Journal-Mailbox und denselben Ordner automatisch deaktiviert, und auf der letzten Seite des Assistenten wird sie namentlich genannt. Behalten Sie diesen EWS-Eintrag so lange bei, bis Sie die Graph-Archivierung überprüft haben, und löschen Sie ihn anschließend. Jede Quelle entfernt eine Nachricht nach der Archivierung aus dem Journal-Postfach, sodass bei einer Konfiguration vor dem Upgrade, bei der beide Quellen aktiv sind, dieselbe Nachricht möglicherweise zweimal archiviert wird. Das Dashboard warnt vor diesem Problem.
Historische Archivdaten werden weder verschoben, neu indiziert noch erneut importiert. Bereits archivierte Daten werden nicht entfernt.
Führen Sie ein Upgrade durch, registrieren Sie die Anwendung, fügen Sie die Graph-Quelle hinzu und überprüfen Sie die Funktion. Das Abrufen der Ordnerstruktur kann später erfolgen.
Graph deaktivieren, EWS aktivieren. Der Rollback funktioniert so lange, wie EWS in Ihrem Mandanten noch funktioniert.
Gehen Sie diese Liste durch, bevor Sie das Installationsprogramm öffnen. Haken Sie die Punkte ab, sobald Sie sie überprüft haben.
Notieren Sie sich diese Angaben vor dem Upgrade. Sie benötigen sie, um denselben Quellcode über Graph erneut zu kompilieren und um das System sauber zurückzusetzen.
Und der Server oder Knoten, auf dem es läuft.
Die genaue SMTP-Adresse.
In der Regel „Inbox“. Verwenden Sie den englischen Namen, nicht die lokalisierte Bezeichnung.
Aktiv oder inaktiv – bevor Sie irgendetwas ändern.
Die aktuellen Einstellungen, falls Sie diese Funktion nutzen.
Führen Sie auf jedem Knoten, auf dem GFI Archiver AI oder der Abfragedienst ausgeführt werden kann, ein Upgrade durch, bevor Sie die Graph-Quelle aktivieren.
| Begriff | Was das hier bedeutet |
|---|---|
| EWS | Exchange Web Services. Die auslaufende Exchange-Schnittstelle, die GFI Archiver AI zum Lesen von Microsoft 365-E-Mails verwendet hat. |
| Microsoft Graph | Sein modernes, unterstütztes Nachfolgemodell. |
| Microsoft Entra ID | Das Identitätsportal von Microsoft, früher bekannt als Azure AD. Dort registrieren Sie die Anwendung. |
| Mieter-ID / Kunden-ID | Aus der Anwendung: die Verzeichnis-ID (Mandant) und die Anwendungs-ID (Client). |
| Client-Geheimnis | Das Passwort der Anwendung. Es wird nur einmal angezeigt, kopieren Sie es daher umgehend in einen sicheren Speicherort. |
| Zeitschriften-Postfach | Das Microsoft 365-Postfach, in das eine Kopie aller E-Mails gesendet wird, damit diese von GFI Archiver AI gespeichert werden können. |
Führen Sie die Schritte der Reihe nach aus. Es wird erst dann etwas gespeichert, wenn GFI Archiver AI die Verbindung erfolgreich getestet hat; ein fehlgeschlagener Test führt also niemals dazu, dass die Migration nur teilweise abgeschlossen ist.
Der Mailserver des Journals wird möglicherweise so lange als deaktiviert angezeigt, bis die Schema-Aktualisierung abgeschlossen ist. Unter „Weitere Details“ finden Sie Informationen zur Microsoft-Anmeldevariante des Bulk Schema Upgraders sowie Hinweise dazu, was zu tun ist, wenn die Aktualisierung übersprungen wurde oder fehlgeschlagen ist.
Die einfachste unterstützte Option ist das mit GFI Archiver AI mitgelieferte Skript zur Anwendungsregistrierung. Ein Skript reicht aus: New-GfiArchiverGraphApp.ps1 für eine neue Anwendung oder Update-GfiArchiverAzureAdAppForGraph.ps1 anstelle eines bereits vorhandenen.
New-GfiArchiverGraphApp.ps1..\New-GfiArchiverGraphApp.ps1 -TenantId "<tenant-id>"Sie können das Skript von jedem Windows-Computer mit Internetzugang aus ausführen; es muss nicht auf dem GFI Archiver AI-Server ausgeführt werden. Es installiert die erforderlichen Microsoft Graph PowerShell-Module, falls diese fehlen, und fordert Sie anschließend zur Anmeldung mit dem Gerätecode sowie zur Zustimmung des Administrators auf. Führen Sie es einmal aus – bei jedem Ausführen wird ein neuer Client-Secret generiert.
Falls unter „Konfiguration › Azure AD“ bereits eine Anwendung für GFI Archiver AI konfiguriert ist, verwenden Sie diese erneut.
.\Update-GfiArchiverAzureAdAppForGraph.ps1 -AppId "<application-client-id>" -TenantId "<tenant-id>"Das Skript fügt die Graph-Berechtigungen hinzu, erteilt die Administratorzustimmung und behält die bestehenden EWS-Berechtigungen bei. Hinzufügen -CreateNewClientSecret nur, wenn Sie auch ein neues Passwort benötigen. Klicken Sie auf Weiter noch einmal; der Quellcode wird gespeichert, wenn der Test erfolgreich ist.
Mail.ReadWrite separat und überprüfen Sie dies mit Test-ServicePrincipalAuthorization.Lassen Sie für die Migration die Felder „Öffentliche Webhook-Basis-URL (optional) “ und „Lokale Listen-URL“ leer. GFI Archiver AI überprüft das Postfach dann alle 30 Sekunden, wobei keine eingehende Verbindung erforderlich ist. Aktivieren Sie Webhooks nur, wenn bereits ein externer HTTPS-Endpunkt und ein Reverse-Proxy vorhanden sind.
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.”
Der neue Eintrag erscheint in Konfiguration › E-Mail-Server mit der Endung -Graph, damit er sich vom EWS-Eintrag für dasselbe Postfach unterscheiden lässt.
Öffnen Sie „Konfiguration“ › „Mailserver“ und aktualisieren Sie die Seite. Der Eintrag „Graph“ ist aktiv, während der EWS-Eintrag für dasselbe Postfach inaktiv ist – GFI Archiver AI hat ihn beim Speichern der Graph-Quelle deaktiviert. Behalten Sie den EWS-Eintrag so lange bei, bis Ihr Beobachtungszeitraum abgelaufen ist; löschen Sie ihn noch nicht.
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.
Wenn mehrere Journal-Postfächer oder Ordner konfiguriert sind, fügen Sie für jedes davon das entsprechende Graph-Element hinzu. Bei jedem Speichern wird das zugehörige EWS-Element deaktiviert.
Öffnen Sie „Konfiguration“ › „Abruf der Ordnerstruktur“ und klicken Sie auf „Einstellungen ändern“ – oder aktivieren Sie „Abruf der Ordnerstruktur“, falls die Funktion deaktiviert ist. Wählen Sie „Microsoft 365 / Microsoft Graph“ aus, aktivieren Sie das Kontrollkästchen „Vorhandene Azure AD/OAuth-Konfiguration verwenden“ oder geben Sie die Anmeldedaten der Anwendung ein und klicken Sie auf „Weiter“. GFI Archiver AI testet die Verbindung und speichert die Einstellungen, wenn der Test erfolgreich ist. Um die gespeicherten Einstellungen später zu testen, verwenden Sie die Option „Verbindung testen“ auf der Seite „Abruf der Ordnerstruktur“.
Solange Sie diese Einstellung nicht ändern, ruft die Funktion „Folder Structure Retrieval“ weiterhin Ordner über EWS ab, während der Graph-Mail-Server archiviert. Ändern Sie diese Einstellung, bevor Microsoft EWS für Ihren Mandanten deaktiviert.
Beide Skripte gewähren genau diese drei Berechtigungen. Verwenden Sie „Anwendungsberechtigungen“, niemals „Delegierte Berechtigungen“, und erteilen Sie nach dem Hinzufügen die Administratorzustimmung.
| Genehmigung | Zweck | Für die Archivierung erforderlich |
|---|---|---|
Mail.ReadWrite | Journalmeldungen abrufen und verarbeiten. | Erforderlich |
User.Read.All | Benutzer und Postfächer für die Abrufung der Ordnerstruktur suchen. Wird standardmäßig durch das Registrierungsskript gewährt. | Ordnerstruktur |
Application.Read.All | Das Dashboard gibt eine Warnung aus, bevor das Client-Geheimnis abläuft. Wird von beiden Skripten bereitgestellt. | Nicht erforderlich |
Die Funktion „Ordnerstruktur abrufen“ akzeptiert auch Alternativen, die Sie möglicherweise bereits haben: Directory.Read.All anstelle von User.Read.All, und Mail.Read anstelle von Mail.ReadWrite. Wenn für die Anwendung bereits eine Alternative gewährt wurde, funktioniert die Abfrage der Ordnerstruktur, und Sie müssen die in der Tabelle genannte Berechtigung nicht hinzufügen.
Speichern Sie das generierte Client-Geheimnis unverzüglich in einem sicheren Passwort-Speicher. Geben Sie es niemals per E-Mail oder in einem Support-Ticket weiter.
Das Rollback erfolgt in zwei Schritten, wobei die Reihenfolge entscheidend ist. Es wird nichts automatisch aktiviert.
Wählen Sie unter „Konfiguration“ › „Mail-Server “ die Quelle „Graph“ aus und klicken Sie auf „Deaktivieren“.
Wählen Sie die EWS-Quelle aus und klicken Sie auf „Aktivieren“. Stellen Sie sicher, dass die Archivierung über EWS fortgesetzt wird, während Sie die Graph-Protokolle untersuchen, und lassen Sie die Graph-Konfiguration während der Fehlerbehebung unverändert.
“‘<EWS source>’ cannot be activated because the Microsoft Graph source ‘<Graph source>’ for the same mailbox and folder is active. Deactivate ‘<Graph source>’ first.”
Dies funktioniert nur, solange EWS in Ihrem Mandanten noch aktiv ist. Nachdem Microsoft am 1. Oktober 2026 mit der Deaktivierung von EWS beginnt, ist eine vorübergehende Ausnahmegenehmigung von Microsoft erforderlich, die am 1. April 2027 ausläuft. Es kann mehrere Stunden dauern, bis Änderungen an EWS auf Mandantenseite wirksam werden. Informationen zum Ausnahmegenehmigungsmechanismus finden Sie in der Ankündigung von Microsoft zu „EwsAllowedAppIds “.
Planen Sie dies bereits vor dem Wartungsfenster ein und nicht erst währenddessen.
Öffentliche Ordner können nicht über Microsoft Graph archiviert werden.
Es kann Postfächer über Graph importieren, Nachrichten jedoch nicht als exportiert kennzeichnen, sodass bei einer wiederholten Exportierung dieselben Nachrichten erneut exportiert werden können.
Es ist ein öffentlicher HTTPS-Endpunkt mit einem Zertifikat einer öffentlichen Zertifizierungsstelle erforderlich. Ohne dieses Zertifikat überprüft GFI Archiver AI das Postfach alle 30 Sekunden.
Probleme mit Graph werden ausschließlich in der Warnmeldung zum Client-Secret im Dashboard, in der Statusdatei und im Graph-Protokoll gemeldet.
Für die Registrierung der Anwendung und die Erteilung der Administratorberechtigung ist eine interaktive Anmeldung als Microsoft Entra-Administrator erforderlich, weshalb ein PowerShell-Skript verwendet wird.
Nachrichten, die archiviert wurden, während für dasselbe Postfach sowohl eine EWS- als auch eine Graph-Quelle aktiv waren, werden nicht dedupliziert. GFI Archiver AI gibt im Dashboard eine Warnung aus; der EWS-Eintrag wird dabei jedoch nicht automatisch gelöscht.
Suche nach Symptom, Fehlertext oder Dateinamen. Siebzehn dokumentierte Fälle.
Stellen Sie sicher, dass alle Knotenserver auf die erforderliche Version (15.14 oder höher) aktualisiert sind.
E-Mail-Server-Assistent: „Es fehlen Microsoft Graph-Anwendungsberechtigungen. Erforderliche Berechtigung: Mail.ReadWrite. Aktualisieren Sie die Azure AD-Anwendungsregistrierung und erteilen Sie die Administratorzustimmung.“
Wiederherstellung der Ordnerstruktur: „Es fehlen Microsoft Graph-Anwendungsberechtigungen. Erforderliche Berechtigungen: Mail.ReadWrite, User.Read.All. Aktualisieren Sie die Azure AD-Anwendungsregistrierung und erteilen Sie die Administratorzustimmung. Die Einrichtungsskripte erteilen außerdem die Berechtigung „Application.Read.All“ für Warnungen zum Ablauf des geheimen Schlüssels des Dashboard-Clients; diese Berechtigung ist für den Zugriff auf E-Mails nicht erforderlich.“
Bitte bestätigen Sie, dass Anwendung Berechtigungen (nicht delegiert) wurden zugewiesen und die Zustimmung des Administrators wurde erteilt. Beide Meldungen enthalten eine Skript zum Aktualisieren der Download-Berechtigungen herunterladen Link; Ausführen Update-GfiArchiverAzureAdAppForGraph.ps1 wie in Schritt 2 beschrieben.
Überprüfen Sie die Mandanten-ID, die Client-ID und den geheimen Schlüssel, einschließlich ihrer Gültigkeit und ihres Ablaufdatums.
Überprüfen Sie die SMTP-Adresse und verwenden Sie eindeutige Ordnernamen – Inbox anstatt eines lokalisierten Namens.
Überprüfen Sie den Aktivitätsstatus der Quelle, die Zeitschriftenrichtlinien und die Ausführungszeitstempel in snapshot.json. Sehen Sie sich das Grafikprotokoll unter …\GFI\Archiver\Core\DebugLogs\MArc.UMPolling.GraphPolling.log. Nachrichten, die sich bereits im Ordner „Gelöschte Objekte“ des Journal-Postfachs befanden, wurden archiviert.
Für dasselbe Postfach waren sowohl eine EWS-Quelle als auch eine Graph-Quelle aktiv, was nur bei einer vor dem Upgrade vorgenommenen Konfiguration möglich ist.
Dashboard Event Viewer: “EWS source <name> and Microsoft Graph source <name> are both active for <mailbox>. Deactivate the EWS source.”
Deaktivieren Sie die EWS-Quelle. Nachrichten, die archiviert wurden, während beide aktiv waren, werden nicht dedupliziert.
Stellen Sie sicher, dass User.Read.All oder Directory.Read.All Die Berechtigungen für die App wurden erteilt.
Löschen Sie die optionalen Webhook-Felder, um wieder zur Abfrage alle 30 Sekunden zurückzukehren. Wenn nur eines der beiden Felder ausgefüllt ist, zeigt der Assistent folgende Meldung an: „Geben Sie eine lokale Listen-URL ein, wenn eine öffentliche Webhook-URL festgelegt ist.“
Wiederholung Update-GfiArchiverAzureAdAppForGraph.ps1 mit -CreateNewClientSecret und aktualisieren Sie die AI-Einstellungen des GFI Archivers.
Im Protokoll wird der Fehler 1921 angezeigt: „MARCore konnte nicht beendet werden“. Vor dem Start des Installationsprogramms stand ein Neustart noch aus. Starten Sie den Server neu und führen Sie das Installationsprogramm erneut aus.
Unter „Konfiguration“ › „Azure AD“ ist keine Anwendung gespeichert. Konfigurieren Sie diese dort zunächst, oder deaktivieren Sie das Kontrollkästchen und geben Sie die Mandanten-ID, die Client-ID und den Client-Schlüssel manuell ein.
Application.Read.All fehlt, oder das Geheimnis ist falsch oder abgelaufen, oder Microsoft Graph ist nicht erreichbar. Lesen Sie snapshot.json und anhand des Graph-Protokolls lässt sich feststellen, um welche es sich handelt.
Siehe „Upgrade auf 15.14 “ weiter unten sowie den Knowledge Base-Artikel 105532.
Die Graph-Quelle verschiebt jede Nachricht nach der Archivierung in den Ordner „Gelöschte Objekte“. Suchen Sie im Archiv nach der Nachricht.
Pro Postfachordner kann nur eine Journalquelle aktiv sein. Um wieder zu EWS zu wechseln, deaktivieren Sie zunächst die Graph-Quelle und aktivieren Sie anschließend die EWS-Quelle. Siehe „Rollback“.
Auf der letzten Seite heißt es: „Wurde deaktiviert. Löschen Sie ihn…“. Eine Graph-Quelle für dasselbe Postfach und denselben Ordner ist aktiv, daher wurde der EWS-Eintrag als inaktiv gespeichert. Auf der letzten Seite wird der Wortlaut zur Migration erneut verwendet: Der dort genannte Eintrag ist der soeben gespeicherte, und er muss nicht gelöscht werden. Um stattdessen über EWS zu archivieren, deaktivieren Sie die Graph-Quelle und aktivieren Sie anschließend den EWS-Eintrag.
GFI Archiver AI schreibt keine Windows-Ereignisse und versendet keine E-Mails, wenn die Graph-Quelle nicht mehr funktioniert. Unter „Status und Protokolle“ erfahren Sie genau, was angezeigt wird und wo Sie nachsehen müssen.
Die Protokolldateien zum Graph-Status und zu den Snapshots werden lokal auf jedem Knoten gespeichert. Die Statusdatei enthält keine vertraulichen Informationen.
| Was | Wo |
|---|---|
| Verzeichnis der Bundesländer | %ProgramData%\GFI\Archiver\GraphPolling\state |
| Zusammenfassung zum Gesundheitszustand | %ProgramData%\GFI\Archiver\GraphPolling\state\health\snapshot.json |
| Diagrammprotokoll | …\GFI\Archiver\Core\DebugLogs\MArc.UMPolling.GraphPolling.log |
| EWS-Journal-Quellprotokolle | „EWSProvider.log“ und „DSScheduler.log“ in …\Core\DebugLogs |
| Abruf der Ordnerstruktur über EWS | UMPoll.EWSPoll.log (Prozess MArc.UMPolling.EWSPolling.exe) |
Führen Sie das GFI MA Debug Logs Tool aus. Es erfasst die Statusdatei als GraphPollingHealth.zip zusammen mit dem Graph-Protokoll und dem Bulk Schema Upgrader-Protokoll.
Der Graph-Poller ist MArc.UMPolling.GraphPolling.exe, der vom GFI Archiver Core-Dienst gestartet wird. Standardmäßig führt er alle 30 Sekunden eine Abfrage durch.
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.
Drei Dinge, die man vor dem Wartungsfenster lesen sollte, auch wenn man sie nicht aufruft.
Bei einer GFI Archiver AI EWS-Quelle gilt Folgendes, sobald EWS für Ihren Mandanten oder für das Journal-Postfach deaktiviert wurde:
Während dieser Zeit gehen weiterhin Nachrichten im Journal-Postfach ein und werden archiviert, sobald die Graph-Quelle gestartet wird.
Mit Version 15.14 wird das Schema der Archivspeicher-Datenbank aktualisiert. Am Ende der Installation fordert der „Bulk Schema Upgrader“ dazu auf, jeden Speicher zu aktualisieren. Ein Speicher wird erst dann für die Archivierung verwendet, wenn sein Schema aktualisiert wurde; bis dahin wird der Journal-Mail-Server möglicherweise als deaktiviert angezeigt.
Das Tool fordert die Anmeldedaten eines GFI Archiver AI-Administrators an. Geben Sie das Microsoft-Konto des Administrators (Benutzerprinzipalnamen) als Benutzernamen und ein Microsoft Graph-Zugriffstoken für dieses Konto als Passwort ein: Öffnen Sie den Microsoft Graph Explorer, melden Sie sich mit diesem Konto an und kopieren Sie den Wert auf der Registerkarte „Zugriffstoken “. Es ist etwa eine Stunde lang gültig. Wählen Sie die Speicher aus und klicken Sie auf „Upgrade“. Wenn das Tool meldet, dass die Anmeldedaten für einen Speicher nicht akzeptiert wurden, geben Sie bei der zweiten Aufforderung die SQL Server-Anmeldedaten dieses Speichers ein. Ein Windows-Konto kann hier nicht verwendet werden, und der Schritt „Administratorrolle gewähren“ aus KB 105532 gilt nicht für Installationen mit Microsoft-Anmeldung.
Führen Sie …\GFI\Archiver\BulkSchemaUpgrader\BulkSchemaUpgrader.exe aus oder öffnen Sie „Konfiguration“ › „Archivspeicher“, wählen Sie den für die Aktualisierung markierten Speicher aus, klicken Sie auf „Bearbeiten“, geben Sie die Anmeldedaten für die Datenbank erneut ein und schließen Sie den Assistenten ab. Aktivieren Sie anschließend alle deaktivierten Mailserver erneut. Protokoll: …\GFI\Archiver\BulkSchemaUpgrader\DebugLogs\GFIMailArchiverBulkSchemaUpgrader.log.
Windows Server 2022 und spätere Versionen enthalten diese Funktion bereits; bei früheren Versionen muss sie zunächst installiert werden. Eine unbeaufsichtigte (/qn) Das Upgrade wird ebenfalls blockiert, wenn es fehlt.
GFI Archiver AI schreibt kein Windows-Ereignis und versendet keine E-Mail, wenn die Graph-Quelle nicht mehr funktioniert. Folgendes wird angezeigt:
status, lastGraphHttpStatusSummary und lastJournalLocationErrorByDataSource den letzten Fehler anzeigen; lastJournalRunUtcByDataSource hält an. Weitere Felder: lastSuccessfulDeltaCheckpointByWorker, webhookListenerStatus.Laden Sie GFI Archiver AI 15.14 aus dem Upgrade-Center herunter und führen Sie anschließend die oben genannten fünf Schritte durch. Der Support und Ihr GFI-Partner können Ihnen bei der Planung des Wartungsfensters behilflich sein.