az iot du update

  • Başvuru

Dekont

Bu başvuru, Azure CLI (sürüm 2.37.0 veya üzeri) için azure-iot uzantısının bir parçasıdır. Uzantı, bir az iot du update komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

Cihaz Güncelleştirmesi güncelleştirme yönetimi.

Komutlar

Name Description Tür Durum
az iot du update calculate-hash

Bir dosyanın base64 karma gösterimini hesaplama.

 Dahili GA
az iot du update delete

Belirli bir güncelleştirme sürümünü silin.

 Dahili GA
az iot du update file

Dosya işlemlerini güncelleştirin.

 Dahili GA
az iot du update file list

Güncelleştirme sağlayıcısı, adı ve sürümüyle ilgili güncelleştirme dosyası kimliklerini listeleyin.

 Dahili GA
az iot du update file show

Güncelleştirme sağlayıcısı, adı ve sürümüyle ilgili olarak belirli bir güncelleştirme dosyasının ayrıntılarını gösterin.

 Dahili GA
az iot du update import

Yeni bir güncelleştirme sürümünü Cihaz Güncelleştirmesi örneğine aktarın.

 Dahili GA
az iot du update init

İçeri aktarma bildirimi başlatma yardımcı programı.

 Dahili Önizleme
az iot du update init v5

İstenen durumla bir v5 içeri aktarma bildirimi başlatın.

 Dahili Önizleme
az iot du update list

Cihaz Güncelleştirmesi örneğine aktarılan güncelleştirmeleri listeleyin.

 Dahili GA
az iot du update show

Belirli bir güncelleştirme sürümünü gösterme.

 Dahili GA
az iot du update stage

Hedef örneğe içeri aktarma için bir güncelleştirme hazırlama.

 Dahili Önizleme

az iot du update calculate-hash

Bir dosyanın base64 karma gösterimini hesaplama.

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

Örnekler

Hedef güncelleştirme dosyası için sha256 özetinin base64 gösterimini hesaplayın.

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

Birden çok hedef güncelleştirme dosyası için sha256 özetinin base64 gösterimini hesaplayın.

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

Gerekli Parametreler

--file-path -f

Karma hesaplama için hedef dosyanın yerel yolu. --file-path 1 veya daha fazla kez kullanılabilir.

İsteğe Bağlı Parametreler

--hash-algo

Karma için kullanılacak şifreleme algoritması.

kabul edilen değerler: sha256
varsayılan değer: sha256
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot du update delete

Belirli bir güncelleştirme sürümünü silin.

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

Örnekler

Güncelleştirme sağlayıcısı, adı ve sürümüyle ilgili olarak bir hedef güncelleştirmeyi silin.

az iot du update delete -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

Gerekli Parametreler

--account -n

Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>varsayılan hesap adını yapılandırabilirsiniz.

--instance -i

Cihaz Güncelleştirme örneği adı. varsayılan örnek adını kullanarak az config set defaults.adu_instance=<name>yapılandırabilirsiniz.

--un --update-name

Güncelleştirme adı.

--up --update-provider

Güncelleştirme sağlayıcısı.

--update-version --uv

Güncelleştirme sürümü.

İsteğe Bağlı Parametreler

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin.

varsayılan değer: False
--resource-group -g

Cihaz Güncelleştirme hesabı kaynak grubu adı. kullanarak varsayılan grubu az config set defaults.adu_group=<name>yapılandırabilirsiniz.

--yes -y

Kullanıcı istemlerini atlayın. Eylemin kabul edilmesini gösterir. Öncelikle otomasyon senaryoları için kullanılır. Varsayılan: false.

kabul edilen değerler: false, true
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot du update import

Yeni bir güncelleştirme sürümünü Cihaz Güncelleştirmesi örneğine aktarın.

Bu komut özelliği destekler --defer . Kullanıldığında komutu, Azure'a gönderilmesi amaçlanan nesne yükünü yerel önbellekte depolar. Bu komutun olmadan --defer sonraki kullanımı, yeni istek yükünü önbelleğe alınmış nesnelerle birleştirerek bunları birlikte gönderir.

Başarılı olduğunda ilgili yerel önbellek girdisi temizlenir. Hata oluşursa önbelleğe alınan içerik kaldırılmaz. Yerel önbellek girdilerini bağımsız olarak yönetmek için komutları kullanın az cache .

Erteleme desteği öncelikli olarak üst ve alt güncelleştirmelerin birlikte gönderilebileceği birden çok başvuru adımına sahip güncelleştirmeler için tasarlanmıştır.

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

Örnekler

İki ilgili dosya içeren ve başvuru adımı olmayan bir güncelleştirmeyi içeri aktararak açıkça bayt cinsinden bildirim karması değeri ve bildirim boyutu sağlar.

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}

