az iot du device deployment

  • 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 penyebaran perangkat az iot du. Pelajari lebih lanjut tentang ekstensi.

Manajemen penyebaran perangkat.

Penyebaran akan menerapkan pembaruan kompatibel yang diinginkan terhadap grup perangkat target yang mendistribusikan pembaruan di seluruh kelas perangkat dalam grup. Kebijakan pembatalan yang dimulai cloud dapat dikonfigurasi secara opsional.

Perintah

Nama Deskripsi Jenis Status
az iot du device deployment cancel

Batalkan penyebaran subgrup kelas perangkat.

 Ekstensi GA
az iot du device deployment create

Buat penyebaran untuk grup perangkat. Penyebaran akan multi-cast terhadap setiap subgrup kelas perangkat dalam grup target.

 Ekstensi GA
az iot du device deployment delete

Menghapus penyebaran menurut grup perangkat atau subgrup kelas perangkat.

 Ekstensi GA
az iot du device deployment list

Mencantumkan penyebaran untuk grup perangkat atau subgrup kelas perangkat.

 Ekstensi GA
az iot du device deployment list-devices

Mencantumkan perangkat dalam penyebaran subgrup kelas perangkat bersama dengan statusnya. Berguna untuk mendapatkan daftar perangkat yang gagal.

 Ekstensi GA
az iot du device deployment retry

Coba lagi penyebaran subgrup kelas perangkat.

 Ekstensi GA
az iot du device deployment show

Tampilkan penyebaran untuk grup perangkat atau subgrup kelas perangkat termasuk status yang merinci perincian berapa banyak perangkat dalam penyebaran yang sedang berlangsung, selesai, atau gagal.

 Ekstensi GA

az iot du device deployment cancel

Batalkan penyebaran subgrup kelas perangkat.

az iot du device deployment cancel --account
                                   --cid
                                   --deployment-id
                                   --gid
                                   --instance
                                   [--resource-group]

Contoh

Batalkan penyebaran subgrup kelas perangkat target.

az iot du device deployment cancel -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_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.

--deployment-id --did

Id penyebaran yang disediakan penelepon. Ini tidak boleh lebih panjang dari 73 karakter, harus semua huruf kecil, dan tidak boleh berisi '&', '^', '[', ']', '{', '}', '|', '<', '>', garis miring, garis miring terbalik, atau kutipan ganda.

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

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 deployment create

Buat penyebaran untuk grup perangkat. Penyebaran akan multi-cast terhadap setiap subgrup kelas perangkat dalam grup target.

az iot du device deployment create --account
                                   --deployment-id
                                   --gid
                                   --instance
                                   --un
                                   --up
                                   --update-version
                                   [--failed-count]
                                   [--failed-percentage]
                                   [--rbun]
                                   [--rbup]
                                   [--rbuv]
                                   [--resource-group]
                                   [--start-time]

Contoh

Buat penyebaran grup perangkat yang dijadwalkan untuk segera dimulai (sehubungan dengan waktu UTC).

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version}

Buat penyebaran grup perangkat yang dijadwalkan untuk dimulai pada tanggalwaktu yang sesuai dengan iso-8601 yang diinginkan.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --start-time "2022-12-20T01:00:00"

Buat penyebaran grup perangkat yang dijadwalkan untuk segera dimulai dengan kebijakan putar kembali yang dimulai cloud yang ditentukan. Pembatalan cloud dimulai ketika jumlah yang gagal atau target persentase yang gagal terpenuhi.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --failed-count 10 --failed-percentage 5 --rollback-update-name {rollback_update_name} --rollback-update-provider {rollback_update_provider} --rollback-update-version {rollback_update_version}

Parameter yang Diperlukan

--account -n

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

--deployment-id --did

Id penyebaran yang disediakan penelepon. Ini tidak boleh lebih panjang dari 73 karakter, harus semua huruf kecil, dan tidak boleh berisi '&', '^', '[', ']', '{', '}', '|', '<', '>', garis miring, garis miring terbalik, atau kutipan ganda.

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

--un --update-name

Nama pembaruan.

--up --update-provider

Penyedia pembaruan.

--update-version --uv

Versi pembaruan.

Parameter Opsional

--failed-count --fc

Bilangan bulat yang mewakili jumlah perangkat yang gagal dalam penyebaran sebelum pembatalan yang dimulai cloud terjadi. Diperlukan saat menentukan kebijakan putar kembali.

--failed-percentage --fp

Bilangan bulat yang mewakili persentase perangkat yang gagal dalam penyebaran sebelum pembatalan yang dimulai cloud terjadi. Diperlukan saat menentukan kebijakan putar kembali.

