使用指令列遷移資料

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:使用對應模式遷移公用資料夾 (建議做法)。這個模式會使用對應檔案,將公用資料夾對應至網路論壇中的群組。群組電子郵件地址通常不會與公用資料夾名稱完全一致,因此大多數機構都選擇採用對應模式。

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 對應至 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="migrated-"

附加至標籤的自訂前置字串

--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="administrator"

Exchange 伺服器管理員帳戶的登入名稱

--exchange_profile_name

指定連線至 Exchange 伺服器所使用的 Outlook 設定檔名稱,在執行 GWMME 的電腦上指定管理員設定檔。加入這個引數時,請勿使用:

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

範例:--exchange_profile_name="exch_migration_admin"

現有 Outlook 設定檔的名稱

--exclude_message_classes

根據郵件類別排除郵件。

如要排除封存解決方案產生的虛設常式郵件,這個引數就能派上用場。GWMME 不支援重新遷移非虛設常式郵件。建議您排除虛設常式郵件,待虛設常式郵件完全解除凍結後,再透過執行 GWMME 遷移這些郵件。

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

以半形逗號分隔的排除類別清單 (清單項目之間不得包含空格)

--exclude_top_level_folders

根據資料夾名稱排除頂層資料夾。

範例:--exclude_top_level_folders="Deleted Items,Drafts"

以逗號分隔的頂層資料夾清單 (清單項目之間不得包含空格)

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="password"

Cyrus 管理員的密碼

--imap_path_prefix

指定 IMAP 伺服器中使用者資料夾的路徑前置字串。

輸入所有資料夾的通用 IMAP 資料夾路徑前置字串,這通常是資料夾名稱的 IMAP 命名空間。舉例來說,如果使用者的 IMAP 資料夾資訊是 INBOX、INBOX.Sent 和 INBOX.Drafts,那麼 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"

個位數代碼

--imap_server_type

指定遷移來源的 IMAP 伺服器類型,包括:Exchange、GroupWise、Gmail、Cyrus、Courier、Dovecot、Zimbra 和 unsupported (未支援)。預設類型為「unsupported」。

注意:如果指定的伺服器類型有誤,可能會影響遷移效能。

範例:--imap_server_type="Gmail"

IMAP 伺服器類型

--migrate_to_vault

將電子郵件遷移至 Google 保管箱。郵件會上傳至使用者的帳戶,並標記為已刪除。系統不會在使用者的收件匣中建立任何標籤。

請注意下列限制:

  • Google 保管箱保留規則將決定郵件保留在保管箱中的時間長短。
  • 您必須在管理控制台中啟用 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 管理指南的「Reviewing 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 的商標。所有其他公司和產品名稱則是與個別公司關聯的商標。