imapmig 1.0.0
IMAP-Postfächer nach Microsoft 365 übertragen
© 2026 IT-Service Matthias Tichý · https://mt-computerservice.de

================================================================================
  BITTE ZUERST LESEN
================================================================================

  Die Nutzung erfolgt auf eigene Gefahr und ohne Gewähr.

  Legen Sie VOR jeder Migration eine vollständige Datensicherung an – vom
  Quell- UND vom Zielpostfach. Prüfen Sie das Ergebnis, BEVOR Sie das
  Quellpostfach abschalten oder den Vertrag beim alten Anbieter kündigen.

  Die vollständigen Nutzungsbedingungen stehen in LICENSE.txt.


================================================================================
  SCHNELLSTART
================================================================================

  1. Dieses Archiv in einen Ordner Ihrer Wahl entpacken,
     zum Beispiel nach C:\imapmig\

  2. imapmig.exe starten (Doppelklick)

     Es öffnet sich ein Konsolenfenster mit einer Adresse, und der Browser
     geht von selbst auf. Das Konsolenfenster bitte offen lassen – es IST
     die Anwendung. Zum Beenden dort Strg+C drücken.

  3. Im Formular oben den Anbieter des alten Postfachs auswählen und die
     Zugangsdaten eintragen.

  4. Beim Zielpostfach die Adresse eintragen und auf
     "App im Zieltenant anlegen" klicken.

     Einmal als Administrator im Browser anmelden – danach steht alles
     bereit. Das ist einmalige Arbeit je Microsoft-365-Tenant.

  5. "Verbindung testen"  ->  "Ordner anzeigen"  ->  "Trockenlauf"

     Diese drei Schritte schreiben NICHTS ins Zielpostfach. Sie zeigen nur,
     welche Ordner wohin wandern und wie viele Nachrichten anstehen.

  6. "Migration starten"

     Der Lauf ist wiederaufnehmbar. Wird er unterbrochen, geht es beim
     nächsten Start dort weiter, wo er stand – nichts kommt doppelt an.

  7. Nach dem Lauf erscheint der Abschnitt "Nicht übertragen".

     Dort steht mit Grund, Betreff, Absender und Datum, welche Nachrichten
     liegen geblieben sind. Als CSV-Tabelle für Excel herunterladbar.


================================================================================
  WAS AUF IHREM RECHNER PASSIERT
================================================================================

  imapmig installiert sich NICHT. Es läuft aus dem Ordner, in den Sie es
  entpackt haben, und legt keine Verknüpfungen, Dienste oder Registry-
  Einträge an.

  Zwei Dinge entstehen trotzdem – beide im Benutzerprofil, nichts systemweit,
  keine Administratorrechte nötig:

  1. Ein Datenordner unter

         %APPDATA%\imapmig

     Darin liegen gespeicherte Profile, die zwischengespeicherte Anmeldung
     und die Kennungen der App-Registrierung. Keine E-Mail-Inhalte.

  2. PowerShell-Module von Microsoft, FALLS sie fehlen:

         Microsoft.Graph.Authentication
         Microsoft.Graph.Applications
         Microsoft.Graph.Identity.SignIns

     Diese werden nur dann aus der PowerShell Gallery geladen, wenn Sie die
     App-Registrierung anlegen oder entfernen lassen – zusammen rund 30 MB.
     Sie werden vorher gefragt, und die Oberfläche zeigt schon davor an, ob
     überhaupt etwas fehlt.

  Alles wieder entfernen:

         imapmig.exe uninstall              Datenordner löschen
         imapmig.exe uninstall --modules    auch die PowerShell-Module

     Danach nur noch den Programmordner löschen. Achtung: Wenn Sie die
     App-Registrierung im Tenant loswerden wollen, führen Sie VORHER
     "imapmig.exe unregister" aus – danach fehlen die Kennungen dafür.


================================================================================
  VORAUSSETZUNGEN
================================================================================

  * Windows 10/11 oder Windows Server 2016 oder neuer
  * Zugang zum alten Postfach per IMAP (Benutzername und Passwort)
  * Administratorrechte im Ziel-Tenant für die einmalige App-Registrierung
  * IMAP muss für das Zielpostfach aktiviert sein:

        Connect-ExchangeOnline
        Set-CASMailbox -Identity ziel@ihredomain.de -ImapEnabled $true


