Gegevens migreren via de opdrachtregel

Google Workspace Migration for Microsoft Exchange

U kunt Google Workspace Migration for Microsoft Exchange (GWMME) niet alleen gebruiken op uw Windows-desktop, maar ook uitvoeren via de opdrachtregelinterface.

Voordat u begint

Open een opdrachtprompt en voer cd in, gevolgd door de locatie van de GWMME-installatie tussen dubbele aanhalingstekens, bijvoorbeeld cd "C:\Program Files\Google\Google Workspace Migration".

Dit zijn de standaardlocaties:

  • C:\Program Files\Google\Google Workspace Migration (32-bits systeem)
  • C:\Program Files (x86)\Google\Google Workspace Migration (64-bits systeem)

U wordt mogelijk gevraagd de gebruikersnaam en het wachtwoord van uw Exchange-beheerder in te voeren.

Vereiste opdrachten voor de migratie

Voer de opdrachten in op één doorlopende regel. Eventuele regeleinden die hier zichtbaar zijn, zijn alleen bedoeld voor de leesbaarheid.

Migreren vanuit Exchange

Voorbeeld 1: Migreren met een beheerdersprofiel

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"

Voorbeeld 2: Migreren met server- en beheerdersgegevens

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"

Ga naar Gegevens migreren vanuit Exchange voor meer informatie over hoe u Exchange-gegevens overzet.

Migreren vanuit een Google-account of een 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"

Gebruik voor migraties in beheerdersmodus vanuit Cyrus ook de volgende opdrachten:

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

Ga naar E-mails migreren vanuit Google-accounts of IMAP voor meer informatie over hoe u e-mailgegevens overzet vanuit Google- of IMAP-accounts.

Migreren vanuit PST-bestanden

Voorbeeld 1: Berichten migreren naar Gmail

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"

Voorbeeld 2: Berichten migreren naar Google Vault

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

Ga naar Gegevens migreren vanuit PST-bestanden voor meer informatie over hoe u PST-bestanden overzet.

Migreren vanuit openbare mappen

Voorbeeld 1: De toewijzingsmodus gebruiken om openbare mappen te migreren (aanbevolen). In deze modus wordt een toewijzingsbestand gebruikt om de openbare map toe te wijzen aan de groep in Groepen. Omdat e-mailadressen van groepen vaak niet overeenkomen met de namen van openbare mappen, gebruiken de meeste organisaties de toewijzingsmodus.

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

Voorbeeld 2: De standaardmodus gebruiken om openbare mappen te migreren. In deze modus heeft u geen toewijzingsbestand nodig. In plaats daarvan vergelijkt GWMME map- en groepsnamen. De toewijzing wordt gemaakt als de naam van de openbare map precies overeenkomt met de groepsnaam. TPS-rapporten/tps-rapporten wordt bijvoorbeeld toegewezen aan de groep tps-rapporten@solarmora.com.

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

Zie Migreren vanuit openbare mappen voor meer informatie over het overzetten van openbare mappen.

Alle GWMME-argumenten

Voer een argument op één regel in en zet voor het argument een dubbel streepje (--). Voor sommige argumenten zijn aanvullende parameters vereist. Voer de parameters in, voorafgegaan door een gelijkteken en tussen dubbele aanhalingstekens.

A—E

Argument en beschrijving Parameter

--calendar_migration_end_date

Hiermee geeft u de einddatum op van agenda-afspraken die u wilt migreren. Afspraken die na deze datum plaatsvinden, worden niet gemigreerd.

Voorbeeld: --calendar_migration_end_date="2020-01-01"

Datum in de notatie JJJJ-MM-DD

--calendar_migration_start_date

Hiermee geeft u de startdatum op van agenda-afspraken die u wilt migreren. Agenda-afspraken die voor deze datum plaatsvinden, worden niet gemigreerd.

Voorbeeld: --calendar_migration_start_date="2018-01-01"

Datum in de notatie JJJJ-MM-DD

--custom_label_prefix

Hiermee geef je het voorvoegsel op dat aan alle labels in Gmail moet worden toegevoegd.

Voorbeeld: --custom_label_prefix="gemigreerd-"

Aangepast voorvoegsel dat wordt toegevoegd aan labels

--email_migration_end_date

Hiermee geeft u de einddatum op van e-mailberichten die u wilt migreren. Berichten van na deze datum worden niet gemigreerd.

Voorbeeld: --email_migration_end_date="2020-01-01"

Datum in de notatie JJJJ-MM-DD

--email_migration_start_date

Hiermee geeft u de startdatum op van e-mailberichten die u wilt migreren. Berichten van voor deze datum worden niet gemigreerd.

Voorbeeld: --email_migration_start_date="2018-01-01"

Datum in de notatie JJJJ-MM-DD

