명령줄을 사용하여 데이터 이전하기

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 Vault로 메일 이전

PST 파일 이전에 대한 자세한 내용은 PST 파일에서 데이터 이전하기를 참고하세요.

공개 폴더에서 이전하기

예 1: 매핑 모드를 사용하여 공개 폴더를 이전합니다 (권장). 이 모드에서는 매핑 파일을 사용하여 공개 폴더를 그룹스의 그룹에 매핑합니다. 그룹 이메일 주소는 공개 폴더 이름과 일치하지 않는 경우가 많기 때문에 대부분의 조직에서 매핑 모드를 사용합니다.

예 2: 기본 모드를 사용하여 공개 폴더를 이전합니다. 이 모드에서는 매핑 파일이 필요하지 않습니다. 대신 GWMME에서 폴더와 그룹 이름을 비교하여 공개 폴더 이름이 그룹 이름과 직접 일치할 때 매핑이 이루어집니다. 예를 들어 TPS 보고서/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` Exchange 서버가 아닌 IMAP 서버에서 이전하는 데 사용합니다.	필요한 매개변수 없음
`--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` Exchange 공개 폴더에서 Google 그룹스로의 GWMME 이전을 사용 설정합니다. 자세한 내용은 공개 폴더 이전하기를 참고하세요. 참고: 사용자와 공개 폴더 모두를 동시에 이전할 수는 없습니다.	필요한 매개변수 없음
`--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.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"	한 자리 코드
`--imap_server_type` 이전하려는 IMAP 서버 유형을 지정합니다. 서버 유형에는 Exchange, GroupWise, Gmail, Cyrus, Courier, Dovecot, Zimbra, '지원되지 않음'이 있습니다. 기본값은 지원되지 않음입니다. 참고: 잘못된 서버 유형을 지정하면 이전 성능에 영향을 미칠 수 있습니다. 예: --imap_server_type="Gmail"	IMAP 서버 유형
`--migrate_to_vault` 이메일을 Google Vault로 이전합니다. 메일은 사용자 계정으로 업로드되고 삭제된 것으로 표시됩니다. 사용자의 받은편지함에 라벨을 만들지 않습니다. 다음 제한사항을 참고하세요. Google Vault 보관 규칙에 따라 Google Vault에 메일을 보관할 기간이 결정됩니다. Vault로 이전하는 경우 관리 콘솔에서 Gmail을 사용 설정해야 합니다. Gmail이 사용 중지되어 있으면 403 오류가 표시됩니다. 퇴사 직원 Vault (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 관리 가이드에 있는 '이전 보고서 검토'를 참고하세요.	필요한 매개변수 없음
`--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의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표입니다.

명령줄을 사용하여 데이터 이전하기 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.