Daten über die Befehlszeile migrieren

Google Workspace Migration for Microsoft Exchange

Sie können Google Workspace Migration for Microsoft Exchange (GWMME) nicht nur über Ihren Windows-Desktop, sondern auch über die Befehlszeile ausführen.

Hinweis

Öffnen Sie die Eingabeaufforderung und geben Sie cd gefolgt vom Speicherort Ihrer GWMME-Installation in doppelten Anführungszeichen ein, z. B. cd "C:\Programme\Google\Google Workspace Migration".

Die Standardspeicherorte sind:

  • C:\Programme\Google\Google Workspace Migration (32-Bit-System)
  • C:\Programme (x86)\Google\Google Workspace Migration (64-Bit-System)

Möglicherweise werden Sie dazu aufgefordert, den Nutzernamen und das Passwort für Ihr Exchange-Administratorkonto einzugeben.

Erforderliche Befehle für die Migration

Die Befehle müssen in einer durchgehenden einzelnen Zeile eingegeben werden. Die hier sichtbaren Zeilenumbrüche dienen lediglich der Lesbarkeit.

Von Exchange migrieren

Beispiel 1: Mit einem Administratorprofil migrieren

ExchangeMigration.exe
--nouse_gui
--exchange_profile_name="Exchange admin profile"
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"

Beispiel 2: Mit Server- und Administratordetails migrieren

ExchangeMigration.exe
--nouse_gui
--source_server="exchange-server hostname"
--exchange_admin_login="Exchange server admin account"
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"

Weitere Informationen zum Übertragen von Exchange-Daten finden Sie unter Daten aus Exchange migrieren.

Migration von einem Google-Konto oder einem IMAP-Server

ExchangeMigration.exe
--nouse_gui
--enable_imap
--filename="filename containing user list"
--service_account_json_path="json file path"
--imap_security="security number"
--imap_port="port number"
--imap_path_prefix="path prefix"
--imap_server_type="server type"
--source_server="IMAP server hostname"
--google_admin="admin email address"
--google_domain="Google domain name"

Für Administratormodus-Migrationen aus Cyrus können auch folgende Befehle verwendet werden:

--imap_admin_id="Cyrus IMAP admin"
--imap_admin_password="Cyrus admin password"

Weitere Informationen zum Übertragen von E‑Mail-Daten aus Google- oder IMAP-basierten Konten finden Sie im Hilfeartikel E‑Mails aus Google-Konten oder IMAP-Servern migrieren.

Migration von PST-Dateien

Beispiel 1: Nachrichten nach Gmail migrieren

ExchangeMigration.exe
--nouse_gui
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--pst_base_folder="PST folder name"

Beispiel 2: Nachrichten zu Google Vault migrieren

ExchangeMigration.exe
--nouse_gui
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--pst_base_folder="PST folder name"
--migrate_to_vault

Weitere Informationen zum Übertragen von PST-Dateien finden Sie im Hilfeartikel Daten aus PST-Dateien migrieren.

Migration von öffentlichen Ordnern

Beispiel 1: Migrieren öffentlicher Ordner im Zuordnungsmodus (empfohlen) In diesem Modus wird eine Zuordnungsdatei verwendet, um den öffentlichen Ordner der Gruppe in Google Groups zuzuordnen. Da die E-Mail-Adressen der Gruppen oft nicht mit den Namen der öffentlichen Ordner übereinstimmen, verwenden die meisten Organisationen den Zuordnungsmodus.

ExchangeMigration.exe
--nouse_gui
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--public_folder_mapping_file="path to mapping file"
--enable_public_folder_migration

Beispiel 2: Öffentliche Ordner im Standardmodus migrieren In diesem Modus benötigen Sie keine Zuordnungsdatei. Stattdessen vergleicht GWMME Ordner- und Gruppennamen. Eine Zuordnung wird hergestellt, wenn es eine direkte Übereinstimmung zwischen dem Namen des jeweiligen öffentlichen Ordners und einem Gruppennamen gibt. So wird z. B. „TPS-Berichte/tps-Berichte“ der Gruppe tps-berichte@solarmora.com zugeordnet.

ExchangeMigration.exe
--nouse_gui
--exchange_profile_name="Exchange admin profile"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--enable_public_folder_migration

