Bagikan melalui

Mengelola grup perangkat untuk Azure Device Update for IoT Hub

  • Artikel

Azure Device Update for IoT Hub memungkinkan penyebaran pembaruan ke grup perangkat IoT yang ditentukan pengguna. Setiap perangkat terkelola Pembaruan Perangkat adalah anggota grup perangkat, tetapi menentukan grup perangkat bersifat opsional. Anda dapat menyebarkan ke grup perangkat default yang disediakan Pembaruan Perangkat.

Jika Anda membuat dan menetapkan nilai tag Pembaruan Perangkat yang ditentukan pengguna ke perangkat, Pembaruan Perangkat secara otomatis membuat grup berdasarkan tag yang ditetapkan dan properti kompatibilitas perangkat. Untuk setiap grup perangkat, Pembaruan Perangkat dapat membuat beberapa subgrup yang memiliki kelas perangkat yang berbeda. Pembaruan Perangkat menempatkan perangkat yang tidak memiliki tag dalam default grup perangkat.

Artikel ini menjelaskan cara menggunakan portal Azure atau Azure CLI untuk membuat dan mengelola tag dan grup perangkat Pembaruan Perangkat yang ditentukan pengguna. Untuk menyebarkan pembaruan ke grup perangkat yang ditentukan pengguna atau default, lihat Menyebarkan pembaruan perangkat.

Prasyarat

Menambahkan tag ke perangkat Anda

Untuk menetapkan grup perangkat Pembaruan Perangkat, Anda menambahkan ADUGroup tag ke set target perangkat yang terhubung dengan Pembaruan Perangkat di IoT Hub. Tambahkan tag ke perangkat ganda jika agen Pembaruan Perangkat Anda disediakan dengan identitas perangkat, atau ke kembaran modul yang sesuai jika agen Pembaruan Perangkat disediakan dengan identitas modul.

Tag Pembaruan ADUGroup Perangkat menggunakan format kunci-nilai, seperti yang ditunjukkan dalam contoh perangkat atau modul kembar berikut:

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

Untuk informasi selengkapnya dan contoh sintaks JSON kembar, lihat Memahami dan menggunakan kembar perangkat atau Memahami dan menggunakan modul kembar.

Tag ADUGroup memiliki properti dan batasan berikut:

  • Perangkat hanya dapat memiliki satu ADUGroup tag dan hanya termasuk dalam satu grup Pembaruan Perangkat pada satu waktu. Menambahkan tag lain bernama ADUGroup mengambil alih nilai yang ADUGroup ada.
  • Anda dapat menggunakan nilai apa pun untuk tag kecuali nilai Uncategorized yang dipesan dan $default.
  • Nilai tag tidak boleh melebihi 200 karakter.
  • Nilai tag dapat berisi karakter alfanumerik dan karakter khusus berikut: . - _ ~.
  • Nama ADUGroup tag dan nilai nama grup peka huruf besar/kecil.

Bagian berikut menjelaskan beberapa cara untuk menambahkan dan memperbarui tag.

Menambahkan tag dengan SDK

Anda dapat memperbarui perangkat atau modul kembar dengan tag yang sesuai menggunakan RegistryManager setelah Anda mendaftarkan perangkat dengan Pembaruan Perangkat. Untuk informasi lebih lanjut, baca artikel berikut:

Menambahkan tag menggunakan pekerjaan

Anda dapat menjadwalkan pekerjaan untuk menambahkan atau memperbarui tag Pembaruan Perangkat di beberapa perangkat. Untuk contoh operasi pekerjaan, lihat Menjadwalkan pekerjaan di beberapa perangkat. Anda dapat memperbarui kembar perangkat atau kembar modul menggunakan pekerjaan, tergantung pada apakah agen Pembaruan Perangkat disediakan dengan identitas perangkat atau modul. Untuk informasi selengkapnya, lihat Menjadwalkan dan menyiarkan pekerjaan.

Catatan

Operasi ini dihitung terhadap kuota pesan IoT Hub Anda. Jika Anda mengubah 50.000 atau lebih tag perangkat atau modul kembar sekaligus, Anda mungkin melebihi kuota pesan IoT Hub harian Anda dan perlu membeli lebih banyak unit IoT Hub. Untuk informasi selengkapnya, lihat Kuota dan pembatasan.

Menambahkan tag dengan memperbarui kembaran

