Di chuyển dữ liệu bằng dòng lệnh

Google Workspace Migration for Microsoft Exchange

Ngoài việc sử dụng Google Workspace Migration for Microsoft Exchange (GWMME) trên máy tính Windows, bạn có thể chạy GWMME bằng giao diện dòng lệnh.

Trước khi bắt đầu

Mở dấu nhắc lệnh rồi nhập cd, theo sau là vị trí cài đặt GWMME trong dấu ngoặc kép, ví dụ: cd "C:\Program Files\Google\Google Workspace Migration".

Vị trí mặc định là:

  • C:\Program Files\Google\Google Workspace Migration (hệ thống 32 bit)
  • C:\Program Files (x86)\Google\Google Workspace Migration (hệ thống 64 bit)

Bạn có thể được nhắc nhập tên người dùng và mật khẩu quản trị viên Exchange.

Các lệnh bắt buộc để di chuyển

Bạn phải nhập các lệnh trên một dòng duy nhất liên tục. Mọi dấu ngắt dòng xuất hiện ở đây chỉ nhằm mục đích giúp bạn dễ đọc.

Di chuyển từ Exchange

Ví dụ 1: Di chuyển bằng hồ sơ quản trị viên

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"

Ví dụ 2: Di chuyển bằng thông tin chi tiết về máy chủ và quản trị viên

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"

Để biết thêm thông tin về cách chuyển dữ liệu từ Exchange, hãy xem bài viết Di chuyển dữ liệu từ Exchange.

Di chuyển từ Tài khoản Google hoặc máy chủ 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"

Đối với quá trình di chuyển ở chế độ quản trị viên từ Cyrus, hãy sử dụng:

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

Để biết thêm thông tin về cách chuyển dữ liệu email từ tài khoản Google hoặc tài khoản dựa trên IMAP, hãy xem bài viết Di chuyển thư từ Tài khoản Google hoặc IMAP.

Di chuyển từ tệp PST

Ví dụ 1: Di chuyển thư sang 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"

Ví dụ 2: Di chuyển thư sang 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

Để biết thêm thông tin về cách chuyển tệp PST, hãy xem bài viết Di chuyển dữ liệu từ tệp PST.

Di chuyển từ thư mục công khai

Ví dụ 1: Sử dụng chế độ liên kết để di chuyển thư mục công khai (nên dùng). Chế độ này sử dụng một tệp ánh xạ để ánh xạ thư mục công khai với nhóm trong Groups. Vì địa chỉ email nhóm thường không khớp với tên thư mục công khai, nên hầu hết các tổ chức đều sử dụng chế độ ánh xạ.

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

Ví dụ 2: Sử dụng chế độ mặc định để di chuyển thư mục công khai. Ở chế độ này, bạn không cần tệp ánh xạ. Thay vào đó, GWMME sẽ so sánh tên thư mục và tên nhóm. Mối liên kết được thiết lập khi tên thư mục công khai hoàn toàn khớp với tên nhóm. Ví dụ: Báo cáo TPS/tps-reports được ánh xạ đến nhóm 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

Để biết thêm thông tin về cách chuyển thư mục công khai, hãy xem bài viết Di chuyển từ thư mục công khai.

Tất cả đối số GWMME

Nhập một đối số trên một dòng và đặt dấu gạch ngang kép (--) trước đối số đó. Một số đối số yêu cầu các tham số bổ sung. Nhập các tham số đứng trước dấu bằng và nằm trong dấu ngoặc kép.

A – E

Đối số và nội dung mô tả Tham số

--calendar_migration_end_date

Chỉ định ngày kết thúc cho các sự kiện trên lịch mà bạn muốn di chuyển. Những sự kiện diễn ra sau ngày này sẽ không được di chuyển.

Ví dụ: --calendar_migration_end_date="2020-01-01"

Ngày theo định dạng YYYY-MM-DD

--calendar_migration_start_date

Chỉ định ngày bắt đầu cho các sự kiện trên lịch mà bạn muốn di chuyển. Các sự kiện trên lịch trước ngày này sẽ không được di chuyển.

