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

IoT Hub için Cihaz Güncelleştirmesi, bir grup IoT cihazına güncelleştirme dağıtmaya olanak tanır. Bu adım, yönetilen cihazlarınıza güncelleştirme dağıtırken isteğe bağlıdır. Sizin için oluşturulan varsayılan grubu kullanarak cihazlarınıza güncelleştirme dağıtabilirsiniz. Alternatif olarak, cihazlarınıza kullanıcı tanımlı bir etiket atayabilirsiniz ve bunlar etikete ve cihaz uyumluluk özelliklerine göre otomatik olarak gruplandırılır.

Not

Kullanıcı tarafından oluşturulan bir grup yerine varsayılan bir gruba dağıtmak istiyorsanız, Güncelleştirme dağıtma bölümüne geçin.

Önkoşullar

• IoT Hub için Cihaz Güncelleştirmesi'nin etkinleştirildiği bir IoT Hub'a erişim. IoT Hub'ınız için bir S1 (Standart) katmanı veya üzerini kullanmanızı öneririz.
• IoT Hub içinde Cihaz Güncelleştirmesi için sağlanan bir IoT cihazı (veya simülatörü).
  • IoT cihazınıza Cihaz Güncelleştirmesi aracısını modül veya cihaz düzeyinde kimlik olarak yükleyin ve başlatın.
• Sağlanan cihaz için içeri aktarılan bir güncelleştirme.

Azure portalı

Desteklenen tarayıcılar:

• Microsoft Edge
• Google Chrome

Azure CLI

Azure CLI ortamı:

• Azure Cloud Shell'de Bash ortamını kullanın.

  

• Veya CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin

  1. az login komutunu kullanarak Azure CLI'da oturum açın .
  2. Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.
  3. İstendiğinde, azure CLI uzantılarını ilk kullanımda yükleyin. Bu makaledeki komutlar azure-iot uzantısını kullanır. Uzantının en son sürümünü kullandığınızdan emin olmak için komutunu çalıştırın az extension update --name azure-iot .

Cihazlarınıza etiket ekleme

Cihaz grubu oluşturmak için ilk adım, IoT Hub'daki hedef cihaz kümesine etiket eklemektir. Etiketler yalnızca Cihaz Güncelleştirmesi'ne bağlandıktan sonra cihazınıza başarıyla eklenebilir.

Cihaz Güncelleştirmesi etiketleri aşağıdaki örnekteki 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.

Aşağıdaki bölümlerde etiketleri eklemenin ve güncelleştirmenin farklı 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:

• Örnek bir .NET uygulaması kullanarak etiket eklemeyi öğrenin.
• Etiket özellikleri hakkında bilgi edinin.

Cihaz Güncelleştirme aracınız cihaz kimliğiyle sağlanmışsa cihaz ikizi veya Cihaz Güncelleştirme aracısı bir modül kimliğiyle sağlanmışsa ilgili modül ikizine etiketler ekleyin.

İşleri kullanarak etiket ekleme

Cihaz Güncelleştirme etiketi eklemek veya güncelleştirmek için birden çok cihazda iş 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 eylem, IoT Hub iletileri kotanıza göre sayılır. Aynı anda en fazla 50.000 cihaz veya modül ikizi etiketini değiştirmenizi öneririz; aksi takdirde günlük IoT Hub ileti kotanızı aşarsanız 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

Etiketler doğrudan cihaz veya modül ikizlerine de eklenebilir veya güncelleştirilebilir.

Azure portalı

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

2. Sol gezinti bölmesindeki Cihazlar veya IoT Edge'den IoT cihazınızı bulun. Cihaz Güncelleştirme aracısının bir cihaz veya modül kimliğiyle sağlanıp sağlanmadığına bağlı olarak cihaz ikizi veya Cihaz Güncelleştirme modülüne ve ardından modül ikizine gidin.

3. İkiz ayrıntılarında, mevcut Cihaz Güncelleştirme etiketi değerlerini null olarak ayarlayarak silin.

4. Aşağıda gösterildiği gibi yeni bir Cihaz Güncelleştirmesi etiket değeri ekleyin.

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

Azure CLI

Cihaza veya modül ikizine etiket eklemek için az iot hub device-twin update veya az iot hub module-twin update kullanın.

Her iki update komut --tags için de bağımsız değişken satır içi json veya json içeriğinin dosya yolunu kabul eder.

Örneğin:

az iot hub module-twin update \
    --hub-name <IoT Hub name> \
    --device-id <device name> \
    --module-id <module name> \
    --tags '{"ADUGroup": "<custom_tag_value"}'

Sınırlamalar

• etiketinize ayrılmış değerler olan ve $defaultdışında Uncategorized herhangi bir değer ekleyebilirsiniz.
• Etiket değeri 200 karakteri aşamaz.
• Etiket değeri alfasayısal karakterler ve şu özel karakterleri içerebilir: . - _ ~.
• Etiket ve grup adları büyük/küçük harfe duyarlıdır.
• Bir cihazın ADUGroup adlı tek bir etiketi olabilir. Bu ada sahip bir etiketin eklenmesi, ADUGroup etiket adı için mevcut değeri geçersiz kılar.
• Bir cihaz yalnızca bir gruba ait olabilir.

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

