Как перенести данные, используя командную строку

Google Workspace Migration for Microsoft Exchange

Помимо использования Google Workspace Migration for Microsoft Exchange (GWMME) на компьютере с ОС Windows, вы можете запустить GWMME с помощью интерфейса командной строки.

Подготовка

Откройте командную строку и введите cd, а затем укажите место установки GWMME в двойных кавычках, например cd "C:\Program Files\Google\Google Workspace Migration".

По умолчанию для установки используются следующие пути:

  • C:\Program Files\Google\Google Workspace Migration (32-bit system)
  • 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…

Перенос из аккаунта 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…

Перенос данных из 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-файлов…

Перенос данных из общих папок

Пример 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 сравнивает названия папок и групп и автоматически сопоставляет папки и группы с идентичными названиями. Например, папка otchety_TPS/otchety_tps будет сопоставлена с группой otchety_tps@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

Вводите каждый аргумент в новой строке и добавляйте перед ним двойной дефис (--). Для некоторых аргументов нужны дополнительные параметры. Введите параметры, перед которыми стоит знак равенства и которые заключены в двойные кавычки.

А–Е

Аргумент и описание Параметр

--calendar_migration_end_date

Указывает дату окончания временного диапазона для переноса мероприятий календаря. Мероприятия, происходившие после этой даты, перенесены не будут.

Пример: --calendar_migration_end_date="2020-01-01"

Дата в формате ГГГГ-ММ-ДД

--calendar_migration_start_date

Указывает дату начала временного диапазона для переноса мероприятий календаря. Мероприятия, происходившие до этой даты, перенесены не будут.

Пример: --calendar_migration_start_date="2018-01-01"

Дата в формате ГГГГ-ММ-ДД

--custom_label_prefix

Указывает префикс, который будет добавлен ко всем ярлыкам в Gmail.

Пример: --custom_label_prefix="migrated-"

Особый префикс, который нужно добавить к ярлыкам

--email_migration_end_date

Указывает дату окончания временного диапазона для переноса сообщений электронной почты. Сообщения, отправленные и полученные после этой даты, перенесены не будут.

Пример: --email_migration_end_date="2020-01-01"

Дата в формате ГГГГ-ММ-ДД

--email_migration_start_date

Указывает дату начала временного диапазона для переноса сообщений электронной почты. Сообщения, отправленные и полученные до этой даты, перенесены не будут.

Пример: --email_migration_start_date="2018-01-01"

Дата в формате ГГГГ-ММ-ДД

--enable_calendar_fanout

Включает добавление мероприятия в календари его участников при переносе.

Указывать параметры не нужно

--enable_hidden_folders_migration

Позволяет переносить скрытые папки MAPI (Exchange или PST).

Указывать параметры не нужно

--enable_imap

Позволяет переносить данные с сервера IMAP, а не с сервера Microsoft Exchange Server.

Указывать параметры не нужно

--enable_mbox_logging

Включает ведение журналов MBOX. Сообщения, которые невозможно перенести из-за ограничений Gmail по размеру и типу файла, записываются в специальный файл в формате MBOX. Он хранится в папке журнала трассировки GWMME (пример пути: %localappdata%\Google\Google Workspace Migration\Tracing\ExchangeMigration\mbox\user@domain.com.mbox).

Подробнее о том, какие типы файлов блокируются в Gmail…

Указывать параметры не нужно

--enable_public_folder_migration

Позволяет перенести общие папки с сервера Exchange в Google Группы. Подробнее…

Примечание. Данные пользователей и общие папки нельзя перенести одновременно.

Указывать параметры не нужно

--enable_resource_migration

Включает перенос ресурсов календаря.

Указывать параметры не нужно

--exchange_admin_login

Указывает имя для входа в аккаунт администратора сервера Exchange. Используйте этот аргумент вместе с --source_server.

Если вы используете этот аргумент, не используйте --exchange_profile_name.

Пример: --exchange_admin_login="administrator"

Имя для входа в аккаунт администратора сервера Exchange

--exchange_profile_name

Указывает имя профиля Outlook, который следует использовать для подключения к серверу Exchange. Укажите профиль администратора на том же компьютере, на котором запущен инструмент 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"

Список папок верхнего уровня, разделенных запятыми (без пробелов между элементами списка)

Ж—М

Аргумент и описание Параметр

--filename

Включает данные пользователей, указанных в CSV-файле. Если вы используете этот аргумент, не используйте --migration_usernames.

Пример: --filename="C:\Documents and Settings\users.csv"

Путь к CSV-файлу с именами пользователей

--force_clear_google_calendar_ids_on_remigration

Удаляет идентификаторы дополнительных календарей перед повторным переносом данных. Когда вы выполняете повторный перенос данных календарей, GWMME создает новые дополнительные календари с уникальными идентификаторами. Это позволяет избежать конфликтов мероприятий.

Примечание. Используйте этот аргумент перед повторным переносом данных. Подробнее…

Указывать параметры не нужно

--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

Указывает администратора Cyrus IMAP, имеющего доступ ко всем аккаунтам 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 Сейф. Письма загружаются в аккаунт пользователя и отмечаются как удаленные. Ярлыки не создаются в папке "Входящие".

Обратите внимание на ограничения:

  • Срок хранения сообщения определяется правилами Сейфа.
  • Для переноса сообщений в Сейф необходимо включить Gmail в консоли администратора, Если Gmail отключен, вы увидите ошибки 403.
  • Перенос данных для пользователей с лицензией "Сейф для аккаунтов бывших сотрудников" завершится неудачно, поскольку для этих пользователей не включен сервис 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 для администраторов.

Указывать параметры не нужно

--noenable_id_mapping

Выполняет перенос данных без файла сопоставления. Все данные определяются в списке пользователей с помощью аргумента --id_mapping_file.

Указывать параметры не нужно

--noenable_label_prefix

Указывает, что при переносе из PST-файлов к ярлыкам не будет добавлен префикс. По умолчанию название PST-файла добавляется в виде префикса к ярлыкам и календарям, создаваемым при переносе.

Указывать параметры не нужно

--nouse_gui

Запускает GWMME с помощью командной строки. По умолчанию используется графический интерфейс пользователя.

Указывать параметры не нужно

--nowait

Закрывает 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

Указывает IP-адрес или полное доменное имя сервера Exchange или IMAP.

При переносе данных с сервера 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. Все другие названия компаний и продуктов являются товарными знаками соответствующих компаний.