סנכרון באמצעות שורת הפקודה

אפשר להשתמש בפקודה sync-cmd וב-Google Cloud Directory Sync‏ (GCDS) כדי להריץ סנכרונים משורת הפקודה.

מתי כדאי לסנכרן משורת הפקודה

כשמגדירים או משנים את התצורה, צריך להריץ סנכרון ידני מ-Configuration Manager. כך תוכלו לבדוק את הנתונים המסונכרנים ולוודא שהם תקינים. פרטים נוספים מופיעים במאמר בנושא ביצוע סנכרון ידני.

אחרי שמסיימים לבצע שינויים בהגדרות, אפשר להשתמש בשורת הפקודה כדי להפוך את תהליך הסנכרון לאוטומטי. אפשר לשלב סנכרונים בכל סקריפט לתזמון או לביצוע פעולות בקבוצות שרוצים להשתמש בו. אפשר גם להשתמש בכלי של צד שלישי כדי להפוך את הסנכרון לאוטומטי. פרטים נוספים מופיעים במאמר בנושא תזמון סנכרונים אוטומטיים.

שימוש בשורת הפקודה

מריצים את הפקודה sync-cmd מספריית ההתקנה של GCDS ומזינים את הפקודה בשורה אחת. אפשר להשתמש בארגומנטים של הפקודה שמפורטים בהמשך כדי לבצע מגוון פעולות, כמו:

  • מחילים את השינויים שזוהו.
  • קריאת קובץ ספציפי.
  • מגדירים את רמת הפירוט של הרישום ביומן.

טיפ: כדי לקבל מידע על ארגומנטים זמינים של פקודות, מזינים 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.

כדי לפתור את הבעיה, אפשר לעבור אל למה GCDS לא מריץ סנכרון משורת הפקודה?
-ou
--orgunit		 החרגה של יחידות ארגוניות.
-r
--report-out		 כותב דוחות לקובץ פלט שצוין, בנוסף ליומן.
-s
--sharedcontacts		 לא כולל אנשי קשר משותפים.
-u
--users		 לא כולל משתמשים.

כדאי להשתמש באפשרות הזו אם רוצים לסנכרן קבוצות, אבל לא משתמשים.
-v הצגת מידע קצר על גרסת האפליקציה.
-V האפליקציה מציגה מידע מפורט על גרסת האפליקציה, אבל לא מסנכרנת אותו.

דוגמאות

Windows

דוגמה 1: הפעלת סימולציה של סנכרון באמצעות קובץ התצורה C:\Users\user\gdcs-config.xml בפורמט XML:

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

דוגמה 2: הרצת סנכרון מלא, כולל החלת שינויים שזוהו, באמצעות קובץ התצורה 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. כל שמות החברות והמוצרים האחרים הם סימנים מסחריים של החברות שאליהן הם משויכים.