تثبيت مجموعة أدوات School Data Sync

هام: تمت ترجمة هذه المقالة ترجمة آلية، راجع إقرار إخلاء المسؤولية. يرجى الاطلاع على النسخة الإنجليزية من هذه المقالة. هنا للرجوع إليها.

يمكنك استخدام "مجموعة أدوات School Data Sync" للتحقق من صحة ملفات CSV والتحقق من وجود أخطاء وتنفيذ عملية مزامنة CSV يدوياً من PowerShell وتنفيذ عملية مزامنة CSV تلقائياً لتلبية احتياجاتك.

في هذا الموضوع:

تثبيت مجموعة أدوات Microsoft School Data Sync

  1. قم بتنزيل الأداة من مجموعة أدوات Microsoft School Data Sync‏.

  2. انقر نقراً مزدوجاً فوق الأداة لتشغيل المعالج.

  3. في صفحة الترحيب، اختر التالي.

    اختر "التالي" على صفحة "الترحيب" لإعداد مجموعة أدوات Microsoft SChool Data Sync Toolkit
  4. تفضل بقبول اتفاقية الترخيص > انقر فوق التالي، اختر مساراً للتثبيت، ثم اختر التالي.

    اختر مسار التثبيت لـ "مجموعة أدوات Microsoft School Data Sync"
  5. اختر تثبيت > إنهاء.

إمكانات مجموعة أدوات School Data Sync‏

بعد تثبيت مجموعة الأدوات وإنشاء ملف التعريف الأولي في "مدخل School Data Sync"، يمكنك استخدام البرنامج النصي التالي لتحميل ملفات CSV إضافية بشكل منتظم أو عند الحاجة. يسمح لك المثبِّت بتشغيل عدة أوامر cmdlet من جلسة مسؤول PowerShell على الكمبيوتر لديك، لمساعدتك في نشر "School Data Sync" بنجاح. راجع الأقسام التالية للحصول على وصف وحالة استخدام كل أمر من أوامر cmdlet.

استخدام "مجموعة أدوات School Data Sync" للتحقق من صحة بيانات ملفات CSV (مزامنة مسبقة)

لاستخدام مجموعة الأدوات في التحقق من صحة ملفات CSV قبل تحميل الملفات لتتم مزامنتها، افتح PowerShell كمسؤول واستخدم أمر cmdlet "Start-CsvFilesValidation" كما هو موضح في الأمثلة وبناء الجملة التالي.

بناء الجملة Start-CsvFilesValidation

استخدم أمر cmdlet‏ "Start-CsvFilesValidation" للتحقق من صحة ملفات CSV لملف تعريف مزامنة معين.

Start-CsvFilesValidation -CsvFolderPath <String> -ProfileName <String> -UserName <String>

المعلمة

الوصف

CsvFolderPath

مسار المجلد الذي يحتوي على ملفات CSV.

ProfileName

اسم ملف التعريف الذي أنشأته في "School Data Sync" لملفات CSV التي تريد التحقق من صحتها.

UserName

اسم المستخدم لحساب المسؤول مع حقوق المسؤول العمومي لمستأجر Office 365.

يقوم المثال التالي بتنفيذ عملية التحقق من الصحة من جانب العميل لملفات CSV الموجودة في دليل c:\temp على الكمبيوتر المحلي، لملف تعريف يسمى "المدرسة 1"، باستخدام حساب المسؤول العمومي في admin@contoso.com.

Start-CsvFilesValidation –CsvFolderPath “c:\temp” –ProfileName “School 1” –UserName admin@contoso.com

استخدام "مجموعة أدوات School Data Sync" لمزامنة ملفات CSV‏

لتحميل ملفات CSV ومزامنتها مع School Data Sync، افتح PowerShell كمسؤول واستخدم أمر cmdlet‏ "Send-CsvFile" كما هو موضح في المثال وبناء الجملة التالي.

بناء الجملة Send-CsvFiles

استخدم أمر cmdlet ‏"Send-CsvFiles" لتحميل ملفات CSV ومزامنتها لملف تعريف مزامنة معين.

Send-CsvFiles -CsvFolderPath <String> -ProfileName <String> -UserName <String>

المعلمة

الوصف

CsvFolderPath

مسار المجلد الذي يحتوي على ملفات CSV.

ProfileName

اسم ملف التعريف الذي أنشأته في "School Data Sync" لملفات CSV التي تريد التحقق من صحتها.

UserName

اسم المستخدم لحساب المسؤول مع حقوق المسؤول العمومي لمستأجر Office 365.

يقوم المثال التالي بتحميل مجموعة من ملفات CSV الموجودة في دليل c:\temp على الكمبيوتر المحلي ومزامنتها، لملف تعريف يسمى "المدرسة 1"، باستخدام حساب المسؤول العمومي في admin@contoso.com.

Send-CsvFiles –CsvFolderPath “c:\temp” –ProfileName “School 1” –UserName “admin@contoso.com”

استخدام "مجموعة أدوات School Data Sync" لتكوين مزامنة تلقائية لملفات CSV‏

