使用命令行迁移数据

除了在 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：使用映射模式迁移公共文件夹（推荐）。此模式使用映射文件将公共文件夹映射到网上论坛中的群组。由于群组电子邮件地址和公共文件夹名称通常不一致，因此大多数单位都会使用映射模式。

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：使用默认模式迁移公共文件夹。此模式下不需要映射文件。GWMME 会改为比较文件夹名称和群组名称。如果公共文件夹名称与群组名称完全一致，映射就会成功建立。例如，TPS reports/tps-reports 映射到群组 [e-mail]。

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\[e-mail]）。 要详细了解 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="[e-mail]"	日历资源的指定活动所有者的电子邮件地址
--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="[e-mail]"	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="用户1,用户2,用户3"	包含用户的逗号分隔列表（各项之间无需空格）

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="公共文件夹映射.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 的商标。其他所有公司名和产品名是其各自相关公司的商标。}