cli'nin içeri aktarma bildirimi karma değerini ve boyutunu bayt cinsinden hesaplamasına izin vererek, iki ilgili dosya içeren ve başvuru adımı olmayan bir güncelleştirmeyi içeri aktarın.

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}

İki alt güncelleştirme başvuru adımıyla üst güncelleştirmeyi içeri aktar, üç içeri aktarma bildiriminin de tek bir ilgili dosyası vardır. CLI'nın tümü için karma değeri ve boyutu bayt cinsinden hesaplamasına izin verin. Bu işlem '--defer' özelliğini kullanacaktır.

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}

Gerekli Parametreler

--account -n

Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>varsayılan hesap adını yapılandırabilirsiniz.

--instance -i

Cihaz Güncelleştirme örneği adı. varsayılan örnek adını kullanarak az config set defaults.adu_instance=<name>yapılandırabilirsiniz.

--url

ioT Hub için Cihaz Güncelleştirmesi tarafından içeri aktarma bildiriminin indirilebileceği yönlendirilebilir konum. Bu genellikle son kullanma süresi en az 3 saat olarak ayarlanmış salt okunur SAS korumalı blob URL'dir.

İsteğe Bağlı Parametreler

--defer

Nesneyi Azure'a göndermek yerine geçici olarak yerel önbellekte depolayın. Görüntülemek/temizlemek için komutları kullanın az cache .

--file

İçeri aktarma bildirimi meta veri dosyası özelliklerine karşılık gelen boşlukla ayrılmış anahtar=değer çiftleri. Gerekli anahtarlar dosya adı ve URL'yi içerir. --file 1 veya daha fazla kez kullanılabilir.

--friendly-name

Güncelleştirme tanımıyla ilişkili kolay ad.

--hashes

Anahtarın kullanılan karma algoritması ve değerin base64 kodlanmış içeri aktarma bildirim dosyası karması olduğu boşlukla ayrılmış anahtar=değer çiftleri. En azından bir sha256 girişi gereklidir. Sağlanmadıysa, sağlanan URL'den hesaplanır.

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin.

varsayılan değer: False
--resource-group -g

Cihaz Güncelleştirme hesabı kaynak grubu adı. kullanarak varsayılan grubu az config set defaults.adu_group=<name>yapılandırabilirsiniz.

--size

Bayt sayısı cinsinden dosya boyutu. Sağlanmadıysa, sağlanan URL'den hesaplanır.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot du update list

Cihaz Güncelleştirmesi örneğine aktarılan güncelleştirmeleri listeleyin.

Güncelleştirme sağlayıcılarını listelerken ortak örnek arama bağımsız değişkenlerine ek olarak yalnızca --by-provider bayrağının sağlanması gerekir. Güncelleştirme adları listelenirken güncelleştirme sağlayıcısı sağlanmalıdır. Güncelleştirme sürümleri listelenirken güncelleştirme sağlayıcısı ve güncelleştirme adı sağlanmalıdır.

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

Örnekler

Tüm güncelleştirmeleri listeleyin.

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

Contoso'nun güncelleştirme sağlayıcısı olan serbest metin arama ölçütlerini karşılayan tüm güncelleştirmeleri listeleyin.

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

Bir odata filtresini karşılayan tüm güncelleştirmeleri listeleyin; bu durumda dağıtılamayan güncelleştirmeler için filtreleme.

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

Tüm güncelleştirme sağlayıcılarını listeleyin.

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

Güncelleştirme sağlayıcısına göre tüm güncelleştirme adlarını listeleyin.

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

Tüm güncelleştirme sürümlerini güncelleştirme sağlayıcısına ve güncelleştirme adına göre listeleyin.

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

Gerekli Parametreler

--account -n

Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>varsayılan hesap adını yapılandırabilirsiniz.

--instance -i

Cihaz Güncelleştirme örneği adı. varsayılan örnek adını kullanarak az config set defaults.adu_instance=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--by-provider

Sonuç kümesini gösteren bayrak, güncelleştirme sağlayıcılarıyla kısıtlanmalıdır.

kabul edilen değerler: false, true
--filter

Özellik değerleri tarafından döndürülen güncelleştirme kümesini kısıtlar. Kısıtlama olmadan güncelleştirmeleri listelerken veya sürüme göre listelerken desteklenir.

--resource-group -g

Cihaz Güncelleştirme hesabı kaynak grubu adı. kullanarak varsayılan grubu az config set defaults.adu_group=<name>yapılandırabilirsiniz.

--search

Serbest metin arama ifadesiyle eşleşen güncelleştirmeleri iste. Kısıtlama olmadan güncelleştirmeler listelenirken desteklenir.

--un --update-name

Güncelleştirme adı.

--up --update-provider

Güncelleştirme sağlayıcısı.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot du update show