Weitere Informationen zum Übertragen öffentlicher Ordner finden Sie im Hilfeartikel Öffentliche Ordner migrieren.

Alle GWMME-Argumente

Geben Sie pro Zeile ein Argument ein, dem ein doppelter Bindestrich (--) vorangestellt ist. Für einige Argumente sind zusätzliche Parameter erforderlich. Wenn Sie zusätzliche Parameter eingeben, stellen Sie ihnen ein Gleichheitszeichen (=) voran und setzen Sie sie in doppelte Anführungszeichen.

A–E

Argument und Beschreibung Parameter

--calendar_migration_end_date

Das Datum, bis zu dem Kalendertermine migriert werden sollen. Termine, die nach diesem Datum stattfinden, werden nicht migriert.

Beispiel: --calendar_migration_end_date="2020-01-01"

Datum im Format JJJJ-MM-TT

--calendar_migration_start_date

Das Datum, ab dem Kalendertermine migriert werden sollen. Kalendertermine vor diesem Datum werden nicht migriert.

Beispiel: --calendar_migration_start_date="2018-01-01"

Datum im Format JJJJ-MM-TT

--custom_label_prefix

Das Präfix, das allen Labels in Gmail vorausgestellt werden soll.

Beispiel: --custom_label_prefix="migriert-"

Benutzerdefiniertes Präfix, das Labels vorausgestellt werden soll

--email_migration_end_date

Das Datum, bis zu dem Sie E‑Mail-Nachrichten migrieren möchten. Nachrichten nach diesem Datum werden nicht migriert.

Beispiel: --email_migration_end_date="2020-01-01"

Datum im Format JJJJ-MM-TT

--email_migration_start_date

Das Datum, ab dem Sie E‑Mail-Nachrichten migrieren möchten. Nachrichten vor diesem Datum werden nicht migriert.

Beispiel: --email_migration_start_date="2018-01-01"

Datum im Format JJJJ-MM-TT

--enable_calendar_fanout

Ermöglicht bei einer Kalendermigration das Fan-Out für Kalendertermine.

Kein Parameter erforderlich

--enable_hidden_folders_migration

Aktiviert die Migration versteckter MAPI-Ordner (Exchange oder PST).

Kein Parameter erforderlich

--enable_imap

Ermöglicht die Migration von einem IMAP-Server statt von einem Exchange-Server.

Kein Parameter erforderlich

--enable_mbox_logging

Aktiviert das mbox-Logging. Nachrichten, die aufgrund von Größenbeschränkungen für Gmail-Dateien oder Typbeschränkungen nicht migriert werden können, werden in eine nutzerspezifische MBOX-Datei geschrieben. Die MBOX-Datei befindet sich im Ordnerpfad des Trace-Logs von GWMME, z. B. %localappdata%\Google\Google Apps Migration\Tracing\ExchangeMigration\mbox\nutzer@domain.com.mbox.

Weitere Informationen zu Gmail-Nachrichtenbeschränkungen finden Sie im Hilfeartikel In Gmail blockierte Dateitypen.

Kein Parameter erforderlich

--enable_public_folder_migration

Ermöglicht die GWMME-Migration von öffentlichen Exchange-Ordnern zu Google Groups. Weitere Informationen finden Sie im Hilfeartikel Öffentliche Ordner migrieren.

Hinweis: Die Migration kann nicht gleichzeitig für Nutzer und öffentliche Ordner ausgeführt werden.

Kein Parameter erforderlich

--enable_resource_migration

Ermöglicht die Migration von Kalenderressourcen.

Kein Parameter erforderlich

--exchange_admin_login

Anmeldename für das Exchange-Server-Administratorkonto. Verwenden Sie dieses Argument in Verbindung mit „--source_server“.

Verwenden Sie dieses Argument nicht zusammen mit „--exchange_profile_name“.

Beispiel: --exchange_admin_login="administrator"

Anmeldename für das Exchange-Server-Administratorkonto

--exchange_profile_name

Name des Outlook-Profils, das Sie für die Verbindung mit Ihrem Exchange-Server verwenden möchten. Geben Sie ein Administratorprofil an, das sich auf demselben Computer befindet, auf dem auch GWMME ausgeführt wird. Verwenden Sie dieses Argument nicht zusammen mit:

  • --source_server
  • --pst_base_folder
  • --exchange_admin_login