Ví dụ: --calendar_migration_start_date="2018-01-01"

Ngày theo định dạng YYYY-MM-DD

--custom_label_prefix

Chỉ định tiền tố để đính kèm vào tất cả nhãn trong Gmail.

Ví dụ: --custom_label_prefix="migrated-"

Tiền tố tuỳ chỉnh được đính kèm vào nhãn

--email_migration_end_date

Chỉ định ngày kết thúc cho những thư bạn muốn di chuyển. Tin nhắn sau ngày này sẽ không được di chuyển

Ví dụ: --email_migration_end_date="2020-01-01"

Ngày theo định dạng YYYY-MM-DD

--email_migration_start_date

Chỉ định ngày bắt đầu cho những thư điện tử mà bạn muốn di chuyển. Tin nhắn trước ngày này sẽ không được di chuyển.

Ví dụ: --email_migration_start_date="2018-01-01"

Ngày theo định dạng YYYY-MM-DD

--enable_calendar_fanout

Cho phép phân đầu ra sự kiện trên lịch để di chuyển lịch.

Không yêu cầu tham số

--enable_hidden_folders_migration

Cho phép di chuyển thư mục MAPI (Exchange hoặc PST) bị ẩn.

Không yêu cầu tham số

--enable_imap

Cho phép di chuyển từ máy chủ IMAP thay vì từ máy chủ Exchange.

Không yêu cầu tham số

--enable_mbox_logging

Bật tính năng ghi nhật ký mbox. Những thư không thể di chuyển do các hạn chế về kích thước hoặc loại tệp của Gmail sẽ được ghi vào một tệp mbox dành riêng cho người dùng. Tệp mbox nằm trong đường dẫn thư mục ghi nhật ký theo dõi GWMME (ví dụ: %localappdata%\Google\Google Apps Migration\Tracing\ExchangeMigration\mbox\user@domain.com.mbox).

Để biết thông tin chi tiết về các quy định hạn chế đối với thư trong Gmail, hãy xem bài viết Các loại tệp bị Gmail chặn.

Không yêu cầu tham số

--enable_public_folder_migration

Cho phép di chuyển dữ liệu bằng GWMME từ thư mục công khai trên Exchange sang Google Groups. Để biết thông tin chi tiết, hãy xem bài viết Di chuyển thư mục công khai.

Lưu ý: Bạn không thể chạy quy trình di chuyển cho cả người dùng và thư mục công khai cùng một lúc.

Không yêu cầu tham số

--enable_resource_migration

Cho phép di chuyển tài nguyên lịch.

Không yêu cầu tham số

--exchange_admin_login

Chỉ định tên đăng nhập cho tài khoản quản trị viên máy chủ Exchange. Sử dụng đối số này cùng với --source_server.

Nếu bạn sử dụng đối số này, đừng sử dụng --exchange_profile_name.

Ví dụ: --exchange_admin_login="administrator"

Tên đăng nhập cho tài khoản quản trị viên của máy chủ Exchange

--exchange_profile_name

Chỉ định tên của hồ sơ Outlook mà bạn muốn dùng để kết nối với máy chủ Exchange. Chỉ định một hồ sơ quản trị viên trên cùng một máy chạy GWMME. Nếu bạn sử dụng đối số này, đừng sử dụng:

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

Ví dụ: --exchange_profile_name="exch_migration_admin"

Tên của một hồ sơ Outlook hiện có

--exclude_message_classes

Loại trừ các thông báo dựa trên lớp thông báo.

Đối số này hữu ích khi loại trừ các thông báo được thay thế bằng nội dung giữ chỗ khỏi một giải pháp lưu trữ. GWMME không hỗ trợ di chuyển lại các thư chưa được thay thế bằng nội dung giữ chỗ. Phương pháp được đề xuất là loại trừ các thư được thay thế bằng nội dung giả, sau đó, khi các thư này được khôi phục hoàn toàn, hãy di chuyển các thư trong lần chạy thứ hai của GWMME.

Ví dụ: --exclude_message_classes="ipm.note.eas,ipm.note.1"

