az iot du device class

  • Referensi

Catatan

Referensi ini adalah bagian dari ekstensi azure-iot untuk Azure CLI (versi 2.37.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah kelas perangkat az iot du. Pelajari lebih lanjut tentang ekstensi.

Manajemen subgrup kelas perangkat dan kelas perangkat.

Kelas perangkat menjelaskan sekumpulan perangkat yang berbagi sekumpulan atribut umum di seluruh grup sementara subgrup kelas perangkat adalah subset perangkat dalam grup yang memiliki id kelas perangkat yang sama. Kelas perangkat dibuat secara otomatis saat perangkat yang diaktifkan Pembaruan Perangkat tersambung ke hub.

Perintah

Nama Deskripsi Jenis Status
az iot du device class delete

Menghapus subgrup kelas perangkat atau kelas perangkat.

 Ekstensi GA
az iot du device class list

Mencantumkan kelas perangkat atau subgrup kelas perangkat.

 Ekstensi GA
az iot du device class show

Tampilkan detail tentang kelas perangkat atau subgrup kelas perangkat termasuk pembaruan yang dapat diinstal, pembaruan terbaik, dan kepatuhan pembaruan.

 Ekstensi GA
az iot du device class update

Memperbarui kelas perangkat.

 Ekstensi GA

az iot du device class delete

Menghapus subgrup kelas perangkat atau kelas perangkat.

Kelas perangkat secara otomatis dibuat ketika perangkat yang mendukung Pembaruan Perangkat terhubung ke hub tetapi tidak dibersihkan secara otomatis karena direferensikan oleh subgrup kelas perangkat. Jika semua subgrup kelas perangkat untuk kelas perangkat target dihapus maka kelas perangkat itu sendiri juga dapat dihapus untuk menghapus rekaman dari sistem dan untuk berhenti memeriksa kompatibilitas kelas perangkat dengan pembaruan baru. Jika perangkat pernah terhubung kembali, kelas perangkatnya akan dibuat ulang jika tidak ada.

az iot du device class delete --account
                              --cid
                              --instance
                              [--gid]
                              [--resource-group]
                              [--yes {false, true}]

Contoh

Menghapus kelas perangkat.

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id}

Hapus kelas perangkat dan lewati perintah konfirmasi.

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} -y

Menghapus subgrup kelas perangkat.

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id}

Parameter yang Diperlukan

--account -n

Nama akun Pembaruan Perangkat. Anda dapat mengonfigurasi nama akun default menggunakan az config set defaults.adu_account=<name>.

--cid --class-id

Id kelas perangkat. Ini dihasilkan dari Id model dan properti kompat yang dilaporkan oleh agen pembaruan perangkat di antarmuka PnP Pembaruan Perangkat di IoT Hub. Ini adalah hash SHA1 yang dikodekan hex.

--instance -i

Nama instans Pembaruan Perangkat. Anda dapat mengonfigurasi nama instans default menggunakan az config set defaults.adu_instance=<name>.

Parameter Opsional

--gid --group-id

Id grup perangkat. Ini dibuat dari nilai tag ADUGroup di perangkat/modul kembar IoT Hub yang terhubung atau $default untuk perangkat tanpa tag.

--resource-group -g

Nama grup sumber daya akun Pembaruan Perangkat. Anda dapat mengonfigurasi grup default menggunakan az config set defaults.adu_group=<name>.

--yes -y

Lewati permintaan pengguna. Menunjukkan penerimaan tindakan. Digunakan terutama untuk skenario otomatisasi. Default: false.

nilai yang diterima: false, true
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az iot du device class list

Mencantumkan kelas perangkat atau subgrup kelas perangkat.

az iot du device class list --account
                            --instance
                            [--filter]
                            [--gid]
                            [--resource-group]

Contoh

Mencantumkan kelas perangkat dalam instans.

az iot du device class list -n {account_name} -i {instance_name}

Mencantumkan kelas perangkat instans yang difilter berdasarkan nama yang mudah diingat.

az iot du device class list -n {account_name} -i {instance_name} --filter "friendlyName eq 'my-favorite-class'"

Mencantumkan subgrup kelas perangkat untuk grup.

az iot du device class list -n {account_name} -i {instance_name} --group-id {device_group_id}

Cantumkan subgrup kelas perangkat untuk grup, difilter menurut compatProperties/manufacturer.

az iot du device class list -n {account_name} -i {instance_name} --group-id {device_group_id} --filter "compatProperties/manufacturer eq 'Contoso'"

Parameter yang Diperlukan

--account -n

Nama akun Pembaruan Perangkat. Anda dapat mengonfigurasi nama akun default menggunakan az config set defaults.adu_account=<name>.

--instance -i

Nama instans Pembaruan Perangkat. Anda dapat mengonfigurasi nama instans default menggunakan az config set defaults.adu_instance=<name>.

Parameter Opsional

--filter

