Bagikan melalui

az iot du device group

  • Referensi

Catatan

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

Manajemen grup perangkat.

Grup perangkat adalah kumpulan perangkat. Grup perangkat menyediakan cara untuk menskalakan penyeberan ke banyak perangkat. Setiap perangkat hanya dapat dimiliki oleh satu grup perangkat. Grup perangkat dibuat secara otomatis saat perangkat yang diaktifkan Pembaruan Perangkat tersambung ke hub dan melaporkan propertinya.

Perintah

Nama Deskripsi Jenis Status
az iot du device group delete

Menghapus grup perangkat.

 Ekstensi GA
az iot du device group list

Mencantumkan grup perangkat dalam instans.

 Ekstensi GA
az iot du device group show

Tampilkan detail tentang grup perangkat termasuk pembaruan terbaik dan kepatuhan pembaruan.

 Ekstensi GA

az iot du device group delete

Menghapus grup perangkat.

Grup perangkat tidak dibersihkan secara otomatis tetapi dipertahankan untuk tujuan riwayat. Operasi ini dapat digunakan jika tidak perlu grup atau perlu mempertahankan riwayat untuk itu. Jika perangkat tersambung lagi untuk grup setelah grup dihapus, perangkat akan secara otomatis dibuat ulang tanpa riwayat.

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

Contoh

Menghapus grup perangkat.

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

Hapus grup perangkat yang melewati perintah konfirmasi.

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

Parameter yang Diperlukan

--account -n

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

--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.

--instance -i

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

Parameter Opsional

--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 group list

Mencantumkan grup perangkat dalam instans.

az iot du device group list --account
                            --instance
                            [--order-by]
                            [--resource-group]

Contoh

Mencantumkan grup perangkat.

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

Cantumkan grup perangkat dalam urutan yang diinginkan, dalam hal ini menurut deviceCount.

az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCount

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

--order-by

Mengurutkan kumpulan grup yang dikembalikan. Anda dapat memesan menurut groupId, deviceCount, createdDateTime, subgroupsWithNewUpdatesAvailableCount, subgroupsWithUpdatesInProgressCount atau subgroupsWithOnLatestUpdateCount.

--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 group show

Tampilkan detail tentang grup perangkat termasuk pembaruan terbaik dan kepatuhan pembaruan.

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

Contoh

Tampilkan grup perangkat.

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

Tampilkan pembaruan terbaik yang tersedia untuk grup perangkat. Bendera ini memodifikasi perintah untuk mengembalikan daftar.

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

Tampilkan kepatuhan pembaruan untuk grup perangkat.

az iot du device group show -n {account_name} -i {instance_name} --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>.

--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.

--instance -i

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

Parameter Opsional

--best-updates

Bendera yang menunjukkan perintah harus mengambil pembaruan terbaik yang tersedia untuk grup perangkat termasuk hitungan berapa banyak perangkat yang membutuhkan setiap pembaruan. Pembaruan terbaik adalah pembaruan terbaru yang memenuhi semua spesifikasi kompatibilitas 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 grup 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.

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.