除了在 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="2020-01-01" |
以 YYYY-MM-DD 格式顯示的日期 |
|
針對您要遷移的日曆活動指定開始日期。系統不會遷移這個日期之前的任何日曆活動。 範例:--calendar_migration_start_date="2018-01-01" |
以 YYYY-MM-DD 格式顯示的日期 |
|
指定要附加至所有 Gmail 標籤的前置字串。 範例:--custom_label_prefix="migrated-" |
附加至標籤的自訂前置字串 |
|
針對您要遷移的電子郵件指定結束日期。系統不會遷移這個日期之後的郵件。 範例:--email_migration_end_date="2020-01-01" |
以 YYYY-MM-DD 格式顯示的日期 |
|
針對您要遷移的電子郵件指定開始日期。系統不會遷移這個日期之前的郵件。 範例:--email_migration_start_date="2018-01-01" |
以 YYYY-MM-DD 格式顯示的日期 |
|
為日曆遷移作業啟用日曆活動擴散傳遞功能。 |
不需要參數 |
|
啟用隱藏的 MAPI (Exchange 或 PST) 資料夾遷移作業。 |
不需要參數 |
|
允許從 IMAP 伺服器執行遷移作業 (而非從 Exchange 伺服器)。 |
不需要參數 |
|
啟用 mbox 記錄功能。因 Gmail 檔案大小或類型限制而無法遷移的郵件,會寫入使用者專屬的 mbox 檔案內。mbox 檔案位於 GWMME 追蹤記錄資料夾路徑,例如 %localappdata%\Google\Google Apps Migration\Tracing\ExchangeMigration\mbox\user@domain.com.mbox。 如要進一步瞭解 Gmail 郵件限制,請參閱「Gmail 封鎖的檔案類型」。 |
不需要參數 |
|
啟用 GWMME 遷移功能,將資料從 Exchange 公用資料夾遷移至 Google 網路論壇。詳情請參閱「遷移公用資料夾」。 注意:您無法同時執行使用者和公用資料夾的遷移作業。 |
不需要參數 |
|
允許遷移日曆資源。 |
不需要參數 |
|
指定 Exchange 伺服器管理員帳戶的登入名稱。請將這個引數與 --source_server 搭配使用。 範例:--exchange_admin_login="administrator" |
Exchange 伺服器管理員帳戶的登入名稱 |
|
指定連線至 Exchange 伺服器所使用的 Outlook 設定檔名稱,在執行 GWMME 的電腦上指定管理員設定檔。加入這個引數時,請勿使用:
範例:--exchange_profile_name="exch_migration_admin" |
現有 Outlook 設定檔的名稱 |
|
根據郵件類別排除郵件。 如要排除封存解決方案產生的虛設常式郵件,這個引數就能派上用場。GWMME 不支援重新遷移非虛設常式郵件。建議您排除虛設常式郵件,待虛設常式郵件完全解除凍結後,再透過執行 GWMME 遷移這些郵件。 範例:--exclude_message_classes="ipm.note.eas,ipm.note.1" |
以半形逗號分隔的排除類別清單 (清單項目之間不得包含空格) |
|
根據資料夾名稱排除頂層資料夾。 範例:--exclude_top_level_folders="Deleted Items,Drafts" |
以逗號分隔的頂層資料夾清單 (清單項目之間不得包含空格) |
F—M
| 引數和說明 | 參數 |
|---|---|
|
將屬於 CSV 檔案中指定使用者名稱的資料納入範圍。加入這個引數時,請勿使用 --migration_usernames。 範例:--filename="C:\Documents and Settings\users.csv" |
使用者名稱的 CSV 檔案路徑 |
|
用於在重新遷移資料前,清除次要日曆的 ID。重新遷移日曆資料時,GWMME 會建立新的次要日曆以及專屬 ID,以免活動發生衝突。 注意:請在重新遷移資料之前使用這個引數。詳情請參閱「重新遷移內容」。 |
不需要參數 |
|
所有項目重新開始遷移,而非只處理尚未成功遷移的項目。 預設狀態下,如果遷移程序中斷,再次執行遷移時,系統會從上次停止的地方繼續執行。您可以使用這個參數從頭開始重新遷移。如果使用這個做法,系統會過濾掉重複的電子郵件並忽略先前遷移的日曆活動 (某些情況下還是可能出現重複的活動),但先前遷移的聯絡人資料仍會重複。 |
不需要參數 |
|
為日曆資源設定活動擁有者。如果活動沒有擁有者,GWMME 會將指定的管理員設為活動擁有者。該使用者必須擁有日曆資源的完整存取權限。 範例:--google_admin="admin@example.com" |
針對日曆資源指定的活動擁有者的電子郵件地址 |
|
指定資料遷移前所在的 Google Workspace 網域。 範例:--google_domain="example.com" |
Google Workspace 網域 |
|
顯示 ExchangeMigration.exe 的所有引數清單。 |
不需要參數 |
|
指定擁有完整對應清單的檔案名稱。使用包含使用者和日曆地址對應的 CSV 對應檔。詳情請參閱「為遷移作業建立 CSV 檔案」。 範例:--id_mapping_file="resources.csv" |
檔案名稱 |
|
指定擁有伺服器上所有 IMAP 帳戶存取權的 Cyrus IMAP 管理員,請與 --imap_admin_password 搭配使用。 範例:--imap_admin_id="admin@example.com" |
Cyrus 管理員的電子郵件地址 |
|
指定 Cyrus IMAP 管理員的密碼,請與 --imap_admin_id 搭配使用。 範例:--imap_admin_password="password" |
Cyrus 管理員的密碼 |
|
指定 IMAP 伺服器中使用者資料夾的路徑前置字串。 輸入所有資料夾的通用 IMAP 資料夾路徑前置字串,這通常是資料夾名稱的 IMAP 命名空間。舉例來說,如果使用者的 IMAP 資料夾資訊是 INBOX、INBOX.Sent 和 INBOX.Drafts,那麼 INBOX 就是路徑前置字串。一般路徑前置字串的值:如果是 Cyrus 和 Courier,值就是 INBOX;如果是 GroupWise IMAP、Gmail 和 Dovecot,則值為無 (欄位留空)。 範例:--imap_path_prefix="INBOX" |
使用者資料夾的路徑前置字串 |
|
指定 IMAP 伺服器的通訊埠號碼。 範例:--imap_port="143" |
通訊埠編號 |
|
指定要使用的安全性選項。請使用下列其中一個代碼:
範例:--imap_security="1" |
個位數代碼 |
|
指定遷移來源的 IMAP 伺服器類型,包括:Exchange、GroupWise、Gmail、Cyrus、Courier、Dovecot、Zimbra 和 unsupported (未支援)。預設類型為「unsupported」。 注意:如果指定的伺服器類型有誤,可能會影響遷移效能。 範例:--imap_server_type="Gmail" |
IMAP 伺服器類型 |
|
將電子郵件遷移至 Google 保管箱。郵件會上傳至使用者的帳戶,並標記為已刪除。系統不會在使用者的收件匣中建立任何標籤。 請注意下列限制:
|
不需要參數 |
|
指定要遷移的使用者清單。加入這個引數時,請勿使用 --filename。 範例:--migration_usernames="user1,user2,user3" |
以逗號分隔的使用者清單 (項目之間不得包含空格) |
N—Z
| 引數和說明 | 參數 |
|---|---|
|
執行遷移,但不包括日曆資料。 |
不需要參數 |
|
執行遷移,但不包括聯絡人資料。 |
不需要參數 |
|
執行遷移,但不包括電子郵件資料。 |
不需要參數 |
|
禁止 GWMME 產生遷移報告,避免顯示遷移期間發生的郵件相關錯誤。略過遷移報告可以提升遷移效能。 |
不需要參數 |
|
在沒有對應檔的情況下執行遷移作業。只要使用 --id_mapping_file 引數,所有對應資料都會定義在使用者清單中。 |
不需要參數 |
|
指明透過 PST 檔案執行遷移作業時,不要在標籤前加上任何前置字串。根據預設,PST 檔案名稱會以前置字串的形式新增至遷移期間建立的標籤及日曆。 |
不需要參數 |
|
使用指令列執行 GWMME。預設模式為圖形使用者介面 (GUI) 模式。 |
不需要參數 |
|
透過指令列進行遷移時,不需按 Enter 鍵即可關閉 GWMME。 |
不需要參數 |
|
指定要同時遷移的使用者人數。系統會為每位使用者開啟獨立的執行緒。預設值為 25 個執行緒。 範例:--num_threads="20" |
使用者人數 |
|
指定包含遷移作業所用 PST 檔案的目錄。GWMME 會遷移指定資料夾中子資料夾的所有 PST 檔案。 加入這個引數時,請勿使用:
範例:--pst_base_folder="C:\pst" |
包含 PST 檔案的目錄 |
|
指定對應檔名稱。對應檔會將 Exchange 公用資料夾路徑對應至 Google 網路論壇電子郵件地址。詳情請參閱「遷移公用資料夾」。 範例:--public_folder_mapping_file="public_folder_mapping.csv" |
對應檔名稱 (CSV 格式) |
|
指定發生暫時性問題 (例如伺服器忙碌或逾時) 時,要重試多少次後才放棄連線。預設值為 10。 範例:--retry_count="5" |
重試次數 |
|
執行全面性的預先遷移診斷程序,包括確認伺服器連線能力、驗證狀態、帳戶存取權及完整的使用者清單。 |
不需要參數 |
|
指定服務帳戶憑證檔案的路徑。如需如何取得這個檔案的操作說明,請參閱「為您的帳戶授權 GWMME」。 範例:--service_account_json_path ="C:\Users\admin\privatekey.json" |
服務帳戶憑證檔案的路徑 |
|
指定 Exchange/IMAP 伺服器 IP 位址或完整網域名稱。 在 Exchange 遷移作業中,這個引數可與 --exchange_admin_login 搭配使用。加入這個引數時,請勿使用 --exchange_profile_name。 範例:--source_server="mailserver.example.com" |
伺服器 IP 位址或完整網域名稱 |
|
指明遷移郵件時無需包括標籤。 |
不需要參數 |
|
指示 GWMME 查詢已遷移至 Google 日曆的現有活動,並將 Exchange 資源的電子郵件地址轉換成對應 Google Workspace 資源的電子郵件地址,藉此修改日曆活動。 許多管理員會選擇先遷移使用者,然後再遷移日曆資源。如果您選擇不要先遷移日曆資源,請將 GWMME 設定為重新遷移使用者的日曆資料。您可以使用 --translate_conflicting_events 引數來執行這項動作。 |
不需要參數 |
Google、Google Workspace 和其他相關符號及標誌均為 Google LLC 的商標。所有其他公司和產品名稱則是與個別公司關聯的商標。