مشاركة عبر

إدارة مجموعات الأجهزة لتحديث جهاز Azure ل IoT Hub

  • مقالة

يسمح Azure Device Update ل IoT Hub بنشر التحديثات على مجموعات محددة من قبل المستخدم من أجهزة IoT. كل جهاز مدار بواسطة Device Update هو عضو في مجموعة أجهزة، ولكن تعريف مجموعات الأجهزة اختياري. يمكنك بدلا من ذلك النشر إلى مجموعة الأجهزة الافتراضية التي يوفرها تحديث الجهاز.

إذا قمت بإنشاء قيم علامات تحديث الجهاز المعرفة من قبل المستخدم وتعيينها للأجهزة، يقوم Device Update تلقائيا بإنشاء مجموعات استنادا إلى العلامات المعينة وخصائص توافق الجهاز. لكل مجموعة أجهزة، يمكن ل Device Update إنشاء مجموعات فرعية متعددة لها فئات أجهزة مختلفة. يضع Device Update الأجهزة التي لا تحتوي على default علامات في مجموعة الأجهزة.

توضح هذه المقالة كيفية استخدام مدخل Microsoft Azure أو Azure CLI لإنشاء علامات ومجموعات جهاز تحديث الجهاز المعرفة من قبل المستخدم وإدارتها. لنشر التحديثات إلى مجموعات الأجهزة المعرفة من قبل المستخدم أو الافتراضية، راجع نشر تحديث الجهاز.

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

إضافة علامات إلى أجهزتك

لتعيين مجموعة أجهزة تحديث الجهاز، يمكنك إضافة العلامة ADUGroup إلى مجموعة مستهدفة من الأجهزة المتصلة بتحديث الجهاز في IoT Hub. أضف العلامة إلى الجهاز المزدوج إذا تم تزويد عامل Device Update بهوية الجهاز، أو إلى الوحدة النمطية المزدوجة المقابلة إذا تم توفير عامل Device Update بهوية وحدة نمطية.

تستخدم علامة تحديث ADUGroup الجهاز تنسيق قيمة المفتاح، كما هو موضح في المثال التالي للجهاز أو الوحدة النمطية المزدوجة:

"etag": "",
"deviceId": "",
"deviceEtag": "",
"version": <version>,
"tags": {
   "ADUGroup": "<CustomTagValue>"
}

لمزيد من المعلومات والأمثلة عن بناء جملة JSON المزدوج، راجع فهم واستخدام توائم الجهاز أو فهم واستخدام توائم الوحدة النمطية.

ADUGroup العلامة لها الخصائص والقيود التالية:

  • يمكن أن يكون للجهاز علامة واحدة ADUGroup فقط وينتمي إلى مجموعة تحديث جهاز واحدة فقط في كل مرة. إضافة علامة أخرى تسمى ADUGroup تتجاوز القيمة الموجودة ADUGroup .
  • يمكنك استخدام أي قيمة للعلامة باستثناء القيم Uncategorized المحجوزة و $default.
  • لا يمكن أن تتجاوز قيمة العلامة 200 حرف.
  • يمكن أن تحتوي قيمة العلامة على أحرف أبجدية رقمية والأحرف الخاصة التالية: . - _ ~.
  • ADUGroup اسم العلامة وقيم اسم المجموعة حساسة لحالة الأحرف.

تصف الأقسام التالية عدة طرق لإضافة العلامة وتحديثها.

إضافة علامات باستخدام SDKs

يمكنك تحديث الجهاز أو الوحدة النمطية المزدوجة بالعلامة المناسبة باستخدام RegistryManager بعد تسجيل الجهاز باستخدام Device Update. لمزيد من المعلومات، راجع المقالات التالية:

إضافة علامات باستخدام المهام

يمكنك جدولة المهام لإضافة علامات تحديث الجهاز أو تحديثها على أجهزة متعددة. للحصول على أمثلة لعمليات الوظائف، راجع جدولة المهام على أجهزة متعددة. يمكنك تحديث توائم الجهاز أو توائم الوحدة النمطية باستخدام المهام، اعتمادا على ما إذا كان عامل تحديث الجهاز مزودا بهوية جهاز أو وحدة نمطية. لمزيد من المعلومات، راجع جدولة مهام البث والبث.

إشعار

تحسب هذه العملية مقابل الحصة النسبية لرسائل IoT Hub. إذا قمت بتغيير 50000 أو أكثر من علامات الجهاز أو الوحدة النمطية المزدوجة في كل مرة، فقد تتجاوز الحصة النسبية اليومية لرسالة IoT Hub وتحتاج إلى شراء المزيد من وحدات IoT Hub. لمزيد من المعلومات، راجع الحصص النسبية والتقييد.

إضافة علامات عن طريق تحديث التوائم