Danh sách các lớp bị loại trừ được phân tách bằng dấu phẩy (không có dấu cách giữa các mục trong danh sách)

--exclude_top_level_folders

Loại trừ các thư mục cấp cao nhất dựa trên tên thư mục.

Ví dụ: --exclude_top_level_folders="Deleted Items,Drafts"

Danh sách các thư mục cấp cao nhất được phân tách bằng dấu phẩy (không có dấu cách giữa các mục trong danh sách)

F – M

Đối số và nội dung mô tả Tham số

--filename

Bao gồm dữ liệu thuộc về những tên người dùng được chỉ định trong tệp CSV. Nếu bạn sử dụng đối số này, đừng sử dụng --migration_usernames.

Ví dụ: --filename="C:\Documents and Settings\users.csv"

Đường dẫn đến tệp CSV chứa tên người dùng

--force_clear_google_calendar_ids_on_remigration

Xoá mã nhận dạng của lịch phụ trước khi bạn di chuyển lại dữ liệu. Khi bạn di chuyển lại dữ liệu lịch, GWMME sẽ tạo các lịch phụ mới có mã nhận dạng riêng biệt. Việc này giúp tránh xung đột sự kiện.

Lưu ý: Hãy sử dụng đối số này trước khi di chuyển lại dữ liệu. Để biết thông tin chi tiết, hãy xem bài viết Di chuyển lại nội dung.

Không yêu cầu tham số

--force_restart

Chạy lại quy trình di chuyển trên tất cả các mục, thay vì chỉ chạy trên những mục không di chuyển được.

Theo mặc định, nếu quá trình di chuyển bị gián đoạn, thì quá trình di chuyển tiếp theo sẽ bắt đầu tại thời điểm mà quá trình di chuyển trước đó dừng lại. Bạn có thể dùng tham số này để chạy lại quy trình di chuyển từ đầu. Nếu bạn sử dụng lựa chọn này, email trùng lặp sẽ bị lọc, các sự kiện trên lịch đã di chuyển trước đó sẽ bị bỏ qua (nhưng có thể bị trùng lặp trong một số trường hợp) và các danh bạ đã di chuyển trước đó sẽ bị trùng lặp.

Không yêu cầu tham số

--google_admin

Đặt chủ sở hữu sự kiện cho tài nguyên trên lịch. Nếu một sự kiện không có chủ sở hữu, GWMME sẽ đặt quản trị viên được chỉ định làm chủ sở hữu sự kiện. Người dùng phải có toàn quyền truy cập vào lịch tài nguyên.

Ví dụ: --google_admin="admin@example.com"

Địa chỉ email của chủ sở hữu sự kiện được đề cử cho lịch tài nguyên

--google_domain

Chỉ định miền Google Workspace mà bạn đang di chuyển dữ liệu.

Ví dụ: --google_domain="example.com"

Miền Google Workspace

--help

Hiển thị danh sách các đối số cho ExchangeMigration.exe.

Không yêu cầu tham số

--id_mapping_file

Chỉ định tên của tệp có danh sách liên kết hoàn chỉnh. Sử dụng tệp liên kết CSV chứa thông tin liên kết địa chỉ người dùng và lịch. Để biết thông tin chi tiết, hãy xem bài viết Tạo tệp CSV cho quá trình di chuyển.

Ví dụ: --id_mapping_file="resources.csv"

Tên tệp

--imap_admin_id

Chỉ định quản trị viên Cyrus IMAP có quyền truy cập vào tất cả tài khoản IMAP trên máy chủ. Sử dụng với --imap_admin_password.

Ví dụ: --imap_admin_id="admin@example.com"

Địa chỉ email của quản trị viên Cyrus

--imap_admin_password

Chỉ định mật khẩu của quản trị viên Cyrus IMAP. Sử dụng với --imap_admin_id.

Ví dụ: --imap_admin_password="password"

Mật khẩu của quản trị viên Cyrus

--imap_path_prefix

Chỉ định tiền tố đường dẫn cho các thư mục người dùng trên máy chủ IMAP.

