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

يمكنك استخدام الأمر 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: تشغيل مزامنة كاملة، بما في ذلك تطبيق أي تغييرات تم اكتشافها، باستخدام ملف إعداد XML /path/gcds-config.xml:

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

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

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

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

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

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


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