Anda juga dapat menambahkan atau memperbarui ADUGroup tag langsung di perangkat atau modul kembar.

  1. Di portal Azure, navigasi ke hub IoT Anda.

  2. Pilih Perangkat di bawah Manajemen perangkat di panel navigasi kiri. Jika Anda memiliki perangkat IoT Edge, pilih IoT Edge sebagai gantinya.

  3. Pada halaman Perangkat , pilih perangkat Anda.

  4. Pada halaman perangkat, pilih Perangkat kembar dari menu atas, atau pilih identitas modul di bawah Identitas modul lalu pilih modul kembar.

  5. Di kembaran, tambahkan ADUGroup tag dengan nilai yang ditentukan pengguna, sebagai berikut. Untuk memperbarui nilai tag yang ada ADUGroup , timpa dengan nilai yang ditentukan pengguna yang berbeda.

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

  6. Pilih Simpan.

Menampilkan grup perangkat

  1. Di portal Azure, navigasikan ke hub IoT yang tersambung ke instans Pembaruan Perangkat Anda.

  2. Pilih opsi Pembaruan di bawah Manajemen Perangkat di navigasi kiri.

  3. Pilih tab Grup dan Penyebaran .

    Cuplikan layar perangkat yang dipisahkan.

Setelah Anda membuat grup, bagan kepatuhan dan daftar grup diperbarui. Bagan kepatuhan Pembaruan Perangkat menunjukkan jumlah perangkat di berbagai status kepatuhan: Pada pembaruan terbaru, Pembaruan baru tersedia, dan Pembaruan sedang berlangsung. Untuk informasi selengkapnya, lihat Kepatuhan Pembaruan Perangkat.

Grup Pembaruan Perangkat yang ada dan pembaruan yang tersedia untuk perangkat dalam grup tersebut muncul di daftar grup. Perangkat apa pun yang tidak memenuhi persyaratan kelas perangkat grup muncul dalam grup yang tidak valid yang sesuai. Anda dapat menyebarkan pembaruan terbaik yang tersedia ke grup dari tampilan ini dengan memilih Sebarkan di samping grup.

Cuplikan layar tampilan kepatuhan pembaruan.

Menampilkan detail perangkat untuk grup

  1. Dari tab Grup dan Penyebaran , pilih nama grup.

    Halaman Detail grup memperlihatkan bagan kepatuhan pembaruan dengan jumlah perangkat anggota grup di berbagai status kepatuhan, dan daftar perangkat anggota grup dengan properti pembaruan perangkat mereka.

    Cuplikan layar tampilan detail grup perangkat.

  2. Pilih perangkat individual dalam grup untuk masuk ke halaman detail perangkatnya di IoT Hub.

    Cuplikan layar tampilan detail perangkat.

    Cuplikan layar tampilan detail perangkat di hub IoT.

Menghapus perangkat dari grup perangkat

Untuk menghapus perangkat dari grup perangkat, ubah ADUGroup nilai tag menjadi null di kembar, dan pilih Simpan.

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

Tindakan ini menghapus tag grup dari perangkat kembar dan menghapus perangkat dari grup perangkat.

Menghapus grup perangkat

Pembaruan Perangkat secara otomatis membuat grup perangkat, dan mempertahankan grup perangkat, kelas perangkat, dan penyebaran untuk rekaman historis atau kebutuhan pengguna lain, daripada membersihkannya secara otomatis. Anda dapat menghapus grup perangkat melalui portal Azure dengan memilih dan menghapus grup secara individual, atau dengan memanggil az iot du device group delete perintah Azure CLI pada grup.

Untuk dihapus, grup harus memenuhi persyaratan berikut:

  • Tidak boleh menjadi default grup.
  • Tidak boleh memiliki perangkat anggota. Artinya, tidak ada perangkat yang disediakan dalam instans Pembaruan Perangkat yang dapat memiliki ADUGroup tag dengan nilai yang cocok dengan nama grup.
  • Tidak boleh memiliki penyebaran aktif atau dibatalkan terkait.

Catatan

Jika Anda tidak dapat menghapus grup yang memenuhi persyaratan sebelumnya, periksa apakah Anda memiliki perangkat yang tidak sehat yang ditandai sebagai bagian dari grup. Perangkat yang tidak sehat tidak dapat menerima penyebaran, sehingga tidak muncul langsung dalam daftar perangkat anggota dalam grup.

Untuk memeriksa apakah Anda memiliki perangkat yang tidak sehat:

  1. Di portal Azure, navigasi ke hub IoT Anda.
  2. Pilih Pembaruan dari navigasi kiri lalu pilih tab Diagnostik .
  3. Perluas bagian Temukan perangkat yang hilang.

Jika Anda memiliki perangkat yang tidak sehat yang ditandai sebagai bagian dari grup, Anda harus mengubah nilai tag atau menghapus perangkat sebelum dapat menghapus grup.

Jika perangkat pernah ditetapkan ke nama grup yang dihapus lagi, Pembaruan Perangkat secara otomatis membuat ulang grup, tetapi tidak ada perangkat atau riwayat penyebaran terkait.

Konten terkait