Belirli bir güncelleştirme sürümünü gösterme.

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

Örnekler

Güncelleştirme sağlayıcısı, adı ve sürümüyle ilgili olarak belirli bir güncelleştirmeyi gösterin.

az iot du update show -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

Gerekli Parametreler

--account -n

Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>varsayılan hesap adını yapılandırabilirsiniz.

--instance -i

Cihaz Güncelleştirme örneği adı. varsayılan örnek adını kullanarak az config set defaults.adu_instance=<name>yapılandırabilirsiniz.

--un --update-name

Güncelleştirme adı.

--up --update-provider

Güncelleştirme sağlayıcısı.

--update-version --uv

Güncelleştirme sürümü.

İsteğe Bağlı Parametreler

--resource-group -g

Cihaz Güncelleştirme hesabı kaynak grubu adı. kullanarak varsayılan grubu az config set defaults.adu_group=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot du update stage

Önizleme

Bu komut önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

Hedef örneğe içeri aktarma için bir güncelleştirme hazırlama.

Bir güncelleştirmeyi hazırlama, bir güncelleştirmeyi hedef örneğe aktarmanın önkoşul adımlarını hızlandırmayı ifade eder. Belirli bir içeri aktarma bildirimi için işlem ilgili dosyaları belirler, bunları istenen bir depolama kapsayıcısına aktarır, SAS URI'leri oluşturur ve başarılı bir içeri aktarma için diğer hazırlık adımlarını kapsar.

Bu komut, güncelleştirme dosyalarının kural tabanlı bir kuruluşuna bağlıdır. Hedef bildirimin tüm güncelleştirme dosyalarının içeri aktarma bildiriminin bulunduğu dizinde olması beklenir.

Anahtar tabanlı erişim, blob yapıtlarını karşıya yüklemek ve okuma erişimine sahip 3 saatlik SAS URI'leri oluşturmak için kullanılır.

Bayrak sağlanırsa --then-import , komut hazırlanmış güncelleştirmeyi içeri aktarır. Aksi takdirde, bu işlemin sonucu daha sonra aynı sonucu elde etmek için çalıştırılacak bir içeri aktarma komutudur.

Bu komut, hedef örnek için tüm yerel önbellek girdilerini temizler ve yeniler.

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

Örnekler

Tek başına güncelleştirme hazırlama. Güncelleştirme dosyalarının bildirimle aynı dizinde bulunması beklenir. Sonuçta elde edilen içeri aktarma komutu, SAS belirteci süre sonu öncesinde hazırlanan güncelleştirmenin içeri aktarılmasını başlatmak için daha sonra yürütülebilir.

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

Tek başına güncelleştirme hazırlama. Hazırlama işleminden sonra istenen kolay adı kullanarak güncelleştirmeyi örneğe aktarın.

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

Çoklu başvuru güncelleştirmesini hazırlama. Güncelleştirme dosyaları, güncelleştirme hesabına farklı bir abonelikte bulunan bir depolama blob kapsayıcısına yüklenir.

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

Çok başvurulu bir güncelleştirme hazırlama ve varsa mevcut blobların üzerine yazma. Hazırlama işleminden sonra güncelleştirmeyi örneğe aktarın.

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

Gerekli Parametreler

--account -n

Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>varsayılan hesap adını yapılandırabilirsiniz.

--instance -i

Cihaz Güncelleştirme örneği adı. varsayılan örnek adını kullanarak az config set defaults.adu_instance=<name>yapılandırabilirsiniz.

--manifest-path

Hazırlaması gereken içeri aktarma bildiriminin yerel dosya yolu. 1 veya daha fazla kez kullanılabilir.

--storage-account

İçeri aktarma bildirimi yapıtlarını hazırlamak için istenen depolama hesabı adı.

--storage-container

İçeri aktarma bildirimi yapıtlarını hazırlamak için istenen depolama kapsayıcısı adı.

İsteğe Bağlı Parametreler

--friendly-name

Güncelleştirme tanımıyla ilişkili kolay ad.

--overwrite

Bir çakışma varsa var olan blobların üzerine yazıp yazılmayacağını gösteren bayrak.

kabul edilen değerler: false, true
varsayılan değer: False
--resource-group -g

Cihaz Güncelleştirme hesabı kaynak grubu adı. kullanarak varsayılan grubu az config set defaults.adu_group=<name>yapılandırabilirsiniz.

--storage-subscription

İçeri aktarma bildirimi yapıtlarını hazırlamak için istenen depolama hesabı aboneliği. Depolama ve cihaz güncelleştirme hesapları farklı aboneliklerde olduğunda geçerlidir.

--then-import

Hazırlama işleminden sonra güncelleştirmenin içeri aktarılıp aktarılmayacağını gösteren bayrak.

kabul edilen değerler: false, true
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.