使用命令行迁移数据

Google Workspace Migration for Microsoft Exchange

除了在 Windows 桌面设备上使用 Google Workspace Migration for Microsoft Exchange (GWMME) 之外,您还可以通过命令行界面运行 GWMME。

准备工作

打开命令提示符,然后输入 cd 命令,后跟 GWMME 安装位置,并用英文双引号括起来,例如 cd "C:\Program Files\Google\Google Workspace Migration"

默认位置如下:

  • C:\Program Files\Google\Google Workspace Migration(32 位系统)
  • C:\Program Files (x86)\Google\Google Workspace Migration(64 位系统)

系统可能会提示您输入 Exchange 管理员的用户名和密码。

迁移所需的命令

您应在一行中连续输入命令。显示换行符仅是为了方便阅读。

从 Exchange 迁移

示例 1:使用管理员配置文件进行迁移

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"

示例 2:使用服务器和管理员详细信息进行迁移

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"

如需详细了解如何转移 Exchange 数据,请参阅从 Exchange 中迁移数据

从 Google 账号或 IMAP 服务器迁移

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"

采用管理员模式从 Cyrus 中迁移时还会使用以下参数:

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

如需详细了解如何从 Google 账号或基于 IMAP 的账号转移电子邮件数据,请参阅从 Google 账号或 IMAP 迁移邮件

从 PST 文件中迁移

示例 1:将邮件迁移到 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"

示例 2:将邮件迁移到 Google 保险柜

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

如需详细了解如何转移 PST 文件,请参阅从 PST 文件中迁移数据

从公共文件夹迁移

示例 1:使用映射模式迁移公共文件夹(推荐)。此模式使用映射文件将公共文件夹映射到 Google 群组中的群组。由于群组电子邮件地址和公共文件夹名称通常不一致,因此大多数组织都会使用映射模式。

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

示例 2:使用默认模式迁移公共文件夹。在此模式下,您无需提供映射文件。而是比较文件夹和群组名称。如果公共文件夹名称与群组名称完全一致,映射就会成功建立。例如,TPS reports/tps-reports 会映射到群组 tps-reports@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

如需详细了解如何转移公共文件夹,请参阅从公共文件夹中迁移数据

所有 GWMME 实参

每行输入一个实参,在实参前面加上双短划线 (--)。某些实参需要添加参数值。输入参数值时,请以等号开头,并用双引号括住。

A—E

实参和说明 参数

--calendar_migration_end_date

指定要迁移的日历活动的结束日期。系统不会迁移在此日期之后发生的活动。

示例:--calendar_migration_end_date="2020-01-01"

YYYY-MM-DD 格式的日期

--calendar_migration_start_date

指定要迁移的日历活动的开始日期。系统不会迁移此日期之前的日历活动。

示例:--calendar_migration_start_date="2018-01-01"

YYYY-MM-DD 格式的日期

--custom_label_prefix

指定附加到 Gmail 中所有标签的前缀。

示例:--custom_label_prefix="已迁移-"

附加到标签的自定义前缀

--email_migration_end_date

指定要迁移的电子邮件的结束日期。系统不会迁移此日期之后的邮件。

示例:--email_migration_end_date="2020-01-01"

YYYY-MM-DD 格式的日期

--email_migration_start_date

指定要迁移的电子邮件的开始日期。系统不会迁移此日期之前的邮件。

示例:--email_migration_start_date="2018-01-01"

YYYY-MM-DD 格式的日期

--enable_calendar_fanout

为日历迁移启用日历活动扇出功能。

无参数值

--enable_hidden_folders_migration

启用迁移隐藏的 MAPI(Exchange 或 PST)文件夹的功能。

无参数值

--enable_imap

从 IMAP 服务器而非 Exchange 服务器中迁移。

无参数值

--enable_mbox_logging

启用 mbox 日志记录功能。由于 Gmail 文件大小或类型限制而无法迁移的邮件会写入用户专用的 mbox 文件。mbox 文件位于 GWMME 跟踪日志文件夹路径(例如,%localappdata%\Google\Google Apps Migration\Tracing\ExchangeMigration\mbox\user@domain.com.mbox)。

如需详细了解 Gmail 邮件限制,请参阅 Gmail 中屏蔽的文件类型

无参数值

--enable_public_folder_migration

启用 GWMME 迁移,从 Exchange 公共文件夹向 Google 群组迁移数据。有关详情,请参阅迁移公共文件夹

注意:您不能同时为用户和公共文件夹运行迁移。

无参数值

--enable_resource_migration

启用日历资源迁移。

无参数值

--exchange_admin_login

