az iot du update
Not
Bu başvuru, Azure CLI (sürüm 2.46.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 | Önizle |
az iot du update init v5 |
İstenen durumla bir v5 içeri aktarma bildirimi başlatın. |
Dahili | Önizle |
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 | Önizle |
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
Karma hesaplama için hedef dosyanın yerel yolu. --file-path 1 veya daha fazla kez kullanılabilir.
İsteğe Bağlı Parametreler
Karma için kullanılacak şifreleme algoritması.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
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
Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>
varsayılan hesap adını yapılandırabilirsiniz.
Cihaz Güncelleştirme örneği adı. varsayılan örnek adını kullanarak az config set defaults.adu_instance=<name>
yapılandırabilirsiniz.
Güncelleştirme adı.
Güncelleştirme sağlayıcısı.
Güncelleştirme sürümü.
İsteğe Bağlı Parametreler
Uzun süre çalışan işlemin bitmesini beklemeyin.
Cihaz Güncelleştirme hesabı kaynak grubu adı. kullanarak varsayılan grubu az config set defaults.adu_group=<name>
yapılandırabilirsiniz.
Kullanıcı istemlerini atlayın. Eylemin kabul edilmesini gösterir. Öncelikle otomasyon senaryoları için kullanılır. Varsayılan: false.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
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
Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>
varsayılan hesap adını yapılandırabilirsiniz.
Cihaz Güncelleştirme örneği adı. varsayılan örnek adını kullanarak az config set defaults.adu_instance=<name>
yapılandırabilirsiniz.
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
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
.
İç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.
Güncelleştirme tanımıyla ilişkili kolay ad.
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.
Uzun süre çalışan işlemin bitmesini beklemeyin.
Cihaz Güncelleştirme hesabı kaynak grubu adı. kullanarak varsayılan grubu az config set defaults.adu_group=<name>
yapılandırabilirsiniz.
Bayt sayısı cinsinden dosya boyutu. Sağlanmadıysa, sağlanan URL'den hesaplanır.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
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
Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>
varsayılan hesap adını yapılandırabilirsiniz.
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
Sonuç kümesini gösteren bayrak, güncelleştirme sağlayıcılarıyla kısıtlanmalıdır.
Ö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.
Cihaz Güncelleştirme hesabı kaynak grubu adı. kullanarak varsayılan grubu az config set defaults.adu_group=<name>
yapılandırabilirsiniz.
Serbest metin arama ifadesiyle eşleşen güncelleştirmeleri iste. Kısıtlama olmadan güncelleştirmeler listelenirken desteklenir.
Güncelleştirme adı.
Güncelleştirme sağlayıcısı.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
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
Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>
varsayılan hesap adını yapılandırabilirsiniz.
Cihaz Güncelleştirme örneği adı. varsayılan örnek adını kullanarak az config set defaults.adu_instance=<name>
yapılandırabilirsiniz.
Güncelleştirme adı.
Güncelleştirme sağlayıcısı.
Güncelleştirme sürümü.
İsteğe Bağlı Parametreler
Cihaz Güncelleştirme hesabı kaynak grubu adı. kullanarak varsayılan grubu az config set defaults.adu_group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
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
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
Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>
varsayılan hesap adını yapılandırabilirsiniz.
Cihaz Güncelleştirme örneği adı. varsayılan örnek adını kullanarak az config set defaults.adu_instance=<name>
yapılandırabilirsiniz.
Hazırlaması gereken içeri aktarma bildiriminin yerel dosya yolu. 1 veya daha fazla kez kullanılabilir.
İçeri aktarma bildirimi yapıtlarını hazırlamak için istenen depolama hesabı adı.
İçeri aktarma bildirimi yapıtlarını hazırlamak için istenen depolama kapsayıcısı adı.
İsteğe Bağlı Parametreler
Güncelleştirme tanımıyla ilişkili kolay ad.
Bir çakışma varsa var olan blobların üzerine yazıp yazılmayacağını gösteren bayrak.
Cihaz Güncelleştirme hesabı kaynak grubu adı. kullanarak varsayılan grubu az config set defaults.adu_group=<name>
yapılandırabilirsiniz.
İç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.
Hazırlama işleminden sonra güncelleştirmenin içeri aktarılıp aktarılmayacağını gösteren bayrak.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.