--enable_calendar_fanout

Zet fan-out van agenda-afspraken aan voor agendamigratie.

Geen parameter vereist

--enable_hidden_folders_migration

Hiermee schakelt u de migratie van verborgen MAPI-mappen (Exchange/PST) in.

Geen parameter vereist

--enable_imap

Schakelt migratie in van een IMAP-server in plaats van een Exchange-server.

Geen parameter vereist

--enable_mbox_logging

Hiermee schakelt u mbox-logboekregistratie in. Berichten die niet kunnen worden gemigreerd vanwege beperkingen met de bestandsgrootte of -typen in Gmail, worden naar een gebruikersspecifiek mbox-bestand geschreven. Het mbox-bestand bevindt zich in het mappad voor de GWMME-traceringslogboeken (bijvoorbeeld %localappdata%\Google\Google Apps Migration\Tracing\ExchangeMigration\mbox\gebruiker@domein.com.mbox).

Zie Bestandstypen die worden geblokkeerd in Gmail voor meer informatie over beperkingen voor Gmail-berichten.

Geen parameter vereist

--enable_public_folder_migration

Hiermee schakelt u GWMME-migratie van openbare Exchange-mappen naar Google Groepen in. Zie Openbare mappen migreren voor meer informatie.

Opmerking: U kunt niet voor zowel gebruikers als openbare mappen tegelijk een migratie uitvoeren.

Geen parameter vereist

--enable_resource_migration

Hiermee schakelt u de migratie van agendafaciliteiten in.

Geen parameter vereist

--exchange_admin_login

Hiermee geeft u de inlognaam voor het beheerdersaccount van de Exchange-server op. Gebruik dit argument samen met --source_server.

Als u dit argument gebruikt, gebruikt u --exchange_profile_name niet.

Voorbeeld: --exchange_admin_login="beheerder"

Inlognaam voor het beheerdersaccount van de Exchange-server

--exchange_profile_name

Hiermee geeft u de naam op van het Outlook-profiel dat u wilt gebruiken om verbinding te maken met de Exchange-server. Geef een beheerdersprofiel op dat zich op hetzelfde apparaat bevindt als waarop GWMME wordt uitgevoerd. Als u dit argument gebruikt, gebruik dan niet:

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

Voorbeeld: --exchange_profile_name="exch_migratie_beheerder"

Naam van een bestaand Outlook-profiel

--exclude_message_classes

Sluit berichten uit op basis van de berichtklasse.

Dit argument is handig als u ingekorte berichten van een archiveringsoplossing wilt uitsluiten. Met GWMME kunt u niet-ingekorte berichten niet opnieuw migreren. We raden u aan ingekorte berichten uit te sluiten en vervolgens, als de volledige niet-ingekorte berichten beschikbaar zijn, deze te migreren door GWMME nogmaals uit te voeren.

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

Door komma's gescheiden lijst met uitgesloten klassen (zet geen spaties tussen de items op de lijst)

--exclude_top_level_folders

Sluit mappen op het hoogste niveau uit op basis van de mapnaam.

Voorbeeld: --exclude_top_level_folders="Verwijderd,Concepten"

Een door komma's gescheiden lijst met mappen van het hoogste niveau (geen spaties tussen lijstitems)

V—M

Argument en beschrijving Parameter

--filename

Hiermee zorgt u dat de gegevens worden toegevoegd van de gebruikersnamen die u opgeeft in het csv-bestand. Als je dit argument gebruikt, gebruik je --migration_usernames niet.

Voorbeeld: --filename="C:\Documents and Settings\gebruikers.csv"

Pad naar het csv-bestand met gebruikersnamen

--force_clear_google_calendar_ids_on_remigration

Hiermee worden de ID's van secundaire agenda's gewist voordat u gegevens opnieuw migreert. Als u agendagegevens opnieuw migreert, maakt GWMME nieuwe secundaire agenda's met een unieke ID. Zo worden conflicterende afspraken voorkomen.

Opmerking: Gebruik dit argument voordat u gegevens opnieuw migreert. Zie Content opnieuw migreren voor meer informatie.

Geen parameter vereist

--force_restart

Hiermee wordt de migratie opnieuw uitgevoerd voor alle items, in plaats van alleen de items die nog niet zijn gemigreerd.

Standaard is het zo dat als een migratie onderbroken werd, deze de volgende keer begint bij het punt waar deze de vorige keer was gestopt. U kunt deze parameter gebruiken om de migratie weer vanaf het begin uit te voeren. Als u deze optie gebruikt, worden dubbele e-mails eruit gefilterd, eerder gemigreerde agenda-afspraken genegeerd (deze kunnen in sommige gevallen worden gedupliceerd) en eerder gemigreerde contacten gedupliceerd.

