Aracı denetimini kullanarak IoT Hub için Cihaz Güncelleştirmesi'nde eksik cihazları bulma ve düzeltme

IoT Hub için Cihaz Güncelleştirmesi örneğinizde eksik cihazları bulmak, tanılamak ve düzeltmek için aracı denetimi özelliğini kullanmayı öğrenin.

Önkoşullar

• IoT Hub için Cihaz Güncelleştirmesi'nin etkinleştirildiği bir IoT Hub'a erişim.
• Cihaz Güncelleştirmesi için sağlanan ve uyumlu bir Tak ve Kullan (PnP) model kimliğini bildiren bir IoT cihazı (veya simülatörü).

Not

Aracı denetimi özelliği yalnızca Cihaz Güncelleştirmesi aracısının yüklü olduğu ve IoT Hub için Cihaz Güncelleştirmesi ile uyumlu olan bir PnP modeli kimliği bildiren cihazlarda doğrulama denetimleri gerçekleştirebilir.

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 .

Aracı denetimi tarafından desteklenen doğrulama denetimleri

Aracı denetimi özelliği şu anda yukarıdaki önkoşulları karşılayan tüm cihazlarda aşağıdaki doğrulama denetimlerini gerçekleştirir.

Doğrulama denetimi	Ölçütler
PnP model kimliği	PnP model kimliği, Cihaz Güncelleştirmesi aracısı tarafından cihaz/bulut iletişimi için hangi PnP modelinin kullanılması gerektiğini açıklayan bir dizedir. Bu dize, Cihaz Güncelleştirmesi arabirimini destekleyen geçerli bir dijital ikiz modeli tanımlayıcısı (DTMI) olmalıdır.
Arabirim Kimliği	Arabirim kimliği, Cihaz Güncelleştirmesi aracısı tarafından cihaz/bulut iletişimi için hangi Cihaz Güncelleştirmesi arabirim sürümünün kullanılması gerektiğini açıklayan cihaz ikizi tarafından bildirilen bir dizedir. Bu dize, Cihaz Güncelleştirmesi arabirimini destekleyen geçerli bir DTMI olmalıdır.
Uyumluluk özelliği adları	CompatPropertyNames , Cihaz Güncelleştirmesi aracısı tarafından cihaz ikizi tarafından bildirilen ve cihazın belirli bir dağıtımla uyumluluğunu belirlemek için hangi deviceProperties alanların kullanılması gerektiğini açıklayan bir alandır. Bu alanın değeri virgülle ayrılmış adlardan oluşan bir dize olmalıdır. Dize en az bir ve en fazla beş ad içermelidir. Her ad 32 karakter olmalıdır <.
Uyumluluk özelliği değerleri	Uyumluluk özelliği değerleri, alan tarafından compatPropertyNames belirtilen ve Cihaz Güncelleştirme aracısı tarafından cihaz ikizi olarak bildirilen alan:değer çiftleridir deviceProperties. Uyumluluk özellik adlarında tanımlanan her adın raporlanan karşılık gelen bir alan:değer çifti olması gerekir. Her çiftin değeri 64 karakterle sınırlıdır.
ADU grubu	ADU Grubu etiketi, cihazın cihaz ikizinde tanımlanan ve cihazın hangi cihaz grubuna ait olduğunu belirleyen isteğe bağlı bir etikettir. Belirtilirse, etiket dizesi 255 karakterle sınırlıdır ve yalnızca alfasayısal karakterler ve şu özel karakterleri içerebilir: "." "-" "_" "~"

Bir cihaz bu ölçütlerden herhangi birini başarısız olursa Cihaz Güncelleştirmesi'nde düzgün görünmeyebilir. Belirtilen ölçütleri karşılamak için geçersiz değerin düzeltilmesi, cihazın Cihaz Güncelleştirmesi'nde düzgün görünmesine neden olmalıdır. Cihaz Cihaz Güncelleştirmesi'nde veya aracı denetiminde görünmüyorsa, sorunu çözmek için cihaz eşitlemeyi çalıştırmanız gerekebilir.

Aracı denetimi sonuçlarını görüntüleme

Azure portalı

Aracı denetiminin sonuçları Cihaz Güncelleştirmesi'nin tanılama sekmesinde bulunabilir.

1. Azure portalında IoT hub'ınıza gidin.
2. Gezinti menüsünden Güncelleştirmeler seçin ve ardından Tanılama sekmesini seçin.
3. Eksik cihazları bul bölümünü genişletin.

Azure CLI

Cihazlarınızın durumunu görüntülemek için az iot du device health list komutunu kullanın.

komutu device health list aşağıdaki bağımsız değişkenleri alır:

• --account: Cihaz Güncelleştirme hesabının adı.
• --instance: Cihaz Güncelleştirme örneğinin adı.
• --filter: Cihaz durumu veya cihaz kimliğine göre filtreleme içeren bir cihaz sistem durumu filtresi. Örneğin:
  • Tüm iyi durumdaki cihazları listelemek için state eq 'Healthy'
  • Tüm iyi durumda olmayan cihazları listelemek için state eq 'Unhealthy'
  • Hedef cihazın sistem durumunu göstermek için veya deviceId eq '<device_name>'deviceId eq '<device_name>' and moduleId eq '<module_name>'

az iot du device health list --account <Device Update account name> --instance <Device Update instance name> --filter "<filter query>"

Cihaz eşitleme işlemi başlatma

Cihaz IoT hub'ına kayıtlıysa ancak Cihaz Güncelleştirmesi'nde veya aracı denetimi sonuçlarında görünmüyorsa cihaz eşitleme tetiklenmelidir.

Her Cihaz Güncelleştirmesi örneği için aynı anda yalnızca bir cihaz eşitleme işlemi etkin olabilir.

Azure portalı

1. Azure portalında IoT hub'ınıza gidin.
2. Gezinti menüsünden Güncelleştirmeler seçin ve ardından Tanılama sekmesini seçin.
3. Cihaz durumunu görüntüle bölümünü genişletin.
4. Cihaz eşitlemeyi başlat'ı seçin.

Azure CLI

Cihazları ve modülleri bağlı bir IoT hub'ından Cihaz Güncelleştirmesi örneğine aktarmak için az iot du device import komutunu kullanın.

az iot du device import --account <Device Update account name> --instance <Device Update instance name>

Sonraki adımlar

Cihaz Güncelleştirmesi'nin tanılama özellikleri hakkında daha fazla bilgi edinmek için bkz . Cihaz güncelleştirmesi tanılama özelliğine genel bakış