يمكنك جدولة عمليات مزامنة تلقائية غير مراقبة بين ملفات CSV المخزنة محلياً وملف تعريف مزامنة SDS في Office 365. لتنفيذ ذلك، افتح PowerShell كمسؤول واستخدم أمر cmdlet ‏"Add-CsvFileSyncTask" كما هو موضح في الأمثلة وبناء الجملة التالي. بعد اكتمال المهمة المجدولة، يمكنك مراقبة التقدم ومحفوظات عمليات المزامنة التلقائية هذه من خلال مراجعة المهمة المجدولة التي تم إنشاؤها حديثاً في "جدولة المهام". سيتم تشغيل هذه المهمة المجدولة يومياً في منتصف الليل، إلا إذا قمت بتعديل وقت البدء باستخدام المعلمة أدناه.

عند تشغيل هذا الأمر، ستتم مطالبتك بالمصادقة. ستلزمك مطالبة المصادقة الأولى بإدخال بيانات اعتماد "المسؤول العمومي" وستحتوي على اسم المستخدم الذي تحدده في الأمر أدناه، ضمن المعلمة username. بعد إدخال كلمة المرور والنقر فوق زر الإدخال Enter، ستتلقى مطالبة ثانية بالمصادقة الأساسية. هنا يجب إدخال اسم المستخدم الخاص بالمسؤول المحلي وكلمة مروره، وسيتم استخدام بيانات الاعتماد هذه لتشغيل المهمة المجدولة، في كل مرة تبدأ فيها المهمة يومياً. إذا قمت بتضمين المعلمة StoreCredentials، فسيتم تخزين بيانات اعتماد حساب المسؤول المحلي في "إدارة بيانات الاعتماد"، وستعمل طالما لم يتم تغيير كلمة المرور. إذا لم تحدد المعلمة StoreCredentials، فسيتم منحك رمز مصادقة مميز، يكون صالحاً لمدة 90 يوماً بحدٍ أقصى. سيتطلب ذلك تشغيل الأمر مرة أخرى بعد انتهاء صلاحية رمز المصادقة المميز وفشله في المصادقة أثناء تشغيل المهمة المجدولة.

بناء الجملة Add-CsvFileSyncTask

استخدم أمر cmdlet ‏"Add-CsvFileSyncTask" لتحميل ملفات CSV ومزامنتها لملف تعريف مزامنة معين.

Add-CsvFileSyncTask -CSVFolderPath <path to csv file location> -ProfileName <name of sync profile in SDS> -LogPath <path to store logs> -UserName <global admin account> -Validate -RedirectOutput

المعلمة

الوصف

CSVFolderPath

مسار المجلد الذي يحتوي على ملفات CSV التي ستتم مزامنتها بشكل منتظم.

ProfileName

اسم "ملف تعريف مزامنة SDS" الذي تقوم بمزامنة ملفات CSV معه.

UserName

اسم المستخدم الأساسي لحساب المسؤول العمومي الذي سيتم استخدامه مع SDS.

LogPath

مسار الدليل حيث تريد تخزين ملفات سجل التحقق من الصحة.

RedirectOutput

ستسمح بإخراج معلمة التحقق من الصحة التي ستتم كتابتها في الدليل المحدد. يكون ذلك مطلوباً إذا كنت تريد مراجعة نتائج معلمة التحقق من الصحة.

Validate

تشغيل مهمة التحقق من الصحة قبل كل مزامنة. تقوم بإنشاء ملف في دليل Logpath إذا كانت المعلمة RedirectOutput مضمنة أيضاً.

TaskUserName

اسم المهمة المجدولة.

TaskStartTime

وقت بدء المهمة المجدولة.

StoreCredentials

تقوم بإنشاء إدخال في "إدارة بيانات الاعتماد" لتشغيل المهمة المجدولة. تعمل بيانات الاعتماد وتظل صالحة إلا إذا انتهت صلاحية كلمة المرور المقترنة بهذا الحساب.

يعمل المثال التالي على إنشاء مهمة مزامنة تلقائية تمت جدولتها لملفات CSV الموجودة في المجلد C:\temp، في ملف تعريف مزامنة يسمى SDSSync، ويقوم بإنشاء ملفات سجل التحقق من الصحة في المجلد C:\temp\logs ويُعيّن دليل C:\temp\SDS\Logs كموقع لكل ملفات السجل التي تم إنشاؤها. يشغل هذا الأمر أيضاً عملية التحقق من الصحة لملفات CSV قبل أن تبدأ المزامنة، كما يحفظ إخراج التحقق من الصحة في دليل c:\temp\logs نفسه.

Add-CsvFileSyncTask -CSVFolderPath “C:\temp” -ProfileName “SDSSync” -LogPath “C:\temp\logs” -UserName admin@contoso.com -Validate -RedirectOutput

استخدام "مجموعة أدوات School Data Sync" لتحويل ملفات OneRoster CSV