يمكنك أيضا إضافة العلامة أو تحديثها ADUGroup مباشرة في الجهاز أو الوحدة النمطية المزدوجة.

  1. في مدخل Microsoft Azure توجه إلى مركز IoT.

  2. حدد الأجهزة ضمن إدارة الأجهزة في جزء التنقل الأيمن. إذا كان لديك جهاز IoT Edge، فحدد IoT Edge بدلا من ذلك.

  3. في صفحة الأجهزة ، حدد جهازك.

  4. في صفحة الجهاز، حدد إما Device twin من القائمة العلوية، أو حدد هوية الوحدة النمطية ضمن Module identities ثم حدد الوحدة المزدوجة.

  5. في التوأم، أضف العلامة ADUGroup بقيمة معرفة من قبل المستخدم، كما يلي. لتحديث قيمة علامة موجودة ADUGroup ، قم بالكتابة فوقها بقيمة مختلفة معرفة من قبل المستخدم.

        "tags": {
            "ADUGroup": "<CustomTagValue>"
            }

  6. حدد حفظ.

عرض مجموعات الأجهزة

  1. في مدخل Microsoft Azure، انتقل إلى مركز IoT المتصل بمثيل Device Update.

  2. حدد الخيار Updates ضمن إدارة الجهاز في جزء التنقل الأيمن.

  3. حدد علامة التبويب Groups and Deployments.

    لقطة شاشة لأجهزة غير مجمعة.

بمجرد إنشاء مجموعة، يتم تحديث مخطط التوافق وقائمة المجموعة. يعرض مخطط توافق Device Update عدد الأجهزة في حالات التوافق المختلفة: في التحديث الأخير والتحديثات الجديدة المتوفرة والتحديثات قيد التقدم. لمزيد من المعلومات، راجع توافق تحديث الجهاز.

تظهر مجموعات تحديث الأجهزة الموجودة وأي تحديثات متوفرة للأجهزة الموجودة في هذه المجموعات في قائمة المجموعة. تظهر أي أجهزة لا تفي بمتطلبات فئة الجهاز للمجموعة في مجموعة غير صالحة مقابلة. يمكنك نشر أفضل تحديث متوفر لمجموعة من طريقة العرض هذه عن طريق تحديد Deploy بجوار المجموعة.

لقطة شاشة لطريقة عرض التوافق مع التحديث.

عرض تفاصيل الجهاز لمجموعة

  1. من علامة التبويب المجموعات والنشرات ، حدد اسم المجموعة.

    تعرض صفحة تفاصيل المجموعة مخطط توافق التحديث مع عدد الأجهزة الأعضاء في المجموعة في حالات الامتثال المختلفة، وقائمة الأجهزة الأعضاء في المجموعة مع خصائص تحديث الأجهزة الخاصة بهم.

    لقطة شاشة لعرض تفاصيل مجموعة الجهاز.

  2. حدد جهازا فرديا داخل مجموعة للانتقال إلى صفحة تفاصيل الجهاز في IoT Hub.

    لقطة شاشة لعرض تفاصيل الجهاز.

    لقطة شاشة لعرض تفاصيل الجهاز في مركز IoT.

إزالة جهاز من مجموعة أجهزة

لإزالة جهاز من مجموعة أجهزة، قم بتغيير قيمة العلامة ADUGroup إلى null في التوأم، وحدد حفظ.

    "tags": {
            "ADUGroup": "null"
            }

يحذف هذا الإجراء علامة المجموعة من الجهاز المزدوج ويزيل الجهاز من مجموعة الأجهزة.

حذف مجموعة أجهزة

ينشئ تحديث الجهاز تلقائيا مجموعات الأجهزة، ويحتفظ بمجموعات الأجهزة وفئات الأجهزة والنشرات للسجلات التاريخية أو احتياجات المستخدمين الأخرى، بدلا من تنظيفها تلقائيا. يمكنك حذف مجموعات الأجهزة من خلال مدخل Microsoft Azure عن طريق تحديد المجموعات وحذفها بشكل فردي، أو عن طريق استدعاء az iot du device group delete الأمر Azure CLI على المجموعة.

ليتم حذفها، يجب أن تفي المجموعة بالمتطلبات التالية:

  • يجب ألا تكون مجموعة default .
  • يجب ألا يكون لديك أجهزة أعضاء. أي أنه لا يمكن أن يحتوي أي جهاز تم توفيره في مثيل تحديث الجهاز على ADUGroup علامة بقيمة مطابقة لاسم المجموعة.
  • يجب ألا يكون هناك عمليات نشر نشطة أو ملغاة مقترنة.

إشعار

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

للتحقق مما إذا كان لديك أي أجهزة غير صحية:

  1. في مدخل Microsoft Azure توجه إلى مركز IoT.
  2. حدد Updates من شريط التنقل الأيمن ثم حدد علامة التبويب Diagnostics .
  3. قم بتوسيع قسم البحث عن الأجهزة المفقودة .

إذا كانت لديك أجهزة غير صحية تم وضع علامة عليها كجزء من المجموعة، فيجب تغيير قيمة العلامة أو حذف الجهاز قبل أن تتمكن من حذف المجموعة.

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

المحتوى ذو الصلة