Beispiel: --exchange_profile_name="exch_migration_admin"

Name eines bestehenden Outlook-Profils

--exclude_message_classes

Schließt Nachrichten anhand der Nachrichtenklasse aus.

Dieses Argument ist beispielsweise hilfreich, wenn Nachrichten-Stubs aus einem Archivierungsprogramm ausgeschlossen werden sollen. Mit GWMME können keine ungekürzten Nachrichten remigriert werden. Es wird empfohlen, Nachrichten-Stubs auszuschließen. Anschließend können Sie die vollständigen, ungekürzten Nachrichten bei einem zweiten Lauf von GWMME migrieren.

Beispiel: --exclude_message_classes="ipm.note.eas,ipm.note.1"

Durch Kommas getrennte Liste mit ausgeschlossenen Klassen; ohne Leerzeichen zwischen den Elementen

--exclude_top_level_folders

Schließt Ordner der obersten Ebene anhand des Ordnernamens aus.

Beispiel: --exclude_top_level_folders="Gelöschte Elemente,Entwürfe"

Durch Kommas getrennte Liste von Ordnern der obersten Ebene; ohne Leerzeichen zwischen den Elementen

F—M

Argument und Beschreibung Parameter

--filename

Enthält die Daten zu den in der CSV-Datei angegebenen Nutzernamen. Verwenden Sie dieses Argument nicht zusammen mit „--migration_usernames“.

Beispiel: --filename="C:\Dokumente und Einstellungen\users.csv"

Pfad zur CSV-Datei mit Nutzernamen

--force_clear_google_calendar_ids_on_remigration

Löscht die IDs sekundärer Kalender, bevor Sie Daten noch einmal migrieren. Wenn Sie Kalenderdaten noch einmal migrieren, erstellt GWMME neue sekundäre Kalender mit eindeutigen IDs. So vermeiden Sie Terminkonflikte.

Hinweis: Verwenden Sie dieses Argument, bevor Sie Daten noch einmal migrieren. Weitere Informationen finden Sie im Hilfeartikel Inhalte noch einmal migrieren.

Kein Parameter erforderlich

--force_restart

Führt die Migration für alle Elemente noch einmal aus, anstatt nur für die Elemente, die noch nicht migriert wurden.

Wenn eine Migration unterbrochen wurde, beginnt die nächste Migration standardmäßig am Punkt der letzten Unterbrechung. Mit diesem Parameter können Sie die Migration noch einmal von Anfang an ausführen. Wenn Sie diese Option verwenden, werden doppelte E‑Mails herausgefiltert, bereits migrierte Kalendertermine ignoriert und zuvor migrierte Kontakte dupliziert. In einigen Fällen werden jedoch auch die bereits migrierten Kalendertermine dupliziert.

Kein Parameter erforderlich

--google_admin

Damit wird der Termininhaber für Kalenderressourcen festgelegt. Wenn ein Termin keinen Inhaber hat, wird der nominierte Administrator von GWMME als Termininhaber festgelegt. Der Nutzer benötigt uneingeschränkten Zugriff auf Ressourcenkalender.

Beispiel: --google_admin="admin@example.com"

E‑Mail-Adresse des nominierten Termininhabers für Ressourcenkalender

--google_domain

Die Google Workspace-Domain, in die Sie Daten migrieren.

Beispiel: --google_domain="beispiel.de"

Google Workspace-Domain

--help

Eine Liste der Argumente für ExchangeMigration.exe wird angezeigt.

Kein Parameter erforderlich

--id_mapping_file

Der Name der Datei, die die vollständige Zuordnungsliste enthält. Verwenden Sie die CSV-Zuordnungsdatei, die die Nutzer- und Kalenderadressen-Zuordnungen enthält. Weitere Informationen finden Sie unter CSV-Dateien für die Migration erstellen.

Beispiele: --id_mapping_file="ressourcen.csv"

Dateiname

--imap_admin_id

Der Cyrus-IMAP-Administrator, der Zugriff auf alle IMAP-Konten auf dem Server hat. Verwenden Sie das Argument zusammen mit „--imap_admin_password“.

Beispiel: --imap_admin_id="admin@example.com"

