شما میتوانید از دستور sync-cmd و Google Cloud Directory Sync (GCDS) برای اجرای همگامسازیها از طریق خط فرمان استفاده کنید.
چه زمانی از خط فرمان همگامسازی کنیم
هنگام تنظیم یا تغییر پیکربندی خود، باید همگامسازی دستی را از Configuration Manager اجرا کنید. انجام این کار به شما امکان میدهد دادههای همگامسازی شده را بررسی کنید و مطمئن شوید که مرتب هستند. برای جزئیات بیشتر، به Perform a manual synchronization بروید.
پس از انجام تغییرات پیکربندی، میتوانید فرآیند همگامسازی خود را با استفاده از خط فرمان خودکار کنید. میتوانید همگامسازیها را در هر اسکریپت زمانبندی یا دستهای که مایل به استفاده از آن هستید، بگنجانید. همچنین، میتوانید از یک ابزار شخص ثالث برای خودکارسازی همگامسازیها استفاده کنید. برای جزئیات بیشتر، به «زمانبندی همگامسازیهای خودکار» مراجعه کنید.
از خط فرمان استفاده کنید
شما دستور sync-cmd را از دایرکتوری نصب GCDS اجرا میکنید و دستور را در یک خط وارد میکنید. میتوانید از آرگومانهای دستوری ذکر شده در زیر برای انجام طیف وسیعی از اقدامات، مانند:
- هرگونه تغییر شناساییشده را اعمال کنید.
- خواندن یک فایل مشخص شده.
- سطح جزئیات ثبت وقایع را تنظیم کنید.
نکته : میتوانید با وارد کردن sync-cmd -h اطلاعاتی در مورد آرگومانهای دستور موجود دریافت کنید.
آرگومانها و مثالهای دستور
آرگومانهای فرمان
| استدلال (از هر دو گزینه استفاده کنید) | توضیحات |
|---|---|
-a | هرگونه تغییر شناساییشده را اعمال میکند. توجه: اگر از این آرگومان استفاده نکنید، همگامسازی فقط به صورت آزمایشی اجرا میشود و هیچ تغییری در حساب گوگل شما ایجاد نمیشود. برای بهترین نتیجه، قبل از اجرای همگامسازی کامل با این آرگومان، یک همگامسازی آزمایشی را بدون این آرگومان اجرا کنید. |
-c | فایل پیکربندی XML را برای بارگذاری مشخص میکند. مهم : شما باید یک فایل XML معتبر را به این آرگومان اضافه کنید. برای جزئیات بیشتر، به بخش «کار با فایلهای پیکربندی» مراجعه کنید. |
-cs | طرحوارههای سفارشی را شامل نمیشود. اگر نمیخواهید دادههای طرحواره سفارشی را برای کاربران همگامسازی کنید، از این گزینه استفاده کنید. |
-d | محدودیتهای حذف پیکربندیشده را نادیده میگیرد. |
-f | قبل از اجرای همگامسازی، نسخه ذخیرهشده از دادههای حساب گوگل شما را پاک میکند. مهم : استفاده نادرست میتواند باعث کاهش عملکرد شود. از این گزینه استفاده نکنید، مگر اینکه توسط پشتیبانی دستور داده شده باشد. |
-g | گروهها را مستثنی میکند. اگر میخواهید کاربران را همگامسازی کنید، اما گروهها را نه، از این گزینه استفاده کنید. |
-h | اطلاعات راهنما و خروجیها را نمایش میدهد. |
-l | سطح گزارش پیشفرض یا پیکربندیشده را با یک مقدار مشخص لغو میکند. مقادیر معتبر (به ترتیب افزایش جزئیات) عبارتند از FATAL، ERROR، WARN، INFO، DEBUG و TRACE. در بیشتر موارد، توصیه میکنیم سطح گزارش را روی INFO تنظیم کنید. |
-lic | شامل مجوزها نمیشود. اگر نمیخواهید دادههای مجوز برای کاربران همگامسازی شود، از این گزینه استفاده کنید. |
-o | هرگونه همگامسازی در حال اجرا را به یک نمونه در هر فایل پیکربندی XML محدود میکند. انجام این کار از اجرای ناخواسته چندین نمونه (به عنوان مثال، از طریق یک برنامهریز یا cron job) جلوگیری میکند. این آرگومان فقط با آرگومان برای عیبیابی، به «چرا GCDS از خط فرمان همگامسازی را اجرا نمیکند؟» بروید. |
-ou | واحدهای سازمانی را شامل نمیشود. |
-r | گزارشها را علاوه بر گزارش، در یک فایل خروجی مشخص مینویسد. |
-s | مخاطبین مشترک را شامل نمیشود. |
-u | کاربران را مستثنی میکند. اگر میخواهید گروهها را همگامسازی کنید، اما کاربران را نه، از این گزینه استفاده کنید. |
-v | اطلاعات مختصری از نسخه برنامه را نمایش میدهد. |
-V | اطلاعات دقیق نسخه برنامه را نمایش میدهد، اما آن را همگامسازی نمیکند. |
مثالها
ویندوز
مثال ۱ : اجرای یک همگامسازی شبیهسازیشده با استفاده از فایل پیکربندی XML در مسیر C:\Users\user\gdcs-config.xml:
sync-cmd -c C:\Users\user\gdcs-config.xml
مثال ۲ : اجرای یک همگامسازی کامل، شامل اعمال هرگونه تغییر شناساییشده، با استفاده از فایل پیکربندی XML در مسیر C:\Users\user\gdcs-config.xml:
sync-cmd -a -c C:\Users\user\gdcs-config.xml
لینوکس
مثال ۱: اجرای یک همگامسازی شبیهسازیشده با استفاده از فایل پیکربندی XML /path/gcds-config.xml:
sync-cmd -c /path/gcds-config.xml
مثال ۲: اجرای یک همگامسازی کامل، شامل اعمال هرگونه تغییر شناساییشده، با استفاده از فایل پیکربندی XML /path/gcds-config.xml:
sync-cmd -a -c /path/gcds-config.xml
بررسی کد خروج
پس از اجرای همگامسازی یا شبیهسازی از خط فرمان، یکی از کدهای خروج زیر را دریافت خواهید کرد:
- ۰ — همگامسازی بدون هیچ مشکلی انجام شد و تمام تغییرات از محدودیتهای پیکربندیشده تجاوز نکردند.
- ۲۵۵ — شبیهسازی تکمیل شد. یا، همگامسازی تکمیل شد و مشکلات همگامسازی وجود دارد، مانند تغییراتی که از محدودیتهای پیکربندیشده فراتر رفتهاند یا کاربر در همگامسازی ناموفق بوده است.
مرحله بعدی
شما باید با بررسی منظم هرگونه پیام اعلان، تمام همگامسازیها را زیر نظر داشته باشید. برای جزئیات بیشتر، به تنظیم اعلانهای خود بروید.
گوگل، گوگل ورکاسپیس و علامتها و لوگوهای مرتبط، علائم تجاری شرکت گوگل هستند. سایر نامهای شرکتها و محصولات، علائم تجاری شرکتهایی هستند که با آنها مرتبط هستند.