Nhập tiền tố đường dẫn của các thư mục IMAP thường gặp. Tiền tố đường dẫn thường là không gian tên IMAP cho tên thư mục. Ví dụ: nếu danh sách thư mục IMAP của một người dùng là INBOX, INBOX.Sent và INBOX.Drafts, thì INBOX là tiền tố đường dẫn. Các giá trị điển hình của tiền tố đường dẫn là INBOX cho Cyrus và Courier hoặc không có giá trị nào (để trống trường) cho GroupWise IMAP, Gmail và Dovecot.

Ví dụ: --imap_path_prefix="INBOX"

Tiền tố đường dẫn cho thư mục người dùng

--imap_port

Chỉ định số cổng cho máy chủ IMAP.

Ví dụ: --imap_port="143"

Số cổng

--imap_security

Chỉ định lựa chọn bảo mật mà bạn muốn sử dụng. Sử dụng một trong các mã sau:

  • 0 (không có biện pháp bảo mật)
  • 1 (SSL)
  • 2 (STARTTLS)

Ví dụ: --imap_security="1"

Mã gồm một chữ số

--imap_server_type

Chỉ định loại máy chủ IMAP mà bạn sẽ di chuyển. Các loại máy chủ là Exchange, GroupWise, Gmail, Cyrus, Courier, Dovecot, Zimbra và không được hỗ trợ. Giá trị mặc định không được hỗ trợ.

Lưu ý: Nếu bạn chỉ định loại máy chủ không chính xác, hiệu suất của quá trình di chuyển có thể bị ảnh hưởng.

Ví dụ: --imap_server_type="Gmail"

Loại máy chủ IMAP

--migrate_to_vault

Di chuyển email sang Google Vault. Thư được tải lên tài khoản của người dùng và được đánh dấu là đã xoá. Nhãn không được tạo trong hộp thư đến của người dùng.

Hãy lưu ý những hạn chế sau:

  • Quy tắc lưu giữ của Google Vault xác định thời gian lưu giữ tin nhắn trong Vault.
  • Nếu đang di chuyển sang Vault, bạn phải bật Gmail trong Bảng điều khiển dành cho quản trị viên. Nếu Gmail đang tắt, bạn sẽ thấy lỗi 403.
  • Quá trình di chuyển sang người dùng được cấp phép Vault Former Employee (VFE) sẽ không thành công vì Gmail chưa được bật cho những người dùng này.
Không yêu cầu tham số

--migration_usernames

Chỉ định danh sách người dùng cần di chuyển. Nếu bạn sử dụng đối số này, đừng sử dụng --filename.

Ví dụ: --migration_usernames="user1,user2,user3"

Danh sách người dùng được phân tách bằng dấu phẩy (không có dấu cách giữa các mục)

N – Z

Đối số và nội dung mô tả Tham số

--noenable_calendar_migration

Chạy quy trình di chuyển mà không bao gồm dữ liệu lịch.

Không yêu cầu tham số

--noenable_contact_migration

Chạy quy trình di chuyển mà không bao gồm dữ liệu liên hệ.

Không yêu cầu tham số

--noenable_email_migration

Chạy quy trình di chuyển mà không bao gồm dữ liệu email.

Không yêu cầu tham số

--noenable_error_reports

Ngăn GWMME tạo báo cáo di chuyển. Báo cáo này cho biết mọi lỗi về thư xảy ra trong quá trình di chuyển. Việc bỏ qua báo cáo di chuyển có thể cải thiện hiệu suất của quá trình di chuyển.

Để biết thêm thông tin về báo cáo di chuyển, hãy chuyển đến phần Xem xét báo cáo di chuyển trong Hướng dẫn dành cho quản trị viên GWMME.

Không yêu cầu tham số

--noenable_id_mapping

Chạy quy trình di chuyển mà không cần tệp ánh xạ. Tất cả dữ liệu liên kết đều được xác định trong danh sách người dùng nếu bạn sử dụng đối số --id_mapping_file.

Không yêu cầu tham số

--noenable_label_prefix

Chỉ định rằng tiền tố sẽ không được thêm vào nhãn khi di chuyển từ tệp PST. Theo mặc định, tên của tệp PST sẽ được thêm làm tiền tố vào nhãn và lịch được tạo trong quá trình di chuyển.

