البرنامج التعليمي تكامل Azure Automation مع Event Grid | مستندات Microsoft

في هذا البرنامج التعليمي، تتعلم كيفية:

  • استيراد نموذج دفتر التشغيل لـ Event Grid
  • إنشاء webhook Microsoft Teams اختياري.
  • إنشاء webhook لدفتر التشغيل
  • إنشاء اشتراك Event Grid.
  • إنشاء جهاز VM الذي يقوم بتشغيل دفتر التشغيل.

إذا لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.

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

هام

يتطلب استخدام ميزة Azure هذه من PowerShell ⁧AzureRM⁩ تثبيت الوحدة النمطية. هذه وحدة نمطية قديمة متوفرة فقط في إصدار ويندوز PowerShell 5.1 التي لم تعد تتلقى ميزات جديدة. الوحدات ⁧Az⁩و⁧AzureRM⁩ ليست⁧⁩متوافقة⁧⁩ عند تثبيتها لنفس إصدارات PowerShell. إذا كنت بحاجة إلى كلا الإصدارين:

  1. ⁩قم بإلغاء تثبيت الوحدة النمطية Az⁧⁩ من جلسة عمل PowerShell 5.1.
  2. ⁩قم بتثبيت الوحدة النمطيةAzureRM⁧⁩ في جلسة عمل PowerShell 5.1.
  3. ⁩قم بتنزيل وتثبيت PowerShell Core 6.x أو أحدث⁧⁩.
  4. ⁩قم بتثبيت الوحدة النمطية Az⁧⁩ فى جلسة عمل PowerShell 5.1.

لإكمال هذا البرنامج التعليمي، مطلوب حساب أتمتة Azure للاحتفاظ بدفتر التشغيل الذي يتم تشغيله من اشتراك شبكة الأحداث Azure.

استيراد نموذج دفتر التشغيل لـ Event Grid

  1. حدد حساب التنفيذ التلقائي، وحدد صفحة Runbooks .

    تحديد دفاتر التشغيل

  2. حدد الزر استعراض المعرض.

  3. البحث عن شبكة الأحداث، وحدد دمج أتمتة Azure مع شبكة الأحداث.

    استيراد معرض دفتر التشغيل

  4. حدد استيراد وضع له الاسم Watch-VMWrite.

  5. بعد استيراده، حدد تحرير لعرض مصدر دفتر التشغيل.

  6. تحديث السطر 74 في البرنامج النصي لاستخدام Tag بدلاً من Tags.

    Update-AzureRmVM -ResourceGroupName $VMResourceGroup -VM $VM -Tag $Tag | Write-Verbose
    
  7. ثم حدد الزر ⁧⁩نشر⁧

إنشاء الإخطار على الويب في Microsoft Teams اختياري

  1. في Microsoft Teams، حدد خيارات إضافية بجوار اسم القناة، ثم حدد الموصلات.

    اتصالات Microsoft Teams

  2. قم بالتمرير عبر قائمة الموصلات إلى Webhook الوارد، وحدد إضافة.

  3. أدخل ⁩AzureAutomationIntegration⁦ كاسم، وحدد إنشاء.

  4. انسخ عنوان URL الإخطار على الويب إلى الحافظة واحفظه. يتم استخدام عنوان URL webhook لإرسال المعلومات إلى Microsoft Teams.

  5. حدد تم لحفظ webhook.

إنشاء webhook لدفتر التشغيل

  1. افتح دفتر التشغيل Watch-VMWrite.

  2. حدد Webhooks، وحدد الزر إضافة Webhook.

  3. أدخل WatchVMEventGrid كاسم. انسخ URL إلى الحافظة، واحفظه.

    تكوين اسم الإخطار على الويب

  4. حدد تكوين المعلمات وتشغيل الإعدادات، وأدخل عنوان URL Microsoft Teams للإخطار على الويب لـ CHANNELURL. اترك WEBHOOKDATA فارغًا.

    تكوين معلمات الإخطار على الويب

  5. حدد إنشاء لإنشاء الإخطار على الويب لكتاب تشغيل الأتمتة.

إنشاء اشتراك Event Grid

  1. في صفحة نظرة عامة على حساب التنفيذ التلقائي، حدد شبكة الأحداث.

    حدد Event Grid

  2. انقر على ⁧⁩‎+ Event Subscription⁧⁩.

  3. يتم تكوين الاشتراك بالمعلومات التالية:

    1. بالنسبة لنوع الموضوع، حدد اشتراكات Azure.

    2. ألغ تحديد خانة الاختيار الاشتراك في جميع أنواع الأحداث.

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

    4. في القائمة المنسدلة أنواع الأحداث المعرفة، قم بإلغاء تحديد كافة الخيارات باستثناء "نجاح كتابة الموارد".

      ملاحظة

      لا يفرق Azure Resource Manager حاليًا بين الإنشاء والتحديث، لذا فإن تنفيذ هذا البرنامج التعليمي لجميع أحداث Microsoft.Resources.ResourceWriteSuccess في اشتراك Azure الخاص بك قد يؤدي إلى عدد كبير من المكالمات.

    5. بالنسبة إلى ⁧⁩نوع نقطة النهاية⁧⁩، حدد⁧⁩Webhook⁧⁩.

    6. انقر على ⁧⁩حدد نقطة نهاية⁧⁩ في الصفحة تحديد الإخطار على الويب الذي يفتح، قم بلصق رابط الإخطار على الويب الذي أنشأته لدفتر التشغيل Watch-VMWrite.

    7. ضمن عوامل التصفية، أدخل مجموعة الاشتراك والموارد حيث تريد البحث عن الأجهزة الظاهرية الجديدة التي تم إنشاؤها. يجب أن تبدو كما يلي:⁧/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachines

  4. حدد إنشاء لحفظ اشتراك شبكة الأحداث.

إنشاء جهاز VM الذي يقوم بتشغيل دفتر التشغيل

  1. إنشاء VM جديد في مجموعة الموارد المحددة في عامل تصفية بادئة الاشتراك في Event Grid.

  2. يجب استدعاء دفتر التشغيل Watch-VMWrite وإضافة علامة جديدة إلى VM.

    علامة VM

  3. يتم إرسال رسالة جديدة إلى قناة Microsoft Teams.

    إخطار Microsoft Teams

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

في هذا البرنامج التعليمي، يمكنك إعداد التكامل بين شبكة الأحداث والأتمتة. تعلمت كيفية القيام بالتالي:

  • استيراد نموذج دفتر التشغيل لـ Event Grid
  • إنشاء webhook Microsoft Teams اختياري.
  • إنشاء webhook لدفتر التشغيل
  • إنشاء اشتراك Event Grid.
  • إنشاء جهاز VM الذي يقوم بتشغيل دفتر التشغيل.