Die E-Mail-Adresse des Cyrus-Administrators

--imap_admin_password

Das Passwort des IMAP-Administrators für Cyrus. Verwenden Sie dieses Argument in Verbindung mit „--imap_admin_id“.

Beispiel: --imap_admin_password="Passwort"

Das Passwort des Cyrus-Administrators

--imap_path_prefix

Das Pfadpräfix für Nutzerordner auf einem IMAP-Server.

Geben Sie das Pfadpräfix für alle IMAP-Ordner an. Das Pfadpräfix ist normalerweise der IMAP-Namespace für die Ordnernamen. Wenn die IMAP-Ordnerliste für einen Nutzer beispielsweise INBOX, INBOX.Sent und INBOX.Drafts lautet, ist „INBOX“ das Pfadpräfix. Die Präfixwerte für das Pfadpräfix lauten normalerweise „INBOX“ für Cyrus und Courier oder „Keine Angabe“ für GroupWise IMAP, Gmail oder Dovecot. Lassen Sie das Feld in diesem Fall leer.

Beispiel: --imap_path_prefix="INBOX"

Pfadpräfix für Nutzerordner

--imap_port

Gibt die Portnummer für den IMAP-Server an.

Beispiel: --imap_port="143"

Portnummer

--imap_security

Gibt die Sicherheitsoption an, die Sie verwenden möchten. Verwenden Sie einen der folgenden Codes:

  • 0 (keine Sicherheit)
  • 1 (SSL)
  • 2 (STARTTLS)

Beispiel: --imap_security="1"

Einstelliger Code

--imap_server_type

Gibt den Typ des IMAP-Servers an, von dem Sie migrieren. Servertypen sind: Exchange, GroupWise, Gmail, Cyrus, Courier, Dovecot, Zimbra sowie nicht unterstützte Servertypen. Die Standardeinstellung lautet „nicht unterstützt“.

Hinweis: Die Angabe des falschen Servertyps kann die Migrationsgeschwindigkeit beeinträchtigen.

Beispiel: --imap_server_type="Gmail"

IMAP-Servertyp

--migrate_to_vault

Migriert E-Mails zu Google Vault. Nachrichten werden in das Konto des Nutzers hochgeladen und als gelöscht markiert. Dabei werden im Posteingang des Nutzers keine Labels erstellt.

Beachten Sie die folgenden Einschränkungen:

  • In den Google Vault-Aufbewahrungsregeln ist festgelegt, wie lange die Nachricht in Vault aufbewahrt wird.
  • Wenn Sie zu Vault migrieren, muss Gmail in der Admin-Konsole aktiviert sein. Andernfalls wird Ihnen der Fehler 403 angezeigt.
  • Die Migration zu Nutzern mit VFE-Lizenzen (Vault Former Employee) schlägt fehl, da Gmail für diese Nutzer nicht aktiviert ist.
Kein Parameter erforderlich

--migration_usernames

Gibt die Liste der Nutzer für die Migration an. Verwenden Sie dieses Argument nicht zusammen mit „--filename“.

Beispiel: --migration_usernames="Nutzer1,Nutzer2,Nutzer3"

Durch Kommas getrennte Liste der Nutzer; ohne Leerzeichen zwischen den Elementen

N–Z

Argument und Beschreibung Parameter

--noenable_calendar_migration

Die Migration wird ohne Erfassung der Kalenderdaten durchgeführt.

Kein Parameter erforderlich

--noenable_contact_migration

Die Migration wird ohne Erfassung der Kontaktdaten durchgeführt.

Kein Parameter erforderlich

--noenable_email_migration

Die Migration wird ohne Erfassung der E‑Mail-Daten durchgeführt.

Kein Parameter erforderlich

--noenable_error_reports

Verhindert, dass GWMME Migrationsberichte erstellt, in denen die während einer Migration aufgetretenen Nachrichtenfehler aufgelistet werden. Dadurch wird unter Umständen die Migration beschleunigt.

Weitere Informationen zu Migrationsberichten finden Sie im GWMME-Administratorhandbuch im Abschnitt „Migrationsberichte prüfen“ (nur in englischer Sprache).

Kein Parameter erforderlich

--noenable_id_mapping

