تعقب الملفات المحدثة باستخدام مهمة مراقب

يستخدم Azure Automation مهمة مراقب للبحث عن الأحداث وتشغيل الإجراءات باستخدام دلائل تشغيل PowerShell. تحتوي مهمة المراقب على جزأين، المراقب والإجراء. يعمل دليل تشغيل المراقب في فاصل زمني محدد في مهمة المراقب، ويُخرج البيانات إلى دليل تشغيل إجراء.

إشعار

مهام المراقب غير مدعومة في Microsoft Azure المشغلة بواسطة 21Vianet.

هام

بدءًا من مايو 2020، يعد استخدام Azure Logic Apps الطريقة الموصى بها والمعتمدة لمراقبة الأحداث وجدولة المهام المتكررة وتشغيل الإجراءات. راجع جدولة وتشغيل المهام والعمليات وسير العمل التلقائي المتكرر باستخدام Azure Logic Apps.

ترشدك هذه المقالة خلال إنشاء مهمة مراقب للمراقبة عند إضافة ملف جديد إلى دليل. ‏‫ستتعلم كيفية:

• استيراد دليل تشغيل مراقب
• إنشاء متغيّر تنفيذ تلقائي
• إنشاء دليل تشغيل إجراء
• إنشاء مهمة مراقب
• تشغيل مراقب
• فحص الإخراج

المتطلبات الأساسية

لإكمال هذه المقالة، يلزم تجهيز ما يلي:

• اشتراك Azure. في حالة عدم امتلاك اشتراك بعد، يمكنك تفعيل مزايا مشترك MSDN أو الاشتراك في حساب مجاني.
• حساب Automation للاحتفاظ بسجلات تشغيل المراقب والعمل ومهمة المراقب.
• عامل دليل تشغيل مختلط تعمل عليه مهمة المراقب.
• أدلة تشغيل PowerShell. لا تدعم مهام المراقب دفاتر تشغيل PowerShell Workflow ودفاتر التشغيل الرسومية.

استيراد دليل تشغيل مراقب

تستخدم هذه المقالة دليل تشغيل مراقب يسمى دليل تشغيل المراقب حيث يبحث عن ملفات جديدة في الدليل للبحث عن ملفات جديدة في دليل. يسترد دليل تشغيل المراقب آخر وقت كتابة معروف إلى الملفات الموجودة في مجلد ويفحص أي ملفات أحدث من تلك العلامة المائية.

يمكنك استيراد دليل التشغيل هذا إلى حساب Automation الخاص بك من المدخل باستخدام الخطوات التالية.

1. قم بتسجيل الدخول إلى بوابة Azure.
2. ابحث عن حسابات Automation وحددها.
3. في صفحة حسابات Automation، حدد اسم حساب Automation من القائمة.
4. في الجزء الأيسر، حدد معرض دلائل التشغيل ضمن التنفيذ التلقائي للعمليات.
5. تأكد من تحديد GitHub في القائمة المنسدلة المصدر.
6. ابحث عن دليل تشغيل المراقب.
7. حدد دليل تشغيل مراقب يبحث عن ملفات جديدة في دليل، وحدد استيراد في صفحة التفاصيل.
8. أطلق اسمًا على دليل التشغيل واختياريًا وصفًا وانقر فوق موافق لاستيراد دليل التشغيل إلى حساب Automation الخاص بك. يجب أن ترى الرسالة عملية استيراد ناجحة في جزء في أعلى يمين النافذة.
9. يظهر دليل التشغيل المستورد في القائمة تحت الاسم الذي أطلقته عليه عند تحديد دلائل التشغيل من الجزء الأيسر.
10. انقر فوق دليل التشغيل، وفي صفحة تفاصيل دليل التشغيل، حدد تحرير ثم انقر فوق نشر. عند المطالبة، انقر فوق نعم لنشر دليل التشغيل.

يمكنك أيضًا تنزيل دليل التشغيل من مؤسسة Azure Automation GitHub.

1. انتقل إلى صفحة مؤسسة Azure Automation GitHub لـ Watch-NewFile.ps1.
2. لتنزيل دليل التشغيل من GitHub، حدد التعليمات البرمجية من الجانب الأيمن للصفحة، ثم حدد تنزيل ZIP لتنزيل التعليمات البرمجية بالكامل في ملف مضغوط.
3. استخرج المحتويات واستورد دليل التشغيل.

إنشاء متغيّر تنفيذ تلقائي

يتم استخدام متغير التنفيذ التلقائي لتخزين الطوابع الزمنية التي يقرأها دليل التشغيل السابق ويخزنها من كل ملف.

1. حدد المتغيرات ضمن الموارد المشتركة وانقر فوق + إضافة متغير.

2. أدخل Watch-NewFileTimestamp للاسم.

3. حدد DateTime للنوع. سيتم تعيينه افتراضيًا على التاريخ والوقت الحاليين.

   

4. انقر فوق إنشاء لإنشاء متغير التنفيذ التلقائي.

إنشاء دليل تشغيل إجراء

يتم استخدام دليل تشغيل إجراء في مهمة مراقب للعمل على البيانات التي تم تمريرها إليه من دليل تشغيل مراقب. يجب استيراد دفتر تشغيل إجراء محدد مسبقًا، إما من مدخل Azure أو من مؤسسة Azure Automation GitHub.

