az iot du update

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

Manajemen pembaruan Pembaruan Perangkat.

Perintah

Nama Deskripsi Jenis Status
az iot du update calculate-hash

Hitung representasi file yang di-hash base64.

 Ekstensi GA
az iot du update delete

Menghapus versi pembaruan tertentu.

 Ekstensi GA
az iot du update file

Perbarui operasi file.

 Ekstensi GA
az iot du update file list

Mencantumkan id file pembaruan sehubungan dengan pembaruan penyedia, nama, dan versi.

 Ekstensi GA
az iot du update file show

Tampilkan detail file pembaruan tertentu sehubungan dengan penyedia pembaruan, nama, dan versi.

 Ekstensi GA
az iot du update import

Impor versi pembaruan baru ke dalam instans Pembaruan Perangkat.

 Ekstensi GA
az iot du update init

Utilitas untuk inisialisasi manifes impor.

 Ekstensi Pratinjau
az iot du update init v5

Menginisialisasi manifes impor v5 dengan status yang diinginkan.

 Ekstensi Pratinjau
az iot du update list

Mencantumkan pembaruan yang telah diimpor ke instans Pembaruan Perangkat.

 Ekstensi GA
az iot du update show

Perlihatkan versi pembaruan tertentu.

 Ekstensi GA
az iot du update stage

Tahapkan pembaruan untuk impor ke instans target.

 Ekstensi Pratinjau

az iot du update calculate-hash

Hitung representasi file yang di-hash base64.

az iot du update calculate-hash --file-path
                                [--hash-algo {sha256}]

Contoh

Hitung representasi base64 dari hash sha256 untuk file pembaruan target.

az iot du update calculate-hash --file-path /path/to/file

Hitung representasi base64 dari hash sha256 untuk beberapa file pembaruan target.

az iot du update calculate-hash --file-path /path/to/file1 --file-path /path/to/file2 --file-path /path/to/file3

Parameter yang Diperlukan

--file-path -f

Jalur lokal ke file target untuk perhitungan hash. --file-path dapat digunakan 1 kali atau lebih.

Parameter Opsional

--hash-algo

Algoritma kriptografi yang digunakan untuk hashing.

nilai yang diterima: sha256
nilai default: sha256
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 update delete

Menghapus versi pembaruan tertentu.

az iot du update delete --account
                        --instance
                        --un
                        --up
                        --update-version
                        [--no-wait]
                        [--resource-group]
                        [--yes {false, true}]

Contoh

Hapus pembaruan target sehubungan dengan pembaruan penyedia, nama, dan versi.

az iot du update delete -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {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>.

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

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai default: False
--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 update import

Impor versi pembaruan baru ke dalam instans Pembaruan Perangkat.

Perintah ini mendukung --defer kemampuan. Saat digunakan, perintah akan menyimpan payload objek yang dimaksudkan untuk dikirim ke Azure dalam cache lokal. Penggunaan perintah ini berikutnya tanpa --defer akan menggabungkan payload permintaan baru dengan objek cache yang mengirimkannya bersama-sama.

Setelah berhasil, entri cache lokal yang sesuai akan dibersihkan. Jika kegagalan terjadi, konten yang di-cache tidak akan dihapus. Gunakan az cache perintah untuk mengelola entri cache lokal secara independen.

Dukungan penundaan ditujukan terutama untuk pembaruan dengan beberapa langkah referensi, sehingga pembaruan induk dan anak dapat dikirimkan bersama-sama.

az iot du update import --account
                        --instance
                        --url
                        [--defer]
                        [--file]
                        [--friendly-name]
                        [--hashes]
                        [--no-wait]
                        [--resource-group]
                        [--size]

Contoh

Impor pembaruan dengan dua file terkait dan tanpa langkah referensi, secara eksplisit menyediakan nilai hash manifes dan ukuran manifes dalam byte.

az iot du update import -n {account_name} -i {instance_name} --hashes sha256={hash_value} --size {size_in_bytes} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Impor pembaruan dengan dua file terkait dan tanpa langkah referensi, memungkinkan CLI menghitung nilai hash manifes impor dan ukuran dalam byte.

az iot du update import -n {account_name} -i {instance_name} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Impor pembaruan induk dengan dua langkah referensi pembaruan anak, di mana ketiga manifes impor memiliki satu file terkait. Biarkan CLI menghitung nilai hash dan ukuran dalam byte untuk semua. Operasi ini akan mengandalkan kemampuan '--defer'.

az iot du update import -n {account_name} -i {instance_name} --url {parent_manifest_location} --file filename={parent_file_name} url={parent_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child1_manifest_location} --file filename={child1_file_name} url={child1_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child2_manifest_location} --file filename={child2_file_name} url={child2_file_url}

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

--url

Lokasi yang dapat dirutekan tempat manifes impor dapat diunduh oleh Device Update for IoT Hub. Ini biasanya URL blob yang dilindungi SAS baca-saja dengan kedaluwarsa yang diatur ke setidaknya 3 jam.

Parameter Opsional

--defer

Simpan sementara objek di cache lokal alih-alih mengirim ke Azure. Gunakan az cache perintah untuk melihat/menghapus.

--file

Pasangan kunci=nilai yang dipisahkan spasi yang sesuai dengan properti file metadata manifes impor. Kunci yang diperlukan termasuk nama file dan url. --file dapat digunakan 1 kali atau lebih.

--friendly-name

Nama yang mudah diingat yang terkait dengan definisi pembaruan.

--hashes

Pasangan key=value yang dipisahkan spasi di mana kuncinya adalah algoritma hash yang digunakan dan nilainya adalah hash file manifes impor yang dikodekan base64. Setidaknya entri sha256 diperlukan. Jika tidak disediakan, itu akan dihitung dari url yang disediakan.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai default: False
--resource-group -g

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

--size

Ukuran file dalam jumlah byte. Jika tidak disediakan, itu akan dihitung dari url yang disediakan.

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

Mencantumkan pembaruan yang telah diimpor ke instans Pembaruan Perangkat.

Saat mencantumkan penyedia pembaruan hanya bendera --by-provider yang perlu disediakan selain argumen pencarian instans umum. Saat mencantumkan nama pembaruan, penyedia pembaruan harus disediakan. Saat mencantumkan versi pembaruan, penyedia pembaruan dan nama pembaruan harus disediakan.

az iot du update list --account
                      --instance
                      [--by-provider {false, true}]
                      [--filter]
                      [--resource-group]
                      [--search]
                      [--un]
                      [--up]

Contoh

Cantumkan semua pembaruan.

az iot du update list -n {account_name} -i {instance_name}

Cantumkan semua pembaruan yang memenuhi kriteria pencarian teks bebas, dalam hal ini penyedia pembaruan Contoso.

az iot du update list -n {account_name} -i {instance_name} --search 'Contoso'

Cantumkan semua pembaruan yang memenuhi filter odata, dalam hal ini pemfilteran untuk pembaruan yang tidak dapat disebarkan.

az iot du update list -n {account_name} -i {instance_name} --filter 'isDeployable eq false'

Mencantumkan semua penyedia pembaruan.

az iot du update list -n {account_name} -i {instance_name} --by-provider

Cantumkan semua nama pembaruan menurut penyedia pembaruan.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name}

