Aracılığıyla paylaş

IoT Hub için Azure Cihaz Güncelleştirmesi için cihaz gruplarını yönetme

  • Makale

IoT Hub için Azure Cihaz Güncelleştirmesi, kullanıcı tanımlı IoT cihaz gruplarına güncelleştirmelerin dağıtılmasına olanak tanır. Cihaz Güncelleştirmesi ile yönetilen her cihaz bir cihaz grubunun üyesidir, ancak cihaz gruplarını tanımlamak isteğe bağlıdır. Alternatif olarak, Cihaz Güncelleştirmesi'nin sağladığı varsayılan cihaz grubuna dağıtabilirsiniz.

Kullanıcı tanımlı Cihaz Güncelleştirmesi etiket değerlerini oluşturur ve cihazlara atarsanız, Cihaz Güncelleştirmesi atanan etiketlere ve cihaz uyumluluk özelliklerine göre otomatik olarak gruplar oluşturur. Cihaz Güncelleştirmesi, her cihaz grubu için farklı cihaz sınıflarına sahip birden çok alt grup oluşturabilir. Cihaz Güncelleştirmesi, etiket içermeyen cihazları cihaz grubuna default yerleştirir.

Bu makalede, kullanıcı tanımlı Cihaz Güncelleştirmesi cihaz etiketlerini ve gruplarını oluşturmak ve yönetmek için Azure portalını veya Azure CLI'yi nasıl kullanacağınız açıklanmaktadır. Güncelleştirmeleri kullanıcı tanımlı veya varsayılan cihaz gruplarına dağıtmak için bkz . Cihaz güncelleştirmesi dağıtma.

Önkoşullar

Cihazlarınıza etiket ekleme

Cihaz Güncelleştirmesi cihaz grubu atamak için, etiketi IoT Hub'daki Cihaz Güncelleştirmesi bağlı cihaz kümesine eklersiniz ADUGroup . Cihaz Güncelleştirme aracınız cihaz kimliğiyle sağlanmışsa cihaz ikizine veya Cihaz Güncelleştirme aracısı bir modül kimliğiyle sağlanmışsa ilgili modül ikizine etiketi ekleyin.

Cihaz Güncelleştirmesi ADUGroup etiketi, aşağıdaki cihaz veya modül ikizi örneğinde gösterildiği gibi bir anahtar-değer biçimi kullanır:

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

İkiz JSON söz dizimi hakkında daha fazla bilgi ve örnek için bkz. Cihaz ikizlerini anlama ve kullanma veya Modül ikizlerini anlama ve kullanma.

ADUGroup etiketi aşağıdaki özelliklere ve sınırlamalara sahiptir:

  • Bir cihaz tek bir ADUGroup etikete sahip olabilir ve aynı anda yalnızca bir Cihaz Güncelleştirme grubuna ait olabilir. adlı ADUGroup başka bir etiket eklemek, mevcut ADUGroup değeri geçersiz kılar.
  • ayrılmış değerler ve $defaultdışında etiket için herhangi bir değer Uncategorized kullanabilirsiniz.
  • Etiket değeri 200 karakteri aşamaz.
  • Etiket değeri alfasayısal karakterler ve şu özel karakterleri içerebilir: . - _ ~.
  • Etiket ADUGroup adı ve grup adı değerleri büyük/küçük harfe duyarlıdır.

Aşağıdaki bölümlerde etiketi eklemenin ve güncelleştirmenin çeşitli yolları açıklanmaktadır.

SDK'larla etiket ekleme

Cihazı Cihaz Güncelleştirmesi ile kaydettikten sonra RegistryManager kullanarak cihazı veya modül ikizini uygun etiketle güncelleştirebilirsiniz. Daha fazla bilgi için aşağıdaki makaleleri inceleyin:

İşleri kullanarak etiket ekleme

Birden çok cihazda Cihaz Güncelleştirmesi etiketlerini eklemek veya güncelleştirmek için işleri zamanlayabilirsiniz. İş işlemleri örnekleri için bkz . Birden çok cihazda iş zamanlama. Cihaz Güncelleştirme aracısının bir cihaz veya modül kimliğiyle sağlanıp sağlanmadığına bağlı olarak, işleri kullanarak cihaz ikizlerini veya modül ikizlerini güncelleştirebilirsiniz. Daha fazla bilgi için bkz . İşleri zamanlama ve yayınlama.

Not

Bu işlem IoT Hub iletileri kotanıza göre sayılır. Aynı anda 50.000 veya daha fazla cihaz veya modül ikizi etiketini değiştirirseniz günlük IoT Hub ileti kotanızı aşabilir ve daha fazla IoT Hub birimi satın almanız gerekebilir. Daha fazla bilgi için bkz . Kotalar ve azaltma.

İkizleri güncelleştirerek etiket ekleme

