az iot du update init

  • Pratinjau
  • 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 init . Pelajari lebih lanjut tentang ekstensi.

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

Utilitas untuk inisialisasi manifes impor.

Perintah

Nama Deskripsi Jenis Status
az iot du update init v5

Menginisialisasi manifes impor v5 dengan status yang diinginkan.

 Ekstensi Pratinjau

az iot du update init v5

Pratinjau

Grup perintah 'iot du update init' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Menginisialisasi manifes impor v5 dengan status yang diinginkan.

Perintah ini mendukung semua atribut manifes impor v5. Perhatikan bahwa ada sensitivitas posisi antara --step dan --file, serta --file dan --related-file. Tinjau contoh dan deskripsi parameter untuk detail tentang cara sepenuhnya menggunakan operasi.

Baca selengkapnya tentang menggunakan tanda kutip dan karakter escape di shell yang berbeda di sini: https://aka.ms/aziotcli-json.

az iot du update init v5 --compat
                         --step
                         --update-name
                         --update-provider
                         --update-version
                         [--description]
                         [--file]
                         [--is-deployable {false, true}]
                         [--no-validation {false, true}]
                         [--related-file]

Contoh

Menginisialisasi manifes impor konten minimum. Json sebaris dioptimalkan untuk 'bash'.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{"installedCriteria": "1.0"}' --file path=/my/apt/manifest/file

Menginisialisasi manifes impor konten minimum. Json sebaris dioptimalkan untuk 'powershell'.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{\"installedCriteria\": \"1.0\"}' --file path=/my/apt/manifest/file

Menginisialisasi manifes impor konten minimum. Json sebaris dioptimalkan untuk 'cmd'.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="{\"installedCriteria\": \"1.0\"}" --file path=/my/apt/manifest/file

Menginisialisasi manifes impor konten minimum. Gunakan input file untuk json.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="@/path/to/file" --file path=/my/apt/manifest/file

Menginisialisasi pembaruan daun yang tidak dapat disebarkan untuk dirujuk dalam pembaruan yang dibundel. Json sebaris dioptimalkan untuk 'bash'.

az iot du update init v5 --update-provider Microsoft --update-name mySwUpdate --update-version 1.1.0 --compat manufacturer=Contoso model=Microphone --step handler=microsoft/swupdate:1 description="Deploy Update" properties='{"installedCriteria": "1.0"}' --file path=/my/update/image/file1 --file path=/my/update/image/file2 --is-deployable false

Inisialisasi pembaruan yang dibundel yang merujuk pada pembaruan daun serta menentukan langkah-langkah independen. Contoh yang dioptimalkan untuk 'bash' menggunakan kelanjutan perintah untuk menguraikan segmen manifes impor.

az iot du update init v5 \
--update-provider Microsoft --update-name myBundled --update-version 2.0 \
--compat manufacturer=Contoso model=SpaceStation \
--step handler=microsoft/script:1 properties='{"arguments": "--pre"}' description="Pre-install script" \
--file path=/my/update/scripts/preinstall.sh downloadHandler=microsoft/delta:1 \
--related-file path=/my/update/scripts/related_preinstall.json properties='{"microsoft.sourceFileHashAlgorithm": "sha256"}' \
--step updateId.provider=Microsoft updateId.name=SwUpdate updateId.version=1.1 \
--step handler=microsoft/script:1 properties='{"arguments": "--post"}' description="Post-install script" \
--file path=/my/update/scripts/postinstall.sh

Parameter yang Diperlukan

--compat

Pasangan kunci=nilai yang dipisahkan spasi yang sesuai dengan properti perangkat yang kompatibel dengan pembaruan ini. Biasanya digunakan untuk menentukan properti seperti produsen dan model. --compat dapat digunakan 1 kali atau lebih.

--step

Pasangan kunci=nilai yang dipisahkan spasi yang sesuai dengan properti elemen 'instructions.steps'. Klien akan menentukan apakah langkah adalah langkah sebaris atau referensi berdasarkan pasangan nilai kunci yang disediakan. Jika langkah sebaris atau referensi dapat dipenuhi, langkah referensi akan diprioritaskan. Penggunaan --file akan dikaitkan dengan entri --step sebaris terdekat, yang mengambil nilai untuk 'file'. Kunci langkah referensi berikut didukung: updateId.provider, , updateId.nameupdateId.version dan description. Kunci langkah sebaris berikut didukung: handler (misalnya: 'microsoft/script:1' atau 'microsoft/swupdate:1' atau 'microsoft/apt:1'), properties (objek json dalam baris agen akan diteruskan ke handler), dan description. --step dapat digunakan 1 kali atau lebih.

--update-name

Nama pembaruan sebagai komponen updateId.

--update-provider

Penyedia pembaruan sebagai komponen updateId.

--update-version

Versi pembaruan sebagai komponen updateId.

Parameter Opsional

--description

Deskripsi untuk manifes impor.

--file

Pasangan kunci=nilai yang dipisahkan spasi yang sesuai dengan properti elemen 'file'. Entri --file dapat menyertakan entri --related-file terdekat jika disediakan. Kunci berikut didukung: path [diperlukan] jalur file lokal untuk memperbarui file, downloadHandler (misalnya: 'microsoft/delta:1') handler untuk menggunakan file terkait untuk mengunduh file payload, properties (objek json in-line yang akan diteruskan agen ke handler). --file dapat digunakan 1 kali atau lebih.

--is-deployable

Menunjukkan apakah pembaruan dapat disebarkan secara independen.

nilai yang diterima: false, true
--no-validation

Menonaktifkan validasi skema json sisi klien dari konten manifes impor.

nilai yang diterima: false, true
--related-file

Pasangan kunci=nilai yang dipisahkan spasi yang sesuai dengan properti elemen 'files[*].relatedFiles'. Entri --related-file akan dikaitkan dengan entri --file terdekat jika ada. Kunci berikut didukung: path [wajib] jalur file lokal ke file pembaruan terkait, properties (objek json in-line diteruskan ke handler unduhan). --related-file dapat digunakan 1 kali atau lebih.

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.