Die Migration wird ohne eine Zuordnungsdatei ausgeführt. Alle Zuordnungsdaten sind in der Nutzerliste definiert, wenn Sie das Argument „--id_mapping_file“ verwenden.

Kein Parameter erforderlich

--noenable_label_prefix

Gibt an, dass Labels bei der Migration von PST-Dateien kein Präfix vorangestellt wird. Standardmäßig wird der Name der PST-Datei während der Migration als Präfix an Labels und Kalender angehängt.

Kein Parameter erforderlich

--nouse_gui

Führt GWMME über die Befehlszeile aus. Dabei wird der GUI-Modus (Graphic User Interface) verwendet.

Kein Parameter erforderlich

--nowait

Bei der Ausführung über die Befehlszeile wird GWMME geschlossen, ohne auf die Betätigung der Eingabetaste zu warten.

Kein Parameter erforderlich

--num_threads

Die Anzahl der Nutzer, die gleichzeitig migriert werden sollen. Für jeden Nutzer wird ein neuer Thread geöffnet. Der Standardwert ist 25 Threads.

Beispiel: --num_threads="20"

Anzahl der Nutzer

--pst_base_folder

Das Verzeichnis, das die PST-Dateien für die Migration enthält. GWMME migriert alle PST-Dateien in den Unterordnern des angegebenen Ordners.

Verwenden Sie dieses Argument nicht zusammen mit:

  • --source_server
  • --exchange_profile_name

Beispiel: --pst_base_folder="C:\pst"

Verzeichnis, das PST-Dateien enthält

--public_folder_mapping_file

Der Name der Zuordnungsdatei. Die Zuordnungsdatei ordnet die Pfade der öffentlichen Exchange-Ordner den Google Groups-E-Mail-Adressen zu. Weitere Informationen finden Sie im Hilfeartikel Öffentliche Ordner migrieren.

Beispiel: --public_folder_mapping_file="zuordnung_oeffentlicher_ordner.csv"

Name der Zuordnungsdatei im CSV-Format

--retry_count

Die Anzahl der Wiederholungen, falls ein vorübergehender Fehler auftritt, z. B. eine Zeitüberschreitung des Servers. Der Standardwert ist 10.

Beispiel: --retry_count="5"

Anzahl der Wiederholungsversuche

--run_diagnostics

Führt vor der Migration eine umfassende Diagnose durch, bei der Serververbindung, Authentifizierung, Kontenzugriff und die gesamte Nutzerliste geprüft werden.

Kein Parameter erforderlich

--service_account_json_path

Gibt den Pfad zur Datei mit den Anmeldedaten für das Dienstkonto an. Eine Anleitung dazu finden Sie im Google Workspace-Admin-Hilfeartikel GWMME für mein Konto autorisieren.

Beispiel: --service_account_json_path ="C:\Users\admin\privatekey.json"

Pfad zur Datei mit den Anmeldedaten für das Dienstkonto

--source_server

Die Exchange- oder IMAP-Server-IP-Adresse oder der vollständig qualifizierte Domainname.

Verwenden Sie dieses Argument bei Exchange-Migrationen in Verbindung mit „--exchange_admin_login“. Verwenden Sie dieses Argument nicht zusammen mit „--exchange_profile_name“.

Beispiel: --source_server="mailserver.example.com"

Server-IP-Adresse oder vollständig qualifizierter Domainname

--strip_user_labels

Nachrichten werden ohne Labels migriert.

Kein Parameter erforderlich

--translate_conflicting_events

Damit veranlassen Sie, dass in GWMME bei Terminen, die bereits in Google Kalender migriert wurden, die E-Mail-Adresse der Exchange-Ressource in die der passenden Google Workspace-Ressource übersetzt wird.

Viele Administratoren migrieren erst Nutzer und dann Kalenderressourcen. Wenn Sie sich dazu entscheiden, Kalenderressourcen in einem zweiten Schritt zu migrieren, konfigurieren Sie GWMME, um die Kalenderdaten der Nutzer erneut zu migrieren. Verwenden Sie dafür das Argument „--translate_conflicting_events“.

Kein Parameter erforderlich


Google, Google Workspace sowie zugehörige Marken und Logos sind Marken von Google LLC. Alle anderen Unternehmens- und Produktnamen sind Marken der jeweiligen Unternehmen.