Gruplar, atanan etiketlere ve cihazların uyumluluk özelliklerine göre otomatik olarak oluşturulur. Bir grubun farklı cihaz sınıflarına sahip birden çok alt grubu olabilir.

Azure portalı

1. Azure portalında, daha önce Cihaz Güncelleştirmesi örneğinize bağladığınız IoT hub'ına gidin.

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

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

   

4. Bir grup oluşturulduktan sonra uyumluluk grafiğinin ve grup listesinin güncelleştirildiğini görürsünüz. 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.

   

5. Mevcut grupları ve bu gruplardaki cihazlar için kullanılabilir güncelleştirmeleri grup listesinde görmeniz gerekir. Grubun cihaz sınıfı gereksinimlerini karşılamamış cihazlar varsa, bunlar ilgili geçersiz grupta gösterilir. Grubun yanındaki Dağıt düğmesini seçerek bu görünümden bir gruba kullanılabilir en iyi güncelleştirmeyi dağıtabilirsiniz.

Azure CLI

Bir Cihaz Güncelleştirmesi örneğindeki tüm cihaz gruplarını görüntülemek için az iot du device group list komutunu kullanın.

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>

Döndürülen grupları grup kimliği, cihaz sayısı veya kullanılabilir yeni güncelleştirmelerle alt grupların sayısı gibi yönlere göre sıralamak için bağımsız değişkenini kullanabilirsiniz --order-by .

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

Azure portalı

1. Gruplar ve Dağıtımlar sekmesinde, görüntülemek istediğiniz grubun adını seçin.

2. Grup ayrıntıları sayfasında, grubun parçası olan cihazların listesini ve cihaz güncelleştirme özelliklerini görebilirsiniz. Bu görünümde, grubun üyesi olan tüm cihazlar için güncelleştirme uyumluluk bilgilerini de görebilirsiniz. Uyumluluk grafiği, çeşitli uyumluluk durumlarındaki cihazların sayısını gösterir.

   

3. IoT Hub'daki cihaz ayrıntıları sayfasına yönlendirilecek bir grup içindeki tek bir cihazı da seçebilirsiniz.

   

   

Azure CLI

Belirli bir cihaz grubunun ayrıntılarını görüntülemek için az iot du device group show komutunu kullanın.

İsteğe bağlı --best-updates bayrağı, cihaz grubu için en iyi kullanılabilir güncelleştirmelerin listesini döndürür ve her güncelleştirmeye kaç cihazın ihtiyacı olduğunu gösterir.

İsteğe bağlı --update-compliance bayrağı, cihaz grubu için en son güncelleştirmede kaç cihazın bulunduğu, kaç yeni güncelleştirme gerektiği ve yeni bir güncelleştirme için devam eden cihazların sayısını içeren uyumluluk bilgilerini döndürür.

az iot du device group show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <value of the ADUGroup tag for this group>

Cihaz grubundan cihaz kaldırma

Cihazı bir cihaz grubundan kaldırmak için ADUGroup etiket değeri "null" olarak değiştirilmelidir.

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

Bu işlem cihaz ikizinden ADUGroup etiketini siler ve cihazı cihaz grubundan kaldırır.

Cihaz gruplarını silme

Cihaz grupları otomatik olarak oluşturulurken, gruplar, cihaz sınıfları ve dağıtımlar, geçmiş kayıtlarda veya diğer kullanıcı gereksinimlerinde tutulacak şekilde otomatik olarak temizlenmez. Cihaz grupları, istenen grupları tek tek seçip silerek veya grupta DELETE API'sini çağırarak Azure portalı üzerinden silinebilir. Daha fazla bilgi edinin

Grup silindikten sonra bir cihaz bu grup için yeniden bağlanırsa, grup otomatik olarak yeniden oluşturulurken ilişkili cihaz veya dağıtım geçmişi olmaz.

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

• Grupta NO üye cihazları olmalıdır. Bu, Cihaz Güncelleştirmesi örneğinde sağlanan hiçbir cihazın, seçilen grubun adıyla eşleşen bir değere sahip bir ADUGroup etiketine sahip olmaması gerektiği anlamına gelir.
• Grup varsayılan bir grup DEĞİl olmalıdır.
• Grubun ilişkili etkin veya iptal edilmiş dağıtımları YOK olmalıdır.

Not

Yukarıdaki gereksinimleri karşıladıktan sonra yine de bir grubu silemiyorsanız, grubun bir parçası olarak etiketlenmiş iyi durumda olmayan cihazlarınız olup olmadığını doğrulayın. İyi durumda olmayan cihazlar, dağıtım alamayan cihazlardır ve sonuç olarak bir grup içindeki üye cihazlar listesinde doğrudan gösterilmez. Cihaz Güncelleştirme Portalı deneyimindeki Tanılama sekmesinde "Eksik cihazları bul" seçeneğine giderek iyi durumda olmayan cihazlarınız olup olmadığını doğrulayabilirsiniz. Grubun bir parçası olarak etiketlenmiş iyi durumda olmayan cihazlarınız varsa, grubunuzu silmeye çalışmadan önce etiket değerini değiştirmeniz veya cihazı tamamen silmeniz gerekir.

Sonraki Adımlar

• Güncelleştirme dağıtma

• Cihaz grupları hakkında daha fazla bilgi edinin

• Cihaz Güncelleştirmesi uyumluluğu hakkında daha fazla bilgi edinin