指定 Exchange 服务器管理员账号的登录名。请将此实参与“--source_server”搭配使用。

使用此参数时,请勿使用“--exchange_profile_name”。

示例:--exchange_admin_login="管理员"

Exchange 服务器管理员账号的登录名

--exchange_profile_name

指定用于连接到 Exchange 服务器的 Outlook 配置文件的名称。指定运行 GWMME 的同一台计算机上的管理员配置文件。如果您使用该实参,请勿使用:

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

示例:--exchange_profile_name="Exchange 迁移管理员"

现有 Outlook 配置文件的名称

--exclude_message_classes

根据邮件类别排除邮件。

如果您要排除归档解决方案中的已存根邮件,此实参就非常有用。GWMME 不支持重新迁移未存根的邮件。建议的方法是先排除已存根的邮件,然后等已存根邮件完全解除冻结后,再次运行 GWMME 迁移这些邮件。

示例:--exclude_message_classes="ipm.note.eas,ipm.note.1"

包含排除类别的逗号分隔列表(列表项之间无需空格)

--exclude_top_level_folders

根据文件夹名称排除顶级文件夹。

示例:--exclude_top_level_folders="已删除项,草稿"

包含顶级文件夹的逗号分隔列表(列表项之间无需空格)

F—M

实参和说明 参数

--filename

将属于 CSV 文件中指定的用户名的数据纳入范围。使用此实参时,请勿使用“--migration_usernames”。

示例:--filename="C:\Documents and Settings\users.csv"

包含用户名的 CSV 文件的路径

--force_clear_google_calendar_ids_on_remigration

请在重新迁移数据前,清除辅助日历的 ID。您重新迁移日历数据后,GWMME 会创建具有唯一 ID 的新辅助日历。执行此操作可以避免活动冲突。

注意:请在重新迁移数据前使用此实参。有关详情,请参阅重新迁移内容

无参数值

--force_restart

重新开始所有内容的迁移,而不只是尚未成功迁移的内容。

默认情况下,如果前一次运行迁移时发生中断,那么系统会从之前的中断处开始运行下一次迁移。您可以使用此参数从头开始运行迁移。如果您使用这种做法,就可以过滤掉重复的电子邮件,并忽略之前迁移的日历活动(但是某些情况下可能会重复),而之前迁移的联系人会重复。

无参数值

--google_admin

为日历资源设置活动所有者。对于没有所有者的活动,GWMME 会将指定的管理员设为活动所有者。此用户必须拥有资源日历的完整访问权限。

示例:--google_admin="admin@example.com"

日历资源的指定活动所有者的电子邮件地址

--google_domain

指定要迁移数据的 Google Workspace 网域。

示例:--google_domain="example.com"

Google Workspace 网域

--help

显示 ExchangeMigration.exe 的参数列表。

无参数值

--id_mapping_file

指定包含完整映射列表的文件的名称。使用包含了用户和日历地址映射的 CSV 映射文件。有关详情,请参阅为迁移创建 CSV 文件

示例:--id_mapping_file="resources.csv"

文件名

--imap_admin_id

指定有权访问服务器上所有 IMAP 账号的 Cyrus IMAP 管理员。请与“--imap_admin_password”搭配使用。

示例:--imap_admin_id="admin@example.com"

Cyrus 管理员的电子邮件地址

--imap_admin_password

指定 Cyrus IMAP 管理员的密码。请与“--imap_admin_id”搭配使用。

示例:--imap_admin_password="密码"

Cyrus 管理员的密码

--imap_path_prefix

指定 IMAP 服务器上的用户文件夹的路径前缀。

输入 IMAP 文件夹的路径前缀(所有文件夹的共同前缀)。路径前缀通常是文件夹名称的 IMAP 命名空间。例如,如果用户的 IMAP 文件夹的名称为 INBOX、INBOX.Sent 和 INBOX.Draft,则 INBOX 是路径前缀。对于 Cyrus 和 Courier,文件夹路径前缀的常用值为 INBOX;而 GroupWise IMAP、Gmail 和 Dovecot 的文件夹通常没有路径前缀(将字段留空)。

示例: --imap_path_prefix="INBOX"

用户文件夹的路径前缀

--imap_port

指定 IMAP 服务器的端口号。

示例:--imap_port="143"

端口号

--imap_security

指定您要使用的安全选项。请使用以下其中一个代码:

  • 0(无安全加密)
  • 1 (SSL)
  • 2 (STARTTLS)

示例:--imap_security="1"

1 位数代码

--imap_server_type