Không yêu cầu tham số

--nouse_gui

Chạy GWMME bằng dòng lệnh. Chế độ giao diện người dùng đồ hoạ (GUI) là chế độ mặc định.

Không yêu cầu tham số

--nowait

Đóng GWMME mà bạn không cần nhấn phím Enter khi chạy quy trình di chuyển qua dòng lệnh.

Không yêu cầu tham số

--num_threads

Chỉ định số lượng người dùng bạn muốn di chuyển đồng thời. Một luồng riêng biệt sẽ được mở cho mỗi người dùng. Giá trị mặc định là 25 luồng.

Ví dụ: --num_threads="20"

Số lượng người dùng

--pst_base_folder

Chỉ định thư mục chứa các tệp PST để di chuyển. GWMME sẽ di chuyển tất cả các tệp PST trong các thư mục con của thư mục được chỉ định.

Nếu bạn sử dụng đối số này, đừng sử dụng:

  • --source_server
  • --exchange_profile_name

Ví dụ: --pst_base_folder="C:\pst"

Thư mục chứa các tệp PST

--public_folder_mapping_file

Chỉ định tên tệp ánh xạ. Tệp liên kết sẽ liên kết đường dẫn thư mục công khai của Exchange với địa chỉ email của Google Groups. Để biết thông tin chi tiết, hãy xem bài viết Di chuyển thư mục công khai.

Ví dụ: --public_folder_mapping_file="public_folder_mapping.csv"

Tên tệp ánh xạ ở định dạng CSV

--retry_count

Chỉ định số lần thử lại nếu xảy ra lỗi tạm thời, chẳng hạn như hết thời gian chờ máy chủ bận. Giá trị mặc định là 10.

Ví dụ: --retry_count="5"

Số lần thử lại

--run_diagnostics

Chạy quy trình chẩn đoán toàn diện trước khi di chuyển, quy trình này xác thực khả năng kết nối máy chủ, hoạt động xác thực, quyền truy cập vào tài khoản và toàn bộ danh sách người dùng.

Không yêu cầu tham số

--service_account_json_path

Chỉ định đường dẫn đến tệp thông tin đăng nhập tài khoản dịch vụ. Để biết hướng dẫn về cách lấy tệp này, hãy xem bài viết Uỷ quyền cho GWMME đối với tài khoản của bạn.

Ví dụ: --service_account_json_path ="C:\Users\admin\privatekey.json"

Đường dẫn đến tệp thông tin đăng nhập của tài khoản dịch vụ

--source_server

Chỉ định địa chỉ IP hoặc tên miền đủ điều kiện của máy chủ Exchange hoặc IMAP.

Trong quá trình di chuyển Exchange, hãy sử dụng tham số này cùng với --exchange_admin_login. Nếu bạn sử dụng đối số này, đừng sử dụng --exchange_profile_name.

Ví dụ: --source_server="mailserver.example.com"

Địa chỉ IP máy chủ hoặc tên miền đủ điều kiện

--strip_user_labels

Chỉ định rằng thư được di chuyển mà không có nhãn.

Không yêu cầu tham số

--translate_conflicting_events

Hướng dẫn GWMME xem xét các sự kiện hiện có đã được di chuyển sang Lịch Google và sửa đổi các sự kiện bằng cách dịch địa chỉ email của tài nguyên Exchange sang địa chỉ email của tài nguyên Google Workspace tương ứng.

Nhiều quản trị viên chọn di chuyển người dùng trước và tài nguyên lịch sau. Nếu bạn chọn di chuyển tài nguyên lịch vào lần thứ hai, hãy định cấu hình GWMME để di chuyển lại dữ liệu lịch của người dùng. Bạn có thể thực hiện việc này bằng cách sử dụng --translate_conflicting_events.

Không yêu cầu tham số


Google, Google Workspace cũng như những nhãn hiệu và biểu trưng có liên quan là nhãn hiệu của Google LLC. Tất cả các tên sản phẩm và công ty khác là nhãn hiệu của những công ty mà chúng liên kết.