Quelltext der Seite Umstellung der Archivierung von Microsoft Exchange Server auf Microsoft 365

In diesem Artikel wird die Umstellung der Archiverungsumgebung am Beispiel der bei einem Umstieg von einer lokalen Exchange-Umgebung zu Microsoft 365 in MailStore Server notwendigen Schritte beschrieben.
<p class="msnote" style="color:red">'''Warnung:''' Es wird dringend empfohlen, die in diesem Artikel beschriebenen Schritte zunächst in einer Testumgebung durchzuführen, da sie unter Umständen Änderungen an Ihren Exchange- und MailStore Server-Installationen vornehmen, die nicht oder nur sehr zeitaufwändig rückgängig gemacht werden können. Vor Anwendung der hier dargestellten Methoden ist außerdem die Durchführung eines [[Datensicherung_und_Wiederherstellung|Backups]] Ihrer MailStore Server- und Exchange-Server-Produktivumgebung zwingend erforderlich.</p>

== Voraussetzungen, Empfehlungen und Einschränkungen ==
* Es wird davon ausgegangen, dass MailStore Server bisher in einer Umgebung bestehend aus Active Directory und Exchange Server gemäß den [[E-Mail-Archivierung_von_Microsoft_Exchange|MailStore Exchange Implementation Guides]] und nach der Umstellung den Vorgaben des [[E-Mail-Archivierung_von_Microsoft_365_(Modern_Authentication)|MailStore Implementation Guide für Microsoft 365 (Modern Authentication)]] entsprechend betrieben wird.
* Vor der Umstellung sollte eine Verzeichnisdienstsynchronisation in MailStore Server durchgeführt werden, um sicherzustellen, dass die Benutzerdaten aktuell sind.
* Falls [[Auswahl_der_richtigen_Archivierungsstrategie#Archivierung_von_Benutzerpostf.C3.A4chern|Benutzerpostfächer archiviert werden]], sollten diese vor der Umstellung mit folgenden Filtereinstellungen archiviert werden, um nach der Umstellung Duplikate im Archiv zu vermeiden:<br/><br/>
*;[[Datei:Migration EXCHG Filter.png|center|350px]]
*; <p class="msnote" style="color:red">'''Warnung:''' Mit diesen Einstellungen werden alle E&#8209;Mails aus den zu archivierenden Postfächern in das MailStore Server-Archiv verschoben, d.h. diese Postfächer sind nach der Archiverung leer. Daher sollte dieser Schritt unmittelbar vor der Umstellung des Email-Systems erfolgen.</p>
* Im Gegensatz zu lokalen Exchange Servern unterstützt Microsoft&nbsp;365 keine Journalpostfächer. Die MailStore Server-Journalarchivierung muss daher mittels des [https://help.mailstore.com/de/gateway/Hauptseite MailStore Gateway] erfolgen. Beachten Sie dazu auch die Hinweise im entsprechenden Abschnitt dieses Artikels weiter unten.
* Die im Folgenden beschriebenen Änderungen an MailStore Server sollten im [[MailStore_Server_Dienst-Konfiguration#Dienst_kontrollieren|Safe Mode]] durchgeführt werden, um eine Beeinflussung durch Hintergrundprozesse oder Benutzer auszuschließen.
* Einige der in diesem Artikel beschriebenen Schritte werden mit Hilfe von PowerShell-Skripts durchgeführt, diese erfordern Windows PowerShell 3.0 oder höher.
** Die Skripte können Sie [[Datei:MailStore_DomainUpdate.zip|hier]] herunterladen. Sie sind nach dem Entpacken im Unterverzeichnis <code>powershell\domainUpdate</code> zu finden. Ihre grundsätzliche Verwendung ist in der enthaltenen ''readme.md'' beschrieben.
** Für die Skripte nutzen den [[PowerShell_API-Wrapper_Tutorial|MailStore PowerShell API-Wrapper]], der im o.g. Skriptpaket im Unterverzeichnis <code>powershell\api-wrapper</code> bereits enthalten ist. Hierfür muss der Zugriff auf die [[Administration_API_-_Using_the_API|MailStore Administration API]] in der [[MailStore_Server_Dienst-Konfiguration#Dienste|MailStore Server Dienst-Konfiguration]] aktiviert sein.
** Die Umbenennung der Benutzer und Archivordner erfordert, dass der Zugriff auf die Benutzer-Archive durch Administratoren in MailStore Server gestattet ist, was standardmäßig nicht der Fall ist. Das Ändern dieser Einstellung ist im Kapitel [[Compliance_Allgemein#Archiv-Zugriff|Compliance Allgemein]] des MailStore Server Handbuchs beschrieben.

== Umstellen der Benutzersynchronisation ==
Im ersten Schritt muss der Verzeichnisdienst, mit dem MailStore Server seine Benutzersynchronisation durchführt, von ''Active Directory'' auf ''Microsoft 365 mit moderner Authentifizierung'' umgestellt werden. Die Umstellung ist notwendig, da Microsoft 365 anstelle eines lokalen Active Directory das Azure Active Directory als Verzeichnisdienst nutzt.

<p class="msnote">'''Hinweis:''' Die für die Umstellung des Verzeichnisdienstes notwendigen Schritte sind abhängig vom Benutzernamensschema, das für die Benutzersynchronisation mit dem lokalen Active Directory in MailStore Server verwendet wird, da MailStore Server Benutzer nur anhand des Benutzernamens unterscheidet (z.B. wären <code>hmeyer</code> und <code>hmeyer@example.com</code> aus MailStore Server-Sicht zwei verschiedene Benutzer). Darüber hinaus assoziiert MailStore Server das zugehörige Archiv eines Benutzers immer namentlich zu dessen Benutzernamen, so dass für den Benutzer <code>hmeyer</code> auch immer ein zugehöriges Archiv ''(Archiv von) hmeyer'' erstellt wird, das, sofern es archivierte Emails enthält, unter diesem Namen erhalten bleibt, auch wenn sich der Benutzername ändert.</p>

=== Verwendung des User Principal Name ===
Bei Verwendung des vollständigen ''User Principal Name'' (''UPN'', z.B. <code>hmeyer@example.com</code>) als Benutzername in MailStore Server können Sie die direkt zum Abschnitt [[#Umstellung_der_Verzeichnisdienstsynchronisation_auf_Microsoft.C2.A0365|Umstellung der Verzeichnisdienstsynchronisation auf Microsoft&nbsp;365]] dieses Artikels wechseln, wenn genau dieser UPN auch für die Anmeldung an Microsoft 365 benutzt werden soll. Wenn Sie allerdings das Namensschema des UPN in Microsoft 365 geändert haben (z.B. von <code>hmeyer@example.com</code> nach <code>h.meyer@example.com</code> oder von <code>hmeyer@example.com</code> nach <code>hmeyer@beispiel.de</code>), müssen Sie mit den Schritten des folgenden Abschnitts fortfahren.

=== Verwendung des SAM Account Name oder des User Principal Name (Local Part) ===
Bei Verwendung des ''SAM Account Name'' oder des ''User Principal Name (Local Part)'', also eines "flachen" Benutzernamens ohne Domänenanteil (z.B. <code>hmeyer</code>), müssen Benutzer und Archivordner in MailStore Server umbenannt werden, da Azure Active Directory den vollständigen ''User Principal Name'', der im Allgemeinen der primären Emailadresse entspricht (z.B. <code>hmeyer@example.com</code>), als Benutzernamen verwendet.

Gehen Sie für die Umbenennung wie folgt vor:

* Falls noch nicht geschehen, laden Sie die Skripte, wie unter [[#Voraussetzungen.2C_Empfehlungen_und_Einschr.C3.A4nkungen|Voraussetzungen Empfehlungen und Einschränkungen]] beschrieben, herunter und entpacken Sie sie auf Ihrem MailStore Server-Computer, z.B. nach <code>C:\MailStoreScipts</code>.
* Bearbeiten Sie die Skripte <code>MSS_1_prepare_users.ps1</code> und <code>MSS_2_update_users.ps1</code> in der PowerShell ISE und passen Sie die Zugangsdaten im Abschnitt ''# Adjust these values according to your installation'' entsprechend Ihrer MailStore Server Installation an. Normalerweise müssen Sie hier nur den Wert der Variable <code>$password</code> auf Ihr MailStore Server-Administratorkennwort ändern.
* Starten Sie das Skript <code>MSS_1_prepare_users.ps1</code> in der PowerShell ISE mittels ''F5''.
* Die Datei <code>mailstore-users.txt</code> wird erstellt (standardmäßig im Verzeichnis <code>C:\Users\<Ihr Benutzername>\</code>). Diese enthält die aktuellen MailStore Server-Benutzernamen.
* Bearbeiten Sie diese Datei mit einem Texteditor. Ergänzen Sie die neuen Benutzernamen jeweils nach dem ''='', so dass die Einträge dann z.B. in der Form <code>hmeyer=hmeyer@example.com</code> vorliegen. Für Benutzernamen, die sich nicht ändern sollen (z.B. der interne ''admin''-Benutzer), brauchen Sie nichts zu ergänzen, solche Zeilen werden von folgenden Skripten übersprungen.
* Speichern Sie die Datei <code>mailstore-users.txt</code>, die jetzt die alten und neuen Benutzernamen enthalten sollte.
* Starten Sie jetzt das Skript <code>MSS_1_update_users.ps1</code> in der PowerShell ISE mittels ''F5''.
* Das Skript benennt nun die Benutzer und ihre Archivordner in MailStore Server um und setzt auch die Archivordnerrechte entsprechend.
* Melden Sie sich als MailStore Server-Administrator über den MailStore Client an und überprüfen Sie die neuen Benutzernamen und Archivordner. Da sowohl die bisherigen Exchange- als auch die zukünftigen Microsoft&nbsp;365-Archiverungsprofile dieselbe Ordnerstruktur beginnend mit ''Exchange'' unterhalb der Archivordner verwenden, müssen keine weiteren Umbenennungen vorgenommen werden.

=== Umstellen der Verzeichnisdienstsynchronisation auf Microsoft&nbsp;365 ===
Damit sich Benutzer anstatt mit ihren bisherigen Active Directory- zukünftig mit ihren Microsoft&nbsp;365-Zugangsdaten an MailStore Server anmelden können, muss die Verzeichnisdienstsynchronisation auf ''Microsoft&nbsp;365 (Modern Authentication)'' umgestellt werden.
* Folgen Sie den Schritten im Kapitel [[Synchronisieren von Benutzerkonten mit Microsoft 365 (Modern Authentication)]] des MailStore Server Handbuchs.
* Sollten Sie die Verzeichnisdienstsynchronisation per Job zur zeitgesteuerten Ausführung eingerichtet haben, melden Sie sich als MailStore Server-Administrator über den MailStore Client an. Klicken Sie im Menübaum links auf ''Verwaltung > Management API > Jobs'' und deaktivieren Sie dort jeden angezeigten Job, der die Verzeichnisdienstsynchronisation ausführt, mittels des per Rechtsklick aufrufbaren Kontextmenüs.

== Umstellen der Archiverungsprofile ==
Am 20. September 2019 [https://developer.microsoft.com/de-de/office/blogs/end-of-support-for-basic-authentication-access-to-exchange-online-apis-for-office-365-customers/ hat Microsoft angekündigt], Basic Authentication als Authentifizierungsmethode für Exchange Online APIs in naher Zukunft nicht mehr zu unterstützen. Daher können die vorhandenen Exchange-Archiverungsprofile nicht mehr zur Archiverung von Microsoft&nbsp;365-Postfächern verwendet werden, denn diese verwenden Basic Authentication zum Anmelden eines Benutzers oder Servicekontos am Exchange Server.

=== Deaktivieren vorhandener Profile und Jobs ===
Wenn Sie MailStore Server, wie weiter oben empfohlen, im [[MailStore_Server_Dienst-Konfiguration#Dienst_kontrollieren|Safe Mode]] ausführen, sind sowohl die automatische Ausführung als auch die Ausführung von Archiverungsprofilen per Job deaktiviert. Um diese dauerhaft zu deaktivieren, gehen Sie bitte wie folgt vor:

* Melden Sie sich als MailStore Server-Administrator über den MailStore Client an.
* Klicken Sie auf ''E&#8209;Mails archivieren''.
* Aktivieren Sie unterhalb der Profilliste die Option ''Profile anderer Benutzer anzeigen''.
* Stellen Sie jedes angezeigte Exchange-Archiverungsprofil mittels des per Rechtsklick aufrufbaren Kontextmenüs auf "Manuell" um.
* Sollten Sie Exchange-Exportprofile eingerichtet haben, klicken Sie im Menübaum links auf ''E&#8209;Mails exportieren'' und verfahren Sie dort analog.
* Sollten Sie Exchange-Profile per Job zur zeitgesteuerten Ausführung eingerichtet haben, klicken Sie im Menübaum links auf ''Verwaltung > Management API > Jobs'' und deaktivieren Sie dort jeden angezeigten Job, der ein Exchange-Profil ausführt, mittels des per Rechtsklick aufrufbaren Kontextmenüs.

=== Anlegen neuer Microsoft&nbsp;365 Profile ===
In MailStore Server 13 wurden die Unterstützung für moderne Authentifizierungsmethoden via OAuth 2.0 & OpenID Connect gemäß Microsofts Empfehlung sowie entsprechende Microsoft&nbsp;365-Archivierungs- und Exportprofile eingeführt.

Richten Sie die neuen Profile und Jobs entsprechend der folgenden Artikel ein. Um die Ausführung nach der Einrichtung überprüfen zu können, sollten diese zunächst auf ''manuell'' bzw. ''deaktiviert'' gestellt werden.
* Folgen Sie für die Archivierung von Microsoft&nbsp;365-Postfächern dem Implementation Guide [[E-Mail-Archivierung von Microsoft 365 (Modern Authentication)|E&#8209;Mail-Archivierung von Microsoft&nbsp;365 (Modern Authentication)]]. Beachten Sie dabei insbesondere die Notwendigkeit des Einsatzes von MailStore Gateway für die Journalarchivierung, wie im Implementation Guide ausführlich beschrieben.
* Die Einrichtung von Microsoft&nbsp;365-Exportprofilen wird im Kapitel [[E-Mails_exportieren#E-Mail-Server|E&#8209;Mails exportieren]] des MailStore Server Handbuchs beschrieben.
* Nach der Einrichtung der Profile können Sie auch eventuell vorhandene Jobs anpassen, wie im Kapitel [[Jobs#Eigenschaften|Jobs]] des MailStore Server Handbuchs beschrieben.