المزامنة باستخدام سطر الأوامر

يمكنك استخدام الأمر sync-cmd وأداة مزامنة دليل Google Cloud (GCDS) لتشغيل عمليات المزامنة من سطر الأوامر.

الوقت المناسب للمزامنة من سطر الأوامر

عند إعداد عملية الضبط أو تعديلها، يجب أولاً تشغيل عملية مزامنة يدوية من مدير الإعداد. ويتيح لك ذلك التحقّق من البيانات التي تمت مزامنتها والتأكّد من أنها في مكانها الصحيح. لمعرفة التفاصيل، يُرجى الانتقال إلى إجراء مزامنة يدوية.

بعد الانتهاء من إجراء تغييرات الضبط، يمكنك التشغيل الآلي لعملية المزامنة باستخدام سطر الأوامر. ويمكنك دمج عمليات المزامنة ضمن أي جدول زمني أو نص برمجي مُجمَّع تريد استخدامه. بدلاً من ذلك، يمكنك استخدام أداة تابعة لجهة خارجية للتشغيل الآلي لعمليات المزامنة. لمعرفة التفاصيل، يُرجى الانتقال إلى جدولة عمليات المزامنة التلقائية.

استخدام سطر الأوامر

يمكنك تشغيل الأمر sync-cmd من دليل تثبيت "أداة مزامنة دليل Google Cloud" وإدخال الأمر في سطر واحد. يمكنك استخدام وسيطات الأوامر المذكورة أدناه لتنفيذ مجموعة من الإجراءات مثل:

  • تطبيق أي تغييرات يتم اكتشافها
  • قراءة ملف مُحدَّد
  • إعداد مستوى تفاصيل التسجيل

نصيحة: يمكنك الحصول على معلومات حول وسيطات الأوامر المتاحة عن طريق إدخال sync-cmd -h.

وسيطات الأوامر والأمثلة

وسيطات الأوامر

الوسيطة (استخدم أيًا من الخيارين) الوصف
-a
--apply		 تطبق أي تغييرات يتم اكتشافها.

ملاحظة: في حال عدم استخدام هذه الوسيطة، يتم تشغيل مزامنة تجريبية فقط، ولن يتم إجراء أي تغييرات على حساب Google الخاص بك. للحصول على أفضل النتائج، شغِّل مزامنة تجريبية بدون هذه الوسيطة قبل استخدامها في تشغيل المزامنة الكاملة.
-c
--config file-name		 تحدد ملف إعداد XML الذي سيتم تحميله.

ملاحظة مهمة: عليك تضمين ملف XML صالح مع هذه الوسيطة. لمعرفة التفاصيل، يُرجى الانتقال إلى العمل باستخدام ملفات الإعداد.
-cs
--customschemas		 تستبعد المخططات المخصّصة.

استخدم هذا الخيار إذا كنت لا تريد مزامنة بيانات المخطط المُخصَّص للمستخدمين.
-d
--deletelimits		 تتجاهل حدود الحذف التي تم ضبطها.
-f
--flush		 محو النسخة المخزَّنة مؤقتًا من البيانات في حساب Google قبل تشغيل المزامنة

ملاحظة مهمة: يمكن أن يؤدي الاستخدام غير السليم لهذا الخيار إلى انخفاض في الأداء. لا تستخدم هذا الخيار إذا لم توجّهك خدمة الدعم لاستخدامه.
-g
--groups		 تستبعد المجموعات.

استخدم هذا الخيار إذا كنت تريد مزامنة المستخدمين، وليس المجموعات.
-h
--help		 تعرض معلومات المساعدة وتعمل على الخروج.
-l
--loglevel value		 تتجاوز مستوى السجل التلقائي أو المضبوط بقيمة مُحدَّدة. القيم الصالحة (بترتيب زيادة التفاصيل) هي FATAL وERROR وWARN وINFO وDEBUG وTRACE.

في معظم الحالات، ننصحك بضبط مستوى السجل على INFO.
-lic
--license		 تستبعد التراخيص.

استخدم هذا الخيار إذا كنت لا تريد مزامنة بيانات الترخيص للمستخدمين.
-o
--oneinstance

قصر أي مزامنة جارية على مثيل واحد لكل ملف إعداد XML. ويؤدي ذلك إلى منع تشغيل مثيلات متعددة بدون قصد (على سبيل المثال، من خلال أداة جدولة أو مهمة cron). لا تكون الوسيطة صالحة إلا مع الوسيطة -a.

لتحديد المشاكل وحلّها، انتقِل إلى لماذا لا تُجري "أداة مزامنة دليل Google Cloud" مزامنة من سطر الأوامر؟
-ou
--orgunit		 تستبعد الوحدات التنظيمية.
-r
--report-out		 تكتب التقارير في ملف إخراج مُحدَّد، بالإضافة إلى السجل
-s
--sharedcontacts		 تستبعد جهات الاتصال المشتركة.
-u
--users		 تستبعد المستخدمين.

استخدم هذا الخيار إذا أردت مزامنة المجموعات، وليس المستخدمين.
-v عرض معلومات مختصرة عن إصدار التطبيق
-V عرض معلومات تفصيلية عن إصدار التطبيق، بدون مزامنتها

أمثلة

نظام التشغيل Windows

مثال 1: تشغيل محاكاة للمزامنة باستخدام ملف إعداد XML C:\Users\user\gdcs-config.xml:

sync-cmd -c C:\Users\user\gdcs-config.xml

مثال 2: تشغيل مزامنة كاملة، بما في ذلك تطبيق أي تغييرات تم اكتشافها، باستخدام ملف إعداد XML C:\Users\user\gdcs-config.xml:

sync-cmd -a -c C:\Users\user\gdcs-config.xml

نظام التشغيل Linux

مثال 1: تشغيل مزامنة تم إجراء محاكاة لها باستخدام ملف إعداد XML /path/gcds-config.xml:

sync-cmd -c /path/gcds-config.xml

مثال 2: تشغيل مزامنة كاملة، بما في ذلك تطبيق أي تغييرات تم اكتشافها، باستخدام ملف إعداد /path/gcds-config.xml:

sync-cmd -a -c /path/gcds-config.xml

مراجعة رمز الخروج

بعد تشغيل المزامنة أو المحاكاة من سطر الأوامر، ستحصل على أحد رموز الخروج التالية:

  • 0 : اكتملت المزامنة بدون أي مشاكل في المزامنة ولم تتجاوز جميع التعديلات الحدود التي تم ضبطها.
  • 255 : اكتملت المحاكاة. أو، اكتملت المزامنة وحدثت مشاكل في المزامنة، مثل التعديلات التي تجاوزت الحدود التي تم ضبطها أو تعذّر على المستخدم إجراء المزامنة.

الخطوة التالية

يجب مراقبة جميع المزامنات من خلال مراجعة رسائل الإشعارات بانتظام. لمعرفة التفاصيل، يُرجى الانتقال إلى ضبط الإشعارات.


إنّ Google وGoogle Workspace والعلامات والشعارات ذات الصلة هي علامات تجارية (TM) تابعة لشركة Google LLC. وجميع أسماء الشركات والمنتجات الأخرى هي علامات تجارية (TM) تملكها الشركات ذات الصلة بها.