Geen parameter vereist

--google_admin

Hiermee stelt u de eigenaar van de afspraak in voor agendafaciliteiten. Als een afspraak geen eigenaar heeft, stelt GWMME de toegewezen beheerder in als de eigenaar. Deze gebruiker moet volledige toegang tot faciliteitagenda's hebben.

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

E-mailadres van de toegewezen eigenaar van afspraken in faciliteitagenda's

--google_domain

Het Google Workspace-domein waarnaar u gegevens migreert.

Voorbeeld: --google_domain="example.com"

Google Workspace-domein

--help

Hiermee wordt een lijst met argumenten voor ExchangeMigration.exe weergegeven.

Geen parameter vereist

--id_mapping_file

Hiermee geeft u de naam op van het bestand met de volledige toewijzingslijst. Gebruik het csv-toewijzingsbestand met toewijzingen van gebruikers- en agenda-adressen. Zie Csv-bestanden maken voor uw migratie voor meer informatie.

Voorbeelden: --id_mapping_file="faciliteiten.csv"

Bestandsnaam

--imap_admin_id

Hiermee geeft u de Cyrus IMAP-beheerder op die toegang heeft tot alle IMAP-accounts op de server. Gebruik dit argument samen met --imap_admin_password.

Voorbeeld: --imap_admin_id="beheerder@example.com"

E-mailadres van Cyrus-beheerder

--imap_admin_password

Hiermee geeft u het wachtwoord op van de Cyrus IMAP-beheerder. Gebruik dit argument samen met --imap_admin_id.

Voorbeeld: --imap_admin_password="wachtwoord"

Wachtwoord van Cyrus-beheerder

--imap_path_prefix

Hiermee geeft u het padvoorvoegsel op voor gebruikersmappen op een IMAP-server.

Voer het padvoorvoegsel van de IMAP-mappen in dat gemeenschappelijk is voor alle mappen. Het padvoorvoegsel is meestal de IMAP-naamruimte voor de mapnamen. Als de IMAP-mapvermelding voor een gebruiker bijvoorbeeld INBOX, INBOX.Sent en INBOX.Drafts is, is INBOX het padvoorvoegsel. Veelgebruikte waarden voor padvoorvoegsels zijn INBOX voor Cyrus en Courier of geen (leeg veld) voor GroupWise IMAP, Gmail en Dovecot.

Voorbeeld: --imap_path_prefix="INBOX"

Padvoorvoegsel voor gebruikersmappen

--imap_port

Hiermee geeft u het poortnummer voor de IMAP-server op.

Voorbeeld: --imap_port="143"

Poortnummer

--imap_security

Hiermee geeft u de beveiligingsoptie op die u wilt gebruiken. Gebruik een van de volgende codes:

  • 0 (geen beveiliging)
  • 1 (SSL)
  • 2 (STARTTLS)

Voorbeeld: --imap_security="1"

Code met één cijfer

--imap_server_type

Hiermee geeft u het type IMAP-server op waarvan u migreert. Enkele servertypen zijn Exchange, GroupWise, Gmail, Cyrus, Courier, Dovecot, Zimbra en 'niet ondersteund'. Het standaardtype is 'niet ondersteund'.

Opmerking: Als u een onjuist servertype opgeeft, kan dit invloed hebben op de prestaties van de migratie.

Voorbeeld: --imap_server_type="Gmail"

Type IMAP-server

--migrate_to_vault

Hiermee wordt e-mail gemigreerd naar Google Vault. Berichten worden geüpload naar het account van de gebruiker en gemarkeerd als verwijderd. Er worden geen labels gemaakt in de inbox van de gebruiker.

De volgende beperkingen zijn van toepassing:

  • De bewaarregels in Google Vault bepalen hoelang het bericht wordt bewaard in Vault.
  • Als u naar Vault migreert, moet Gmail zijn ingeschakeld in de Beheerdersconsole. Als Gmail uitstaat, krijgt u 403-fouten.
  • De migratie naar gebruikers met een licentie voor Vault voor voormalige werknemers (VFE) mislukt omdat Gmail niet aanstaat voor deze gebruikers.
Geen parameter vereist

--migration_usernames

Hiermee geeft u de lijst met gebruikers op die moeten worden gemigreerd. Als u dit argument gebruikt, gebruik dan niet --filename.

Voorbeeld: --migration_usernames="gebruiker1,gebruiker2,gebruiker3"

Een door komma's gescheiden lijst met gebruikers (zet geen spaties tussen de items op de lijst)

N—Z

Argument en beschrijving Parameter

--noenable_calendar_migration

Hiermee wordt de migratie uitgevoerd met inbegrip van agendagegevens.

Geen parameter vereist

--noenable_contact_migration