================================================================================
  HÄUFIGE STOLPERSTEINE
================================================================================

  GMX und WEB.DE
      IMAP ist dort standardmäßig ABGESCHALTET. Erst im Webinterface unter
      E-Mail-Einstellungen -> POP3/IMAP Abruf freischalten, sonst scheitert
      jede Anmeldung mit "Authentifizierung fehlgeschlagen".

  Telekom / T-Online
      Es wird das separate E-Mail-Passwort gebraucht, nicht das Passwort des
      Telekom-Kundenkontos.

  Gmail, iCloud, Yahoo
      Es wird ein App-Passwort gebraucht, nicht das normale Kontopasswort.

  Outlook.com und Microsoft 365 als QUELLE
      Funktioniert nicht per Passwort – Microsoft hat das abgeschaltet.

  "Diese Seite gehört zu einer älteren Sitzung"
      Ein Browser-Tab von einem früheren Start. Die Adresse aus dem
      Konsolenfenster verwenden oder den alten Tab schließen.


================================================================================
  WAS ÜBERTRAGEN WIRD – UND WAS NICHT
================================================================================

  Übertragen:
      Die Nachrichten Byte für Byte, die komplette Ordnerstruktur,
      Sonderordner richtig zugeordnet, die Kennzeichnungen Gelesen /
      Beantwortet / Markiert / Entwurf sowie das ursprüngliche Zustelldatum.

  Nicht übertragen:
      Kalender, Kontakte, Aufgaben, Notizen, serverseitige Regeln,
      Abwesenheitsnotizen, Signaturen, Outlook-Kategorien und
      Ordnerberechtigungen.

      Das kann IMAP grundsätzlich nicht – es gilt für jedes Werkzeug, das
      über IMAP arbeitet.

  Das Quellpostfach wird NICHT verändert. Es wird ausschließlich gelesen;
  selbst ungelesene Nachrichten bleiben ungelesen.


================================================================================
  KOMMANDOZEILE
================================================================================

  Dieselben Schritte gibt es als Befehle, etwa für die Aufgabenplanung:

      imapmig.exe providers              bekannte Anbieter auflisten
      imapmig.exe init -o kunde.yaml     Konfigurationsvorlage anlegen
      imapmig.exe test    -c kunde.yaml  Verbindung prüfen
      imapmig.exe folders -c kunde.yaml --count
      imapmig.exe run     -c kunde.yaml --dry-run
      imapmig.exe run     -c kunde.yaml
      imapmig.exe report                 was wurde nicht übertragen?
      imapmig.exe batch --csv postfaecher.csv    viele Postfächer
      imapmig.exe unregister             App aus dem Tenant entfernen

      imapmig.exe --help                 alle Befehle

  Mehrere Kunden getrennt halten:

      imapmig.exe --data-dir J:\kunden\mueller
      imapmig.exe --portable             alles neben der Programmdatei


================================================================================
  WO DIE DATEN LIEGEN
================================================================================

  Profile, Anmeldung und App-Kennungen liegen unter

      %APPDATA%\imapmig

  Mit --portable stattdessen im Ordner "imapmig-daten" neben der
  Programmdatei. Eine Kopie der EXE in einem frischen Ordner ist damit eine
  vollständig leere, eigenständige Instanz.


================================================================================
  AUSFÜHRLICHE ANLEITUNGEN
================================================================================

  Im Ordner "Anleitungen" liegen Schritt-für-Schritt-Beschreibungen zur
  App-Registrierung, zur Fehlersuche und zu einer Migration ganz ohne
  App-Registrierung.

  HINWEIS: In diesen Anleitungen steht an manchen Stellen
  "python -m imapmig ...". Gemeint ist damit dasselbe wie "imapmig.exe ..." –
  die Anleitungen stammen aus der Entwicklerfassung.


================================================================================

  Fragen oder Rückmeldungen: support@mt-computerservice.de
  https://mt-computerservice.de/projekte/imapmig