Ayrıca etiketi doğrudan cihaz veya modül ikizinde ekleyebilir veya güncelleştirebilirsiniz ADUGroup .

  1. Azure portalında IoT hub'ınıza gidin.

  2. Sol gezinti bölmesindeki Cihaz yönetimi'nin altında Cihazlar'ı seçin. IoT Edge cihazınız varsa bunun yerine IoT Edge'i seçin.

  3. Cihazlar sayfasında cihazınızı seçin.

  4. Cihaz sayfasında, üstteki menüden Cihaz ikizi'ni seçin veya Modül kimlikleri'nin altındaki modül kimliğini ve ardından modül ikizini seçin.

  5. İkizde, aşağıdaki gibi kullanıcı tanımlı bir değere sahip etiketi ekleyin ADUGroup . Mevcut ADUGroup bir etiket değerini güncelleştirmek için, bunun üzerine farklı bir kullanıcı tanımlı değer yazın.

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

  6. Kaydet'i seçin.

Cihaz gruplarını görüntüleme

  1. Azure portalında Cihaz Güncelleştirmesi örneğinize bağlı IoT hub'ına gidin.

  2. Sol gezinti bölmesindeki Cihaz Yönetimi altındaki Güncelleştirmeler seçeneğini belirleyin.

  3. Gruplar ve Dağıtımlar sekmesini seçin.

    Gruplanmamış cihazların ekran görüntüsü.

Bir grup oluşturduktan sonra uyumluluk grafiği ve grup listesi güncelleştirilir. Cihaz Güncelleştirmesi uyumluluk grafiği, çeşitli uyumluluk durumlarındaki cihazların sayısını gösterir: En son güncelleştirmede, Yeni güncelleştirmeler kullanılabilir ve Devam eden Güncelleştirmeler. Daha fazla bilgi için bkz . Cihaz Güncelleştirmesi uyumluluğu.

Mevcut Cihaz Güncelleştirme grupları ve bu gruplardaki cihazlar için kullanılabilir güncelleştirmeler grup listesinde görünür. Grubun cihaz sınıfı gereksinimlerini karşılamayen tüm cihazlar ilgili geçersiz grupta görünür. Grubun yanındaki Dağıt'ı seçerek bu görünümden bir gruba kullanılabilir en iyi güncelleştirmeyi dağıtabilirsiniz.

Güncelleştirme uyumluluğu görünümünün ekran görüntüsü.

Grup için cihaz ayrıntılarını görüntüleme

  1. Gruplar ve Dağıtımlar sekmesinde grubun adını seçin.

    Grup ayrıntıları sayfasında, çeşitli uyumluluk durumlarındaki grup üyesi cihazların sayısıyla güncelleştirme uyumluluk grafiği ve cihaz güncelleştirme özelliklerine sahip grup üyesi cihazların listesi gösterilir.

    Cihaz grubu ayrıntıları görünümünün ekran görüntüsü.

  2. IoT Hub'daki cihaz ayrıntıları sayfasına gitmek için gruptaki tek bir cihazı seçin.

    Cihaz ayrıntıları görünümünün ekran görüntüsü.

    IoT hub'ında cihaz ayrıntıları görünümünün ekran görüntüsü.

Cihaz grubundan cihaz kaldırma

Cihazı bir cihaz grubundan kaldırmak için etiket değerini ikizde olarak null değiştirin ADUGroup ve Kaydet'i seçin.

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

Bu eylem cihaz ikizinden grup etiketini siler ve cihazı cihaz grubundan kaldırır.

Cihaz grubunu silme

Cihaz Güncelleştirmesi otomatik olarak cihaz grupları oluşturur ve bunları otomatik olarak temizlemek yerine geçmiş kayıtlar veya diğer kullanıcı gereksinimleri için cihaz gruplarını, cihaz sınıflarını ve dağıtımlarını korur. Grupları tek tek seçip silerek veya gruptaki Azure CLI komutunu çağırarak az iot du device group delete Azure portalı üzerinden cihaz gruplarını silebilirsiniz.

Bir grubun silinmesi için aşağıdaki gereksinimleri karşılaması gerekir:

  • Grup olmamalıdır default .
  • Üye cihaz içermemelidir. Başka bir ADUGroup ifadeyle, Cihaz Güncelleştirmesi örneğinde sağlanan hiçbir cihazın, grubun adıyla eşleşen bir değere sahip bir etiketi olamaz.
  • İlişkili etkin veya iptal edilmiş dağıtımlar olmamalıdır.

Not

Önceki gereksinimleri karşılayan bir grubu silemiyorsanız, grubun bir parçası olarak etiketlenmiş iyi durumda olmayan cihazlarınız olup olmadığını denetleyin. İyi durumda olmayan cihazlar dağıtım alamaz, bu nedenle bir gruptaki üye cihazlar listesinde doğrudan görünmezler.

İyi durumda olmayan cihazlarınız olup olmadığını denetlemek için:

  1. Azure portalında IoT Hub'ınıza gidin.
  2. Sol gezinti bölmesinden Güncelleştirmeler'i ve ardından Tanılama sekmesini seçin.
  3. Eksik cihazları bul bölümünü genişletin.

Grubun bir parçası olarak etiketlenmiş iyi durumda olmayan cihazlarınız varsa, grubu silebilmeniz için önce etiket değerini değiştirmeniz veya cihazı silmeniz gerekir.

Bir cihaz bir kez daha silinmiş bir grup adına atanırsa, Cihaz Güncelleştirmesi grubu otomatik olarak yeniden oluşturur, ancak ilişkili cihaz veya dağıtım geçmişi yoktur.

İlgili içerik