指定您要从中迁出数据的 IMAP 服务器的类型。服务器类型包括:Exchange、GroupWise、Gmail、Cyrus、Courier、Dovecot、Zimbra 和 unsupported(不受支持)。默认值为“unsupported”。

注意:如果您指定的服务器类型有误,则可能会影响迁移效果。

示例:--imap_server_type="Gmail"

IMAP 服务器的类型

--migrate_to_vault

将电子邮件迁移到 Google 保险柜。系统会将邮件上传到用户的账号中,并将其标记为已删除。但系统不会在用户的收件箱中创建任何标签。

请注意以下限制:

  • 邮件在保险柜中保留的时间取决于 Google 保险柜的保留规则
  • 如要将邮件迁移到保险柜,您必须在管理控制台中启用 Gmail。如果 Gmail 已停用,系统会显示 403 错误。
  • 无法将邮件迁移到获得离职员工专用保险柜 (VFE) 许可的用户,因为这些用户的 Gmail 已停用。
无参数值

--migration_usernames

指定要迁移的一系列用户。使用此实参时,请勿使用“--filename”。

示例:--migration_usernames="user1,user2,user3"

包含用户的逗号分隔列表(各项之间无需空格)

N-Z

实参和说明 参数

--noenable_calendar_migration

运行不包含日历数据的迁移。

无参数值

--noenable_contact_migration

运行不包含联系人数据的迁移。

无参数值

--noenable_email_migration

运行不包含电子邮件数据的迁移。

无参数值

--noenable_error_reports

禁止 GWMME 生成迁移报告,而迁移报告会显示迁移过程中出现的任何邮件相关错误。不生成迁移报告可以改善迁移效果。

如需详细了解迁移报告,请参阅 GWMME 管理员指南中的“查看迁移报告”(Viewing migration reports) 部分。

无参数值

--noenable_id_mapping

无需请求映射文件即可运行迁移。如果使用 --id_mapping_file 实参,则可以在用户列表中定义所有映射数据。

无参数值

--noenable_label_prefix

指定在从 PST 文件迁移时不向标签添加前缀。默认情况下,系统会将 PST 文件的名称作为前缀添加到迁移期间创建的标签和日历中。

无参数值

--nouse_gui

使用命令行运行 GWMME。默认使用的是图形界面 (GUI) 模式。

无参数值

--nowait

通过命令行运行迁移时,无需按 Enter 键即可关闭 GWMME。

无参数值

--num_threads

指定要同时迁移的用户数量。系统会分别为每位用户打开单独的会话。默认值为 25 个线程。

示例:--num_threads="20"

用户数量

--pst_base_folder

指定包含用于迁移的 PST 文件的目录。GWMME 可迁移指定文件夹的子文件夹中的所有 PST 文件。

如果您使用该实参,请勿使用:

  • --source_server
  • --exchange_profile_name

示例:--pst_base_folder="C:\pst"

包含 PST 文件的目录

--public_folder_mapping_file

指定映射文件名。映射文件会将 Exchange 公共文件夹路径映射到 Google 群组电子邮件地址。有关详情,请参阅迁移公共文件夹

示例:--public_folder_mapping_file="public_folder_mapping.csv"

CSV 格式的映射文件名

--retry_count

指定发生临时故障(例如繁忙服务器超时)时的重试次数。默认值为 10。

示例:--retry_count="5"

重试次数

--run_diagnostics

运行详尽的迁移前诊断,验证服务器的连通性、身份认证、账号访问以及整个用户列表。

无参数值

--service_account_json_path

指定服务账号凭据文件的路径。如需了解如何获取此文件,请参阅为您的账号授权 GWMME

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

服务账号凭据文件的路径

--source_server

指定 Exchange 或 IMAP 服务器 IP 地址或完全限定域名。

在 Exchange 迁移中,请将此参数与“--exchange_admin_login”搭配使用。使用此实参时,请勿使用“--exchange_profile_name”。

示例:--source_server="mailserver.example.com"

服务器 IP 地址或完全限定域名

--strip_user_labels

指定在迁移邮件时不使用标签。

无参数值

--translate_conflicting_events

让 GWMME 查看已迁移到 Google 日历的现有活动,并通过将 Exchange 资源的电子邮件地址转换为相匹配的 Google Workspace 资源的电子邮件地址来修改活动。

许多管理员选择先迁移用户,然后再迁移日历资源。如果您选择后迁移日历资源,请将 GWMME 设置为重新迁移用户的日历数据。您可以使用“--translate_conflicting_events”来完成此操作。

无参数值


Google、Google Workspace 以及相关标志和徽标是 Google LLC 的商标。其他所有公司名和产品名是其各自相关公司的商标。