انتقال داده‌ها با استفاده از خط فرمان

انتقال فضای کاری گوگل برای مایکروسافت اکسچنج

علاوه بر استفاده از 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 (سیستم ۳۲ بیتی)
  • C:\Program Files (x86)\Google\Google Workspace Migration (سیستم ۶۴ بیتی)

ممکن است از شما خواسته شود نام کاربری و رمز عبور مدیر Exchange خود را وارد کنید.

دستورات مورد نیاز برای مهاجرت شما

دستورات باید در یک خط پیوسته وارد شوند. هرگونه پرش به خط بعدی که در اینجا مشاهده می‌شود، فقط برای خوانایی است.

مهاجرت از Exchange

مثال ۱: مهاجرت با استفاده از پروفایل مدیر

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 "

مثال ۲: مهاجرت با استفاده از جزئیات سرور و مدیر

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، به Migrate data from Exchange مراجعه کنید.

مهاجرت از حساب گوگل یا سرور 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 "

برای اطلاعات بیشتر در مورد انتقال اطلاعات ایمیل از حساب‌های گوگل یا IMAP، به «انتقال ایمیل از حساب‌های گوگل یا IMAP» مراجعه کنید.

مهاجرت از فایل‌های PST

مثال ۱: انتقال پیام‌ها به جیمیل

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 "

مثال ۲: انتقال پیام‌ها به 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

برای اطلاعات بیشتر در مورد انتقال فایل‌های PST، به بخش «انتقال داده‌ها از فایل‌های PST» مراجعه کنید.

مهاجرت از پوشه‌های عمومی

مثال ۱: از حالت نگاشت برای انتقال پوشه‌های عمومی استفاده کنید (توصیه می‌شود). این حالت از یک فایل نگاشت برای نگاشت پوشه عمومی به گروه در گروه‌ها استفاده می‌کند. از آنجا که آدرس‌های ایمیل گروه اغلب با نام پوشه‌های عمومی مطابقت ندارند، اکثر سازمان‌ها از حالت نگاشت استفاده می‌کنند.

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

مثال ۲: از حالت پیش‌فرض برای انتقال پوشه‌های عمومی استفاده کنید. در این حالت، به فایل نگاشت نیاز ندارید. در عوض، 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

یک آرگومان را در یک خط وارد کنید و قبل از آرگومان یک خط تیره دوتایی (--) قرار دهید. برخی از آرگومان‌ها به پارامترهای اضافی نیاز دارند. پارامترها را با علامت مساوی و محصور در علامت نقل قول دوتایی وارد کنید.

الف—ه

استدلال و توضیحات پارامتر

--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 فعال می‌کند. برای جزئیات بیشتر، به Migrate public folders مراجعه کنید.

توجه : شما نمی‌توانید همزمان برای پوشه‌های کاربران و عمومی، عملیات مهاجرت را اجرا کنید.

 پارامتری لازم نیست

--enable_resource_migration

انتقال منابع تقویم را فعال می‌کند.

 پارامتری لازم نیست

--exchange_admin_login

نام ورود به سیستم برای حساب کاربری مدیر سرور Exchange را مشخص می‌کند. از این آرگومان همراه با --source_server استفاده کنید.

اگر از این آرگومان استفاده می‌کنید، از --exchange_profile_name استفاده نکنید.

مثال : --exchange_admin_login="administrator"

 نام ورود برای حساب کاربری ادمین سرور Exchange

--exchange_profile_name

نام پروفایل Outlook که می‌خواهید برای اتصال به سرور Exchange خود استفاده کنید را مشخص می‌کند. یک پروفایل مدیر در همان دستگاهی که GWMME را اجرا می‌کند، مشخص کنید. اگر از این آرگومان استفاده می‌کنید، از موارد زیر استفاده نکنید:

  • --سرور_منبع
  • --پوشه_pst_base
  • --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="موارد حذف شده، پیش‌نویس‌ها"

 فهرست پوشه‌های سطح بالا که با ویرگول از هم جدا شده‌اند (بین آیتم‌های فهرست فاصله نباشد)

ف—م

استدلال و توضیحات پارامتر

--filename

شامل داده‌های متعلق به نام‌های کاربری مشخص‌شده در فایل CSV می‌شود. اگر از این آرگومان استفاده می‌کنید، از --migration_usernames استفاده نکنید.

مثال : --filename="C:\Documents and Settings\users.csv"

 مسیر فایل CSV نام‌های کاربری

--force_clear_google_calendar_ids_on_remigration

قبل از انتقال مجدد داده‌ها، شناسه‌های تقویم‌های ثانویه را پاک می‌کند. هنگام انتقال مجدد داده‌های تقویم، GWMME تقویم‌های ثانویه جدیدی با شناسه‌های منحصر به فرد ایجاد می‌کند. انجام این کار از تداخل رویدادها جلوگیری می‌کند.

توجه : قبل از انتقال مجدد داده‌ها از این آرگومان استفاده کنید. برای جزئیات بیشتر، دوباره به Migrate content بروید.

 پارامتری لازم نیست

--force_restart

مهاجرت را روی همه موارد، به جای فقط مواردی که با موفقیت مهاجرت نشده‌اند، دوباره اجرا می‌کند.

