az iot du device deployment
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ı, az iot du device deployment komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.
Cihaz dağıtım yönetimi.
Dağıtımlar, güncelleştirmeyi grup içindeki cihaz sınıflarına dağıtan hedef cihaz grubuna istenen uyumlu güncelleştirmeyi uygular. Bulut tarafından başlatılan geri alma ilkesi isteğe bağlı olarak yapılandırılabilir.
Komutlar
Name | Description | Tür | Durum |
---|---|---|---|
az iot du device deployment cancel |
Cihaz sınıfı alt grubu dağıtımlarını iptal etme. |
Dahili | GA |
az iot du device deployment create |
Bir cihaz grubu için dağıtım oluşturun. Dağıtım, hedef grup içindeki her cihaz sınıfı alt grubuna karşı çoklu yayına alınacaktır. |
Dahili | GA |
az iot du device deployment delete |
Bir dağıtımı cihaz grubuna veya cihaz sınıfı alt grubuna göre silin. |
Dahili | GA |
az iot du device deployment list |
Cihaz grubu veya cihaz sınıfı alt grubu için dağıtımları listeleme. |
Dahili | GA |
az iot du device deployment list-devices |
Cihaz sınıfı alt grubu dağıtımındaki cihazları durumlarıyla birlikte listeleyin. Başarısız cihazların listesini almak için kullanışlıdır. |
Dahili | GA |
az iot du device deployment retry |
Cihaz sınıfı alt grubu dağıtımlarını yeniden deneyin. |
Dahili | GA |
az iot du device deployment show |
Bir cihaz grubu veya cihaz sınıfı alt grubu için, dağıtımda devam eden, tamamlanan veya başarısız olan cihazların dökümünü gösteren durum da dahil olmak üzere bir dağıtımı gösterin. |
Dahili | GA |
az iot du device deployment cancel
Cihaz sınıfı alt grubu dağıtımlarını iptal etme.
az iot du device deployment cancel --account
--cid
--deployment-id
--gid
--instance
[--resource-group]
Örnekler
Hedef cihaz sınıfı alt grubu dağıtımını iptal edin.
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}
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 sınıf kimliği. Bu, IoT Hub'daki Cihaz Güncelleştirmesi PnP arabiriminde cihaz güncelleştirme aracısı tarafından bildirilen model kimliğinden ve uyumluluk özelliklerinden oluşturulur. Onaltılık kodlanmış bir SHA1 karmasıdır.
Çağıran tarafından sağlanan dağıtım kimliği. Bu 73 karakterden uzun olamaz, tümü küçük harf olmalıdır ve '&', '^', '[', ']', '{', '}', '|', '<', '', '', eğik> çizgi, ters eğik çizgi veya çift tırnak içeremez.
Cihaz grubu kimliği. Bu, bağlı IoT Hub'ının cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.
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
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 device deployment create
Bir cihaz grubu için dağıtım oluşturun. Dağıtım, hedef grup içindeki her cihaz sınıfı alt grubuna karşı çoklu yayına alınacaktır.
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]
Örnekler
Hemen başlayacak şekilde zamanlanmış bir cihaz grubu dağıtımı oluşturun (UTC saatiyle ilgili olarak).
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}
İstenen iso-8601 uyumlu tarih saatine başlamak için zamanlanmış bir cihaz grubu dağıtımı oluşturun.
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"
Tanımlı bir bulut tarafından başlatılan geri alma ilkesiyle hemen başlayacak şekilde zamanlanmış bir cihaz grubu dağıtımı oluşturun. Bulut geri alma işlemi, başarısız sayım veya başarısız yüzde hedefleri karşılandığında başlatılır.
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}
Gerekli Parametreler
Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>
varsayılan hesap adını yapılandırabilirsiniz.
Çağıran tarafından sağlanan dağıtım kimliği. Bu 73 karakterden uzun olamaz, tümü küçük harf olmalıdır ve '&', '^', '[', ']', '{', '}', '|', '<', '', '', eğik> çizgi, ters eğik çizgi veya çift tırnak içeremez.
Cihaz grubu kimliği. Bu, bağlı IoT Hub'ının cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.
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
Bulutta başlatmalı geri alma gerçekleşmeden önce dağıtımdaki başarısız cihaz sayısını gösteren tamsayı. Geri alma ilkesini tanımlarken gereklidir.
Bulutta başlatmalı geri alma gerçekleşmeden önce dağıtımdaki başarısız cihazların yüzdesini temsil eden tamsayı. Geri alma ilkesini tanımlarken gereklidir.
Geri alma güncelleştirme adı.
Geri alma güncelleştirme sağlayıcısı.
Geri alma güncelleştirme sürümü.
Cihaz Güncelleştirme hesabı kaynak grubu adı. kullanarak varsayılan grubu az config set defaults.adu_group=<name>
yapılandırabilirsiniz.
Dağıtım için iso-8601 uyumlu başlangıç zamanı. Değer sağlanmazsa UTC 'now' için karşılık gelen değer kullanılı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 device deployment delete
Bir dağıtımı cihaz grubuna veya cihaz sınıfı alt grubuna göre silin.
az iot du device deployment delete --account
--deployment-id
--gid
--instance
[--cid]
[--resource-group]
[--yes {false, true}]
Örnekler
Hedef cihaz grubu dağıtımını silin.
az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id}
Hedef cihaz sınıfı alt grubu dağıtımını silin.
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}
Gerekli Parametreler
Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>
varsayılan hesap adını yapılandırabilirsiniz.
Çağıran tarafından sağlanan dağıtım kimliği. Bu 73 karakterden uzun olamaz, tümü küçük harf olmalıdır ve '&', '^', '[', ']', '{', '}', '|', '<', '', '', eğik> çizgi, ters eğik çizgi veya çift tırnak içeremez.
Cihaz grubu kimliği. Bu, bağlı IoT Hub'ının cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.
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
Cihaz sınıf kimliği. Bu, IoT Hub'daki Cihaz Güncelleştirmesi PnP arabiriminde cihaz güncelleştirme aracısı tarafından bildirilen model kimliğinden ve uyumluluk özelliklerinden oluşturulur. Onaltılık kodlanmış bir SHA1 karmasıdır.
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 device deployment list
Cihaz grubu veya cihaz sınıfı alt grubu için dağıtımları listeleme.
az iot du device deployment list --account
--gid
--instance
[--cid]
[--order-by]
[--resource-group]
Örnekler
Cihaz grubu için dağıtımları listeleme.
az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id}
Cihaz grubu sıralama sonuçlarının dağıtımlarını startDateTime azalan düzende listeleyin.
az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --order-by "startDateTime desc"
Cihaz sınıfı alt grubu için dağıtımları listeleme.
az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id}
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 grubu kimliği. Bu, bağlı IoT Hub'ının cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.
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
Cihaz sınıf kimliği. Bu, IoT Hub'daki Cihaz Güncelleştirmesi PnP arabiriminde cihaz güncelleştirme aracısı tarafından bildirilen model kimliğinden ve uyumluluk özelliklerinden oluşturulur. Onaltılık kodlanmış bir SHA1 karmasıdır.
Döndürülen dağıtım kümesini sipariş eder. startDateTime [desc/asc] ile sipariş vekleyebilirsiniz.
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 device deployment list-devices
Cihaz sınıfı alt grubu dağıtımındaki cihazları durumlarıyla birlikte listeleyin. Başarısız cihazların listesini almak için kullanışlıdır.
az iot du device deployment list-devices --account
--cid
--deployment-id
--gid
--instance
[--filter]
[--resource-group]
Örnekler
Cihaz sınıfı alt grubu dağıtımındaki cihazları listeleme.
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}
Cihaz sınıfı alt grubu dağıtımındaki cihazları deviceId ve deviceState'e göre filtreleyerek listeleyin.
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'"
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 sınıf kimliği. Bu, IoT Hub'daki Cihaz Güncelleştirmesi PnP arabiriminde cihaz güncelleştirme aracısı tarafından bildirilen model kimliğinden ve uyumluluk özelliklerinden oluşturulur. Onaltılık kodlanmış bir SHA1 karmasıdır.
Çağıran tarafından sağlanan dağıtım kimliği. Bu 73 karakterden uzun olamaz, tümü küçük harf olmalıdır ve '&', '^', '[', ']', '{', '}', '|', '<', '', '', eğik> çizgi, ters eğik çizgi veya çift tırnak içeremez.
Cihaz grubu kimliği. Bu, bağlı IoT Hub'ının cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.
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
Döndürülen dağıtım cihazı durumları kümesini kısıtlar. deviceId ve moduleId ve/veya deviceState üzerinde filtreleyebilirsiniz.
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 device deployment retry
Cihaz sınıfı alt grubu dağıtımlarını yeniden deneyin.
az iot du device deployment retry --account
--cid
--deployment-id
--gid
--instance
[--resource-group]
Örnekler
Hedef cihaz sınıfı alt grubu dağıtımını yeniden deneyin.
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}
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 sınıf kimliği. Bu, IoT Hub'daki Cihaz Güncelleştirmesi PnP arabiriminde cihaz güncelleştirme aracısı tarafından bildirilen model kimliğinden ve uyumluluk özelliklerinden oluşturulur. Onaltılık kodlanmış bir SHA1 karmasıdır.
Çağıran tarafından sağlanan dağıtım kimliği. Bu 73 karakterden uzun olamaz, tümü küçük harf olmalıdır ve '&', '^', '[', ']', '{', '}', '|', '<', '', '', eğik> çizgi, ters eğik çizgi veya çift tırnak içeremez.
Cihaz grubu kimliği. Bu, bağlı IoT Hub'ının cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.
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
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 device deployment show
Bir cihaz grubu veya cihaz sınıfı alt grubu için, dağıtımda devam eden, tamamlanan veya başarısız olan cihazların dökümünü gösteren durum da dahil olmak üzere bir dağıtımı gösterin.
az iot du device deployment show --account
--deployment-id
--gid
--instance
[--cid]
[--resource-group]
[--status {false, true}]
Örnekler
Bir cihaz grubu için dağıtımı gösterme.
az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id}
Cihaz grubu dağıtımının durumunu gösterir.
az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --status
Cihaz sınıfı alt grubu için dağıtımı gösterme.
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}
Cihaz sınıfı alt grubu dağıtımının durumunu gösterin.
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
Gerekli Parametreler
Cihaz Güncelleştirme hesabı adı. kullanarak az config set defaults.adu_account=<name>
varsayılan hesap adını yapılandırabilirsiniz.
Çağıran tarafından sağlanan dağıtım kimliği. Bu 73 karakterden uzun olamaz, tümü küçük harf olmalıdır ve '&', '^', '[', ']', '{', '}', '|', '<', '', '', eğik> çizgi, ters eğik çizgi veya çift tırnak içeremez.
Cihaz grubu kimliği. Bu, bağlı IoT Hub'ının cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.
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
Cihaz sınıf kimliği. Bu, IoT Hub'daki Cihaz Güncelleştirmesi PnP arabiriminde cihaz güncelleştirme aracısı tarafından bildirilen model kimliğinden ve uyumluluk özelliklerinden oluşturulur. Onaltılık kodlanmış bir SHA1 karmasıdır.
Cihaz Güncelleştirme hesabı kaynak grubu adı. kullanarak varsayılan grubu az config set defaults.adu_group=<name>
yapılandırabilirsiniz.
Dağıtımda devam eden, tamamlanan veya başarısız olan cihazların dökümü de dahil olmak üzere bir dağıtımın durumunu alı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.