Cantumkan semua versi pembaruan menurut penyedia pembaruan dan nama pembaruan.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name}

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

--by-provider

Bendera yang menunjukkan kumpulan hasil harus dibatasi untuk memperbarui penyedia.

nilai yang diterima: false, true
--filter

Membatasi kumpulan pembaruan yang dikembalikan oleh nilai properti. Didukung saat mencantumkan pembaruan tanpa batasan atau saat mencantumkan menurut versi.

--resource-group -g

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

--search

Meminta pembaruan yang cocok dengan ekspresi pencarian teks bebas. Didukung saat mencantumkan pembaruan tanpa batasan.

--un --update-name

Nama pembaruan.

--up --update-provider

Penyedia pembaruan.

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

Perlihatkan versi pembaruan tertentu.

az iot du update show --account
                      --instance
                      --un
                      --up
                      --update-version
                      [--resource-group]

Contoh

Perlihatkan pembaruan tertentu sehubungan dengan penyedia pembaruan, nama, dan versi.

az iot du update show -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {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>.

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

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

Pratinjau

Perintah ini sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Tahapkan pembaruan untuk impor ke instans target.

Penahapan pembaruan mengacu pada percepatan langkah-langkah prasyarat mengimpor pembaruan ke instans target. Untuk manifes impor tertentu, proses akan menentukan file yang relevan, mendorongnya ke kontainer penyimpanan yang diinginkan, menghasilkan URI SAS, dan mencakup langkah-langkah persiapan lainnya untuk impor yang berhasil.

Perintah ini bergantung pada organisasi file pembaruan berbasis konvensi. Semua file pembaruan untuk manifes target diharapkan berada di direktori yang sama tempat manifes impor berada.

Akses berbasis kunci digunakan untuk mengunggah artefak blob dan untuk menghasilkan URI SAS durasi 3 jam dengan akses baca.

Jika --then-import bendera disediakan, perintah akan mengimpor pembaruan bertahap. Jika tidak, hasil dari operasi ini adalah perintah impor untuk dijalankan untuk mencapai hasil yang sama di lain waktu.

Perintah ini akan menghapus menyeluruh dan menyegarkan entri cache lokal apa pun untuk instans target.

az iot du update stage --account
                       --instance
                       --manifest-path
                       --storage-account
                       --storage-container
                       [--friendly-name]
                       [--overwrite {false, true}]
                       [--resource-group]
                       [--storage-subscription]
                       [--then-import {false, true}]

Contoh

Tahapkan pembaruan yang berdiri sendiri. File pembaruan diharapkan berada di direktori yang sama dengan manifes. Perintah impor yang dihasilkan dapat dijalankan di lain waktu untuk memulai impor pembaruan bertahap sebelum kedaluwarsa token SAS.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json

Tahapkan pembaruan yang berdiri sendiri. Setelah penahapan, impor pembaruan ke instans menggunakan nama ramah yang diinginkan.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json --then-import --friendly-name myAptUpdate

Tahapkan pembaruan multi-referensi. File pembaruan akan diunggah ke kontainer blob penyimpanan yang berada di langganan yang berbeda ke akun pembaruan.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --storage-subscription {storage_account_subscription} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json

Tahapkan pembaruan multi-referensi, timpa blob yang ada jika ada. Setelah penahapan, impor pembaruan ke instans.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json --then-import --overwrite

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

--manifest-path

Jalur file lokal ke manifes impor yang harus dipentaskan. Dapat digunakan 1 kali atau lebih.

--storage-account

Nama akun penyimpanan yang diinginkan untuk menggeser artefak manifes impor.

--storage-container

Nama kontainer penyimpanan yang diinginkan untuk menggeser artefak manifes impor.

Parameter Opsional

--friendly-name

Nama yang mudah diingat yang terkait dengan definisi pembaruan.

--overwrite

Bendera yang menunjukkan apakah blob yang ada harus ditimpa jika ada konflik.

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

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

--storage-subscription

Langganan akun penyimpanan yang diinginkan untuk menggeser artefak manifes impor. Berlaku saat akun penyimpanan dan pembaruan perangkat berada dalam langganan yang berbeda.

--then-import

Bendera yang menunjukkan apakah pembaruan harus diimpor setelah penahapan.

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.