--rbun --rollback-update-name

Nama pembaruan putar kembali.

--rbup --rollback-update-provider

Penyedia pembaruan putar kembali.

--rbuv --rollback-update-version

Versi pembaruan putar kembali.

--resource-group -g

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

--start-time

Waktu mulai yang sesuai iso-8601 untuk penyebaran. Jika tidak ada nilai yang diberikan nilai yang sesuai untuk UTC 'sekarang' akan digunakan.

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 deployment delete

Menghapus penyebaran menurut grup perangkat atau subgrup kelas perangkat.

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

Contoh

Hapus penyebaran grup perangkat target.

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

Hapus penyebaran subgrup kelas perangkat target.

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

Parameter yang Diperlukan

--account -n

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

--deployment-id --did

Id penyebaran yang disediakan penelepon. Ini tidak boleh lebih panjang dari 73 karakter, harus semua huruf kecil, dan tidak boleh berisi '&', '^', '[', ']', '{', '}', '|', '<', '>', garis miring, garis miring terbalik, atau kutipan ganda.

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

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

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

Mencantumkan penyebaran untuk grup perangkat atau subgrup kelas perangkat.

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

Contoh

Mencantumkan penyebaran untuk grup perangkat.

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

Mencantumkan penyebaran untuk grup perangkat yang mengurutkan hasil dengan startDateTime turun.

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --order-by "startDateTime desc"

Mencantumkan penyebaran untuk subgrup kelas perangkat.

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

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

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

--order-by

Memerintahkan set penyebaran yang dikembalikan. Anda dapat memesan dengan startDateTime [desc/asc].

--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 deployment list-devices

Mencantumkan perangkat dalam penyebaran subgrup kelas perangkat bersama dengan statusnya. Berguna untuk mendapatkan daftar perangkat yang gagal.

az iot du device deployment list-devices --account
                                         --cid
                                         --deployment-id
                                         --gid
                                         --instance
                                         [--filter]
                                         [--resource-group]

Contoh

Mencantumkan perangkat dalam penyebaran subgrup kelas perangkat.

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

Mencantumkan perangkat dalam pemfilteran penyebaran subgrup kelas perangkat menurut deviceId dan deviceState.

az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --filter "deviceId eq 'd0' and deviceState eq 'InProgress'"

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.

--deployment-id --did

Id penyebaran yang disediakan penelepon. Ini tidak boleh lebih panjang dari 73 karakter, harus semua huruf kecil, dan tidak boleh berisi '&', '^', '[', ']', '{', '}', '|', '<', '>', garis miring, garis miring terbalik, atau kutipan ganda.

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

--filter

Membatasi kumpulan status perangkat penyebaran yang dikembalikan. Anda dapat memfilter deviceId dan moduleId dan/atau deviceState.

--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 deployment retry

Coba lagi penyebaran subgrup kelas perangkat.

az iot du device deployment retry --account
                                  --cid
                                  --deployment-id
                                  --gid
                                  --instance
                                  [--resource-group]

Contoh

Coba lagi penyebaran subgrup kelas perangkat target.

az iot du device deployment retry -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_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.

--deployment-id --did

Id penyebaran yang disediakan penelepon. Ini tidak boleh lebih panjang dari 73 karakter, harus semua huruf kecil, dan tidak boleh berisi '&', '^', '[', ']', '{', '}', '|', '<', '>', garis miring, garis miring terbalik, atau kutipan ganda.

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

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

Tampilkan penyebaran untuk grup perangkat atau subgrup kelas perangkat termasuk status yang merinci perincian berapa banyak perangkat dalam penyebaran yang sedang berlangsung, selesai, atau gagal.

az iot du device deployment show --account
                                 --deployment-id
                                 --gid
                                 --instance
                                 [--cid]
                                 [--resource-group]
                                 [--status {false, true}]

Contoh

Menampilkan penyebaran untuk grup perangkat.

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

Menampilkan status penyebaran grup perangkat.

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

Tampilkan penyebaran untuk subgrup kelas perangkat.

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

Menampilkan status penyebaran subgrup kelas perangkat.

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

Parameter yang Diperlukan

--account -n

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

--deployment-id --did

Id penyebaran yang disediakan penelepon. Ini tidak boleh lebih panjang dari 73 karakter, harus semua huruf kecil, dan tidak boleh berisi '&', '^', '[', ']', '{', '}', '|', '<', '>', garis miring, garis miring terbalik, atau kutipan ganda.

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

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

--resource-group -g

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

--status

Mendapatkan status penyebaran termasuk perincian berapa banyak perangkat dalam penyebaran yang sedang berlangsung, selesai, atau gagal.

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.