يمكنك استخدام "مجموعة الأدوات" لتحويل ملفات OneRoster CSV ومزامنتها مع School Data Sync. لتنفيذ ذلك، افتح PowerShell كمسؤول واستخدم أمر cmdlet ‏"Convert-OneRostertoMicrosoftSDS" كما هو موضح في المثال وبناء الجملة التالي. بعد اكتمال عملية التحويل، يمكنك مزامنة ملفات CSV هذه من خلال SDS، متبعاً إرشادات مزامنة CSV القياسية الخاصة بنا.

بناء الجملة Convert-OneRostertoMicrosoftSDS

استخدم أمر cmdlet "OneRostertoMicrosoftSDS" ‏لتحميل ملفات CSV ومزامنتها لملف تعريف مزامنة معين.

Convert-OneRostertoMicrosoftSDS -OneRosterFolderPath <String> -SDSFolderPath <String> -LogPath <String>

المعلمة

الوصف

OneRosterFolderPath

مسار المجلد الذي يحتوي على ملفات CSV التي تم تصديرها من OneRoster.

SDSFolderPath

مسار المجلد حيث سيتم إنشاء ملفات CSV التي تم تحويلها.

LogPath

مسار المجلد حيث تريد تخزين التسجيل على هذه الإجراءات.

يعمل المثال التالي على تحويل مجموعة من ملفات OneRoster CSV المخزنة في المجلد C:\temp\OneRoster، ويقوم بإنشاء مجموعة جديدة من ملفات CSV المخزنة في دليل C:\temp\SDS على الكمبيوتر المحلي، كما يُعيّن دليل C:\temp\SDS\Logs كموقع لكل ملفات السجل التي تم إنشاؤها.

Convert-OneRostertoMicrosoftSDS -OneRosterFolderPath “C:\temp\OneRoster” -SDSFolderPath “C:\temp\SDS” -LogPath “C:\temp\SDS\logs”

استخدام "مجموعة أدوات School Data Sync" للتحقق من صحة بيانات ملفات CSV (مزامنة لاحقة)

لاستخدام مجموعة الأدوات في التحقق من صحة ملفات CSV بعد تحميل مجموعة من ملفات CSV ومزامنتها، افتح PowerShell كمسؤول واستخدم أمر cmdlet‏ "Compare-DirectoryToCSVFiles" كما هو موضح في الأمثلة وبناء الجملة التالي.

بناء الجملة Compare-DirectoryToCSVFiles

استخدم أمر cmdlet‏ "Compare-DirectoryToCSVFiles" للتحقق من صحة ملفات CSV لملف تعريف مزامنة معين.

Compare-DirectoryToCSVFiles -CsvFolderPath <String> -ProfileName <String> -UserName <String>

المعلمة

الوصف

CsvFolderPath

مسار المجلد الذي يحتوي على ملفات CSV.

ProfileName

اسم ملف التعريف الذي أنشأته في "School Data Sync" لملفات CSV التي تريد التحقق من صحتها.

UserName

اسم المستخدم لحساب المسؤول مع حقوق المسؤول العمومي لمستأجر Office 365.

يقوم المثال التالي بتنفيذ عملية التحقق من الصحة من جانب العميل لملفات CSV الموجودة في دليل c:\temp على الكمبيوتر المحلي، لملف تعريف يسمى "المدرسة 1"، باستخدام حساب المسؤول العمومي في "admin@contoso.com".

Compare-DirectoryToCsvFiles –CsvFolderPath “c:\temp” –ProfileName “School 1” –UserName “admin@contoso.com”

ملاحظة: إقرار إخلاء المسؤولية للترجمة الآلية: تمت ترجمة هذه المقالة بواسطة نظام كمبيوتر دون تدخل العامل البشري. توفر Microsoft هذه الترجمات الآلية لمساعدة المستخدمين الذين لا يتحدثون الإنجليزية على استخدام منتجات Microsoft، وخدماتها، وتقنياتها والاستمتاع بها. قد تحتوي هذه المقالة على أخطاء في المفردات، أو بناء الجملة، أو القواعد نظرًا لترجمتها آليًا.

انظر أيضاً

نظرة عامة حول School Data Sync وClassroom‏

ملفات CSV لـ School Data Sync‏

سمات School Data Sync المطلوبة لمزامنة PowerSchool‏

كيفية نشر School Data Sync باستخدام ملفات CSV‏

كيفية نشر School Data Sync باستخدام مزامنة PowerSchool‏

كيفية نشر School Data Sync باستخدام مزامنة Clever‏

كيفية نشر School Data Sync باستخدام ملفات OneRoster CSV‏

أخطاء School Data Sync واستكشاف الأخطاء وإصلاحها

توسيع المهارات
استكشاف التدريب
الحصول على الميزات الجديدة أولاً
الانضمام إلى Office Insider

هل كانت المعلومات مفيدة؟

نشكرك على ملاحظاتك!

شكراً لك على الملاحظات! يبدو أنه من المفيد إيصالك بأحد وكلاء دعم Office لدينا.

×