نقل البيانات باستخدام سطر الأوامر

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 بت)
  • 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

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: استخدام وضع الربط لنقل المجلدات العلنية (مُقترح). يستخدم هذا الوضع ملف ربط لربط المجلد العلني بالمجموعة في "مجموعات 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"
--public_folder_mapping_file="path to mapping file"
--enable_public_folder_migration

المثال 2: استخدام الوضع التلقائي لنقل المجلدات العلنية. في هذا الوضع، لا تحتاج إلى ملف ربط. وبدلاً من ذلك، تقارن أداة GWMME أسماء المجلدات والمجموعات. ويتم إنشاء عملية الربط في حال تطابق اسم المجلد العلني مباشرةً مع اسم المجموعة. مثلاً، يتم ربط TPS reports/tps-reports maps بـ group 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

تفعِّل هذه الوسيطة عملية النقل من خادم يستند إلى بروتوكول 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". لمزيد من التفاصيل، انتقِل إلى نقل المجلدات العلنية.

ملاحظة: لا يمكنك تشغيل عملية نقل البيانات لكل من مجلدات المستخدمين والمجلدات العلنية في الوقت نفسه.

 لا تتطلب معلَمة.

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

 قائمة قيم مفصولة بفاصلة للمجلدات ذات المستوى الأعلى (بدون مسافات بين عناصر القائمة)

F—M

الوسيطة والوصف المَعلمة

--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. القيم المعتادة لبادئة المسار هي INBOX لخادم Cyrus وCourier أو لا شيء (اترك الحقل فارغًا) لخادم 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 مدة الاحتفاظ بالرسالة في 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

تؤدي هذه الوسيطة إلى إغلاق أداة GWMME بدون الحاجة إلى الضغط على مفتاح Enter عند تشغيل عملية نقل البيانات من سطر الأوامر.

 لا تتطلب معلَمة.

--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. وجميع أسماء الشركات والمنتجات الأخرى هي علامات تجارية تملكها الشركات ذات الصلة بها.