يمكنك استيراد دليل التشغيل هذا إلى حساب Automation الخاص بك من مدخل Azure:

1. قم بتسجيل الدخول إلى بوابة Azure.
2. ابحث عن حسابات Automation وحددها.
3. في صفحة حسابات Automation، حدد اسم حساب Automation من القائمة.
4. في الجزء الأيسر، حدد معرض دلائل التشغيل ضمن التنفيذ التلقائي للعمليات.
5. تأكد من تحديد GitHub في القائمة المنسدلة المصدر.
6. ابحث عن إجراء المراقب، حدد إجراء المراقب الذي يعالج الأحداث التي يتم تشغيلها بواسطة دليل تشغيل مراقب، وانقر فوق استيراد.
7. بشكل اختياري، غيّر اسم دليل التشغيل على صفحة الاستيراد، ثم انقر فوق موافق لاستيراد دليل التشغيل. يجب أن ترى الرسالة عملية استيراد ناجحة في جزء الإعلام في الجانب الأيسر العلوي من المستعرض.
8. انتقل إلى صفحة حساب Automation، وانقر فوق دلائل التشغيل على اليسار. يجب أن تكون دلائل التشغيل مدرجة تحت الاسم الذي أطلقته في الخطوة السابقة. انقر فوق دليل التشغيل، وفي صفحة تفاصيل دليل التشغيل، حدد تحرير ثم انقر فوق نشر. عند المطالبة، انقر فوق نعم لنشر دليل التشغيل.

لإنشاء دليل تشغيل إجراء عن طريق تنزيله من مؤسسة Azure Automation GitHub:

1. انتقل إلى صفحة مؤسسة Azure Automation GitHub لـ Process-NewFile.ps1.
2. لتنزيل دليل التشغيل من GitHub، حدد التعليمات البرمجية من الجانب الأيمن للصفحة، ثم حدد تنزيل ZIP لتنزيل التعليمات البرمجية بالكامل في ملف مضغوط.
3. استخرج المحتويات واستورد دليل التشغيل.

إنشاء مهمة مراقب

في هذه الخطوة، يمكنك تكوين مهمة المراقب بالرجوع إلى المراقب ودلائل تشغيل الإجراء المعرفة في الأقسام السابقة.

1. انتقل إلى حساب Automation وحدد مهام المراقب ضمن التنفيذ التلقائي للعمليات.

2. حدد صفحة مهام المراقب وانقر فوق+ إضافة مهمة مراقب.

3. أدخل WatchMyFolder كاسم.

4. حدد تكوين مراقب واختر دليل تشغيل Watch-NewFile.

5. أدخل القيم التالية للمعلمات:

   • FOLDERPATH - مجلد على Hybrid Runbook Worker حيث يتم إنشاء ملفات جديدة، على سبيل المثال، d:\examplefiles.
   • EXTENSION - ملحق للتكوين. اتركها فارغة لمعالجة جميع ملحقات الملفات.
   • RECURSE - عملية متكررة. اترك هذه القيمة باعتبارها القيمة الافتراضية.
   • RUN SETTINGS - إعداد لتشغيل دليل التشغيل. اختر العامل المختلط.

6. انقر فوق موافق، ثم حدد للعودة إلى صفحة المراقب.

7. حدد تكوين الإجراء واختر دليل التشغيل Process-NewFile.

8. أدخل القيم التالية للمعلمات:

   • EVENTDATA - بيانات الحدث. اترك فراغاً. يتم تمرير البيانات من دليل تشغيل المراقب.
   • إعدادات التشغيل - إعداد لتشغيل دليل التشغيل. اتركها كـ Azure، حيث إن دليل التشغيل هذا يعمل في Azure Automation.

9. انقر فوق موافق، ثم حدد للعودة إلى صفحة المراقب.

10. انقر فوق موافق لإنشاء مهمة مراقب.

    

تشغيل مراقب

يجب تشغيل اختبار كما هو موضح أدناه للتأكد من أن مهمة المراقب تعمل على النحو المتوقع.

1. بعيد في Hybrid Runbook Worker.
2. افتح PowerShell وأنشئ ملف اختبار في المجلد.

New-Item -Name ExampleFile1.txt

يعرض المثال التالي الإخراج المتوقع.

    Directory: D:\examplefiles


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----       12/11/2017   9:05 PM              0 ExampleFile1.txt

فحص الإخراج

1. انتقل إلى حساب Automation وحدد مهام المراقب ضمن التنفيذ التلقائي للعمليات.

2. حدد مهمة المراقب WatchMyFolder.

3. انقر فوق عرض تدفقات المراقب ضمن التدفقات لمعرفة أن المراقب قد وجد الملف الجديد وبدأ دليل تشغيل الإجراء.

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

   

يمكن مشاهدة الإخراج المتوقع عند العثور على الملف الجديد في المثال التالي:

Message is Process new file...

Passed in data is @{FileName=D:\examplefiles\ExampleFile1.txt; Length=0}

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

لمعرفة المزيد حول تأليف دفتر التشغيل الخاص بك، راجع إنشاء دليل تشغيل PowerShell.