به طور پیش‌فرض، اگر یک مهاجرت متوقف شود، مهاجرت بعدی از نقطه‌ای که مهاجرت قبلی متوقف شده است شروع می‌شود. می‌توانید از این پارامتر برای اجرای مجدد مهاجرت از ابتدا استفاده کنید. اگر از این گزینه استفاده کنید، ایمیل‌های تکراری فیلتر می‌شوند، رویدادهای تقویم که قبلاً مهاجرت شده‌اند نادیده گرفته می‌شوند (اما ممکن است در برخی موارد تکرار شوند) و مخاطبینی که قبلاً مهاجرت شده‌اند، تکرار می‌شوند.

 پارامتری لازم نیست

--google_admin

مالک رویداد را برای منابع تقویم تعیین می‌کند. اگر رویدادی مالک نداشته باشد، GWMME مدیر تعیین‌شده را به عنوان مالک رویداد تعیین می‌کند. کاربر باید دسترسی کامل به تقویم‌های منابع داشته باشد.

مثال : --google_admin="admin@example.com"

 آدرس ایمیل مالک رویداد معرفی‌شده برای تقویم‌های منابع

--google_domain

دامنه Google Workspace را که داده‌ها را به آن منتقل می‌کنید، مشخص می‌کند.

مثال : --google_domain="example.com"

 دامنه گوگل ورک اسپیس

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

 آدرس ایمیل مدیر سایت کوروش

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

گزینه امنیتی مورد نظر شما را مشخص می‌کند. از یکی از کدهای زیر استفاده کنید:

  • ۰ (بدون امنیت)
  • ۱ (اس‌اس‌ال)
  • ۲ (شروع)

مثال : --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) تعیین می‌کند که پیام‌ها چه مدت در والت (Vault) نگهداری شوند.
  • اگر در حال مهاجرت به Vault هستید، باید Gmail را در کنسول مدیریت فعال کرده باشید. اگر Gmail خاموش باشد، خطاهای ۴۰۳ را مشاهده خواهید کرد.
  • انتقال کاربران دارای مجوز کارمند سابق (VFE) به Vault با شکست مواجه خواهد شد زیرا Gmail برای این کاربران فعال نیست.
 پارامتری لازم نیست

--migration_usernames

لیست کاربران برای مهاجرت را مشخص می‌کند. اگر از این آرگومان استفاده می‌کنید، از --filename استفاده نکنید.

مثال : --migration_usernames="user1,user2,user3"

 فهرست کاربران جدا شده با کاما (بدون فاصله بین موارد)

ن—ز

استدلال و توضیحات پارامتر

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

GWMME را بدون نیاز به فشردن کلید Enter هنگام اجرای مهاجرت از خط فرمان، می‌بندد.

 پارامتری لازم نیست

--num_threads

تعداد کاربرانی را که می‌خواهید همزمان مهاجرت کنید مشخص می‌کند. برای هر کاربر یک thread جداگانه باز می‌شود. مقدار پیش‌فرض ۲۵ thread است.

مثال : --num_threads="20"

 تعداد کاربران

--pst_base_folder

دایرکتوری حاوی فایل‌های PST برای انتقال را مشخص می‌کند. GWMME تمام فایل‌های PST موجود در زیرپوشه‌های پوشه مشخص شده را انتقال می‌دهد.

اگر از این استدلال استفاده می‌کنید، از موارد زیر استفاده نکنید:

  • --سرور_منبع
  • --نام_پروفایل_صرافی

مثال : --pst_base_folder="C:\pst"

 دایرکتوری حاوی فایل‌های PST

--public_folder_mapping_file

نام فایل نگاشت را مشخص می‌کند. فایل نگاشت، مسیرهای پوشه عمومی Exchange را به آدرس‌های ایمیل Google Groups نگاشت می‌کند. برای جزئیات بیشتر، به Migrate public folders بروید.

مثال : --public_folder_mapping_file="public_folder_mapping.csv"

 نگاشت نام فایل با فرمت CSV

--retry_count

تعداد تلاش‌های مجدد را در صورت بروز یک خطای موقت، مانند زمان اتمام سرور شلوغ، مشخص می‌کند. مقدار پیش‌فرض ۱۰ است.

مثال : --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 دستور می‌دهد تا رویدادهای موجود که قبلاً به تقویم گوگل منتقل شده‌اند را بررسی کند و با ترجمه آدرس ایمیل منبع Exchange به آدرس ایمیل منبع Google Workspace مربوطه، رویدادها را اصلاح می‌کند.

بسیاری از مدیران سیستم ترجیح می‌دهند ابتدا کاربران را منتقل کنند و سپس منابع تقویم را. اگر شما انتقال منابع تقویم را در اولویت قرار می‌دهید، GWMME را طوری پیکربندی کنید که داده‌های تقویم کاربران را دوباره منتقل کند. این کار را با استفاده از --translate_conflicting_events انجام دهید.

 پارامتری لازم نیست


گوگل، گوگل ورک‌اسپیس و علامت‌ها و لوگوهای مرتبط، علائم تجاری شرکت گوگل هستند. سایر نام‌های شرکت‌ها و محصولات، علائم تجاری شرکت‌هایی هستند که با آنها مرتبط هستند.