Hiermee wordt de migratie uitgevoerd zonder contactgegevens.

Geen parameter vereist

--noenable_email_migration

Hiermee wordt de migratie uitgevoerd zonder e-mailgegevens.

Geen parameter vereist

--noenable_error_reports

Hiermee voorkomt u dat GWMME migratierapporten genereert met daarin eventuele berichtfouten die tijdens een migratie zijn opgetreden. Als u migratierapporten overslaat, kan de migratie beter presteren.

Ga naar het gedeelte Migratierapporten controleren in de Beheerdershandleiding van GWMME voor meer informatie over migratierapporten.

Geen parameter vereist

--noenable_id_mapping

Voert de migratie uit zonder dat een toewijzingsbestand nodig is. Alle toewijzingsgegevens worden opgegeven in de lijst met gebruikers als u het argument --id_mapping_file gebruikt.

Geen parameter vereist

--noenable_label_prefix

Hiermee geeft u op dat er geen voorvoegsel wordt toegevoegd aan labels bij migraties vanuit PST-bestanden. Standaard wordt de naam van het PST-bestand als voorvoegsel toegevoegd aan labels en agenda's die tijdens de migratie worden gemaakt.

Geen parameter vereist

--nouse_gui

Hiermee wordt GWMME uitgevoerd via de opdrachtregel. Standaard wordt de grafische gebruikersinterface (Graphical User Interface, GUI) gebruikt.

Geen parameter vereist

--nowait

Sluit GWMME zonder dat u op Enter hoeft te drukken als de migratie wordt uitgevoerd vanaf de opdrachtregel.

Geen parameter vereist

--num_threads

Hiermee geeft u het aantal gebruikers op dat u tegelijkertijd wilt migreren. Er wordt voor elke gebruiker een afzonderlijke thread geopend. De standaardwaarde is 25 threads.

Voorbeeld: --num_threads="20"

Aantal gebruikers

--pst_base_folder

Hiermee geeft u op welke directory de PST-bestanden voor migratie bevat. GWMME migreert alle PST-bestanden in de submappen van de opgegeven map.

Als u dit argument gebruikt, gebruik dan niet:

  • --source_server
  • --exchange_profile_name

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

Directory met de PST-bestanden

--public_folder_mapping_file

Hiermee geeft u de naam van het toewijzingsbestand op. Het toewijzingsbestand wijst de paden van de openbare Exchange-mappen toe aan e-mailadressen van Google Groepen. Zie Openbare mappen migreren voor meer informatie.

Voorbeeld: --public_folder_mapping_file="toewijzing_openbare_mappen.csv"

Naam van toewijzingsbestand in csv-indeling

--retry_count

Hiermee bepaal je het aantal nieuwe pogingen als er een tijdelijke fout optreedt, zoals een time-out vanwege een bezette server. De standaard is 10.

Voorbeeld: --retry_count="5"

Aantal nieuwe pogingen

--run_diagnostics

Voert de grondige premigratiediagnostiek uit, waarmee de serververbinding, verificatie, toegang tot accounts en de gehele gebruikerslijst wordt gevalideerd.

Geen parameter vereist

--service_account_json_path

Hiermee geeft u het pad op naar het bestand met de inloggegevens van het serviceaccount. Ga naar GWMME autoriseren voor uw account voor instructies om dit bestand te krijgen.

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

Het pad naar het bestand met de inloggegevens van het serviceaccount

--source_server

Hiermee wordt het IP-adres of de volledige domeinnaam van de Exchange- of IMAP-server aangegeven.

Gebruik dit in Exchange-migraties samen met --exchange_admin_login. Als u dit argument gebruikt, gebruik dan niet --exchange_profile_name.

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

IP-adres of volledig gekwalificeerde domeinnaam van de server

--strip_user_labels

Hiermee geeft u op dat berichten worden gemigreerd zonder labels.

Geen parameter vereist

--translate_conflicting_events

Geeft GWMME de opdracht om bestaande afspraken te bekijken die al zijn gemigreerd naar Google Agenda en de afspraken aan te passen door het e-mailadres van de Exchange-faciliteit te vertalen naar dat van de overeenkomende Google Workspace-faciliteit.

Veel beheerders kiezen ervoor gebruikers als eerste te migreren en agendafaciliteiten als tweede. Als u ervoor kiest agendafaciliteiten als tweede te migreren, moet u GWMME zo instellen dat de agendagegevens van de gebruikers opnieuw worden gemigreerd. Gebruik hiervoor --translate_conflicting_events.

Geen parameter vereist


Google, Google Workspace en gerelateerde merken en logo's zijn handelsmerken van Google LLC. Alle andere bedrijfs- en productnamen zijn handelsmerken van de bedrijven waarmee ze in verband worden gebracht.