Jika disediakan dengan --group-id, mendukung pemfilteran berdasarkan nama dan nilai properti kompat kelas perangkat. Misalnya "compatProperties/manufacturer eq 'Contoso'". Jika tidak, mendukung pemfilteran berdasarkan nama ramah kelas.

--gid --group-id

Id grup perangkat. Ini dibuat dari nilai tag ADUGroup di perangkat/modul kembar IoT Hub yang terhubung atau $default untuk perangkat tanpa tag.

--resource-group -g

Nama grup sumber daya akun Pembaruan Perangkat. Anda dapat mengonfigurasi grup default menggunakan az config set defaults.adu_group=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az iot du device class show

Tampilkan detail tentang kelas perangkat atau subgrup kelas perangkat termasuk pembaruan yang dapat diinstal, pembaruan terbaik, dan kepatuhan pembaruan.

az iot du device class show --account
                            --cid
                            --instance
                            [--best-update {false, true}]
                            [--gid]
                            [--installable-updates {false, true}]
                            [--resource-group]
                            [--update-compliance {false, true}]

Contoh

Menampilkan kelas perangkat.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id}

Tampilkan pembaruan yang dapat diinstal untuk kelas perangkat. Bendera ini memodifikasi perintah untuk mengembalikan daftar.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --installable-updates

Tampilkan subgrup kelas perangkat.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id}

Tampilkan pembaruan terbaik yang tersedia untuk subgrup kelas perangkat.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id} --best-update

Tampilkan kepatuhan pembaruan untuk subgrup kelas perangkat.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id} --update-compliance

Parameter yang Diperlukan

--account -n

Nama akun Pembaruan Perangkat. Anda dapat mengonfigurasi nama akun default menggunakan az config set defaults.adu_account=<name>.

--cid --class-id

Id kelas perangkat. Ini dihasilkan dari Id model dan properti kompat yang dilaporkan oleh agen pembaruan perangkat di antarmuka PnP Pembaruan Perangkat di IoT Hub. Ini adalah hash SHA1 yang dikodekan hex.

--instance -i

Nama instans Pembaruan Perangkat. Anda dapat mengonfigurasi nama instans default menggunakan az config set defaults.adu_instance=<name>.

Parameter Opsional

--best-update

Bendera yang menunjukkan perintah harus mengambil pembaruan terbaik yang tersedia untuk subgrup kelas perangkat termasuk hitungan berapa banyak perangkat yang memerlukan pembaruan. Id Grup diperlukan untuk bendera ini. Pembaruan terbaik adalah pembaruan terbaru yang memenuhi semua spesifikasi kompatibilitas kelas perangkat.

nilai yang diterima: false, true
--gid --group-id

Id grup perangkat. Ini dibuat dari nilai tag ADUGroup di perangkat/modul kembar IoT Hub yang terhubung atau $default untuk perangkat tanpa tag.

--installable-updates

Bendera yang menunjukkan perintah harus mengambil pembaruan yang dapat diinstal untuk kelas perangkat.

nilai yang diterima: false, true
--resource-group -g

Nama grup sumber daya akun Pembaruan Perangkat. Anda dapat mengonfigurasi grup default menggunakan az config set defaults.adu_group=<name>.

--update-compliance

Bendera yang menunjukkan perintah harus mengambil informasi kepatuhan pembaruan subgrup kelas perangkat, seperti berapa banyak perangkat pada pembaruan terbaru mereka, berapa banyak yang memerlukan pembaruan baru, dan berapa banyak yang sedang berlangsung saat menerima pembaruan baru. Id Grup diperlukan untuk bendera ini.

nilai yang diterima: false, true
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az iot du device class update

Memperbarui kelas perangkat.

az iot du device class update --account
                              --cid
                              --instance
                              [--friendly-name]
                              [--resource-group]

Contoh

Perbarui nama ramah kelas perangkat.

az iot du device class update -n {account_name} -i {instance_name} --class-id {device_class_id} --friendly-name "EU-region"

Parameter yang Diperlukan

--account -n

Nama akun Pembaruan Perangkat. Anda dapat mengonfigurasi nama akun default menggunakan az config set defaults.adu_account=<name>.

--cid --class-id

Id kelas perangkat. Ini dihasilkan dari Id model dan properti kompat yang dilaporkan oleh agen pembaruan perangkat di antarmuka PnP Pembaruan Perangkat di IoT Hub. Ini adalah hash SHA1 yang dikodekan hex.

--instance -i

Nama instans Pembaruan Perangkat. Anda dapat mengonfigurasi nama instans default menggunakan az config set defaults.adu_instance=<name>.

Parameter Opsional

--friendly-name

Nama ramah kelas perangkat. Nama yang mudah diingat harus 1 - 100 karakter dan mendukung nilai alfanumerik, titik, dan tanda hubung.

--resource-group -g

Nama grup sumber daya akun Pembaruan Perangkat. Anda dapat mengonfigurasi grup default menggunakan az config set defaults.adu_group=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.