az iot du device deployment

Note

Bu başvuru, Azure CLI (sürüm 2.70.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.

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

Extension GA
az iot du device deployment delete

Bir dağıtımı cihaz grubuna veya cihaz sınıfı alt grubuna göre silin.

Extension GA
az iot du device deployment list

Cihaz grubu veya cihaz sınıfı alt grubu için dağıtımları listeleme.

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

Extension GA
az iot du device deployment retry

Cihaz sınıfı alt grubu dağıtımlarını yeniden deneyin.

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

Extension 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 --class-id
                                   --deployment-id --did
                                   --gid --group-id
                                   --instance
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--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

--account -n

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
--cid --class-id

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.

--deployment-id --did

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

--gid --group-id

Cihaz grubu kimliği. Bu, bağlı IoT Hub cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.

--instance -i

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

Özellik Değer
Parametre grubu: Account Identifier Arguments

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--resource-group -g

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
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.

Özellik Değer
Default value: False
--help -h

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

--only-show-errors

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

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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.

Özellik Değer
Default value: False

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 --did
                                   --gid --group-id
                                   --instance
                                   --un --update-name
                                   --up --update-provider
                                   --update-version --uv
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--download-security {http, https}]
                                   [--failed-count --fc]
                                   [--failed-percentage --fp]
                                   [--rbun --rollback-update-name]
                                   [--rbup --rollback-update-provider]
                                   [--rbuv --rollback-update-version]
                                   [--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}

Güncelleştirme yükü indirmeleri için HTTP kullanarak bir cihaz grubu dağıtımı oluşturun (önerilmez; yalnızca uyumluluk).

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} --download-security http

Gerekli Parametreler

--account -n

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
--deployment-id --did

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

--gid --group-id

Cihaz grubu kimliği. Bu, bağlı IoT Hub cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.

--instance -i

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
--un --update-name

Güncelleştirme adı.

Özellik Değer
Parametre grubu: Update Id Arguments
--up --update-provider

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

Özellik Değer
Parametre grubu: Update Id Arguments
--update-version --uv

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

Özellik Değer
Parametre grubu: Update Id Arguments

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--download-security

Güncelleştirme yükü indirmeleri için kullanılan protokol. Varsayılan olarak https (TLS) kullanılır. Http'yi yalnızca hedef ortam TLS'yi desteklemediğinde kullanın.

Özellik Değer
Kabul edilen değerler: http, https
--failed-count --fc

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.

Özellik Değer
Parametre grubu: Update Rollback Policy Arguments
--failed-percentage --fp

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.

Özellik Değer
Parametre grubu: Update Rollback Policy Arguments
--rbun --rollback-update-name

Geri alma güncelleştirme adı.

Özellik Değer
Parametre grubu: Update Rollback Policy Arguments
--rbup --rollback-update-provider

Geri alma güncelleştirme sağlayıcısı.

Özellik Değer
Parametre grubu: Update Rollback Policy Arguments
--rbuv --rollback-update-version

Geri alma güncelleştirme sürümü.

Özellik Değer
Parametre grubu: Update Rollback Policy Arguments
--resource-group -g

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
--start-time

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

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

Özellik Değer
Default value: False
--help -h

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

--only-show-errors

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

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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.

Özellik Değer
Default value: False

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 --did
                                   --gid --group-id
                                   --instance
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--cid --class-id]
                                   [--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

--account -n

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
--deployment-id --did

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

--gid --group-id

Cihaz grubu kimliği. Bu, bağlı IoT Hub cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.

--instance -i

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

Özellik Değer
Parametre grubu: Account Identifier Arguments

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--cid --class-id

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.

--resource-group -g

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
--yes -y

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

Özellik Değer
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.

Özellik Değer
Default value: False
--help -h

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

--only-show-errors

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

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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.

Özellik Değer
Default value: False

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 --group-id
                                 --instance
                                 [--cid --class-id]
                                 [--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

--account -n

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
--gid --group-id

Cihaz grubu kimliği. Bu, bağlı IoT Hub cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.

--instance -i

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

Özellik Değer
Parametre grubu: Account Identifier Arguments

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--cid --class-id

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.

--order-by

Döndürülen dağıtım kümesini sipariş eder. startDateTime [desc/asc] ile sipariş vekleyebilirsiniz.

--resource-group -g

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
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.

Özellik Değer
Default value: False
--help -h

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

--only-show-errors

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

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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.

Özellik Değer
Default value: False

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 --class-id
                                         --deployment-id --did
                                         --gid --group-id
                                         --instance
                                         [--acquire-policy-token]
                                         [--change-reference]
                                         [--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

--account -n

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
--cid --class-id

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.

--deployment-id --did

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

--gid --group-id

Cihaz grubu kimliği. Bu, bağlı IoT Hub cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.

--instance -i

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

Özellik Değer
Parametre grubu: Account Identifier Arguments

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--filter

Döndürülen dağıtım cihazı durumları kümesini kısıtlar. deviceId ve moduleId ve/veya deviceState üzerinde filtreleyebilirsiniz.

--resource-group -g

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
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.

Özellik Değer
Default value: False
--help -h

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

--only-show-errors

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

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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.

Özellik Değer
Default value: False

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 --class-id
                                  --deployment-id --did
                                  --gid --group-id
                                  --instance
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--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

--account -n

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
--cid --class-id

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.

--deployment-id --did

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

--gid --group-id

Cihaz grubu kimliği. Bu, bağlı IoT Hub cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.

--instance -i

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

Özellik Değer
Parametre grubu: Account Identifier Arguments

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--resource-group -g

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
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.

Özellik Değer
Default value: False
--help -h

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

--only-show-errors

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

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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.

Özellik Değer
Default value: False

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 --did
                                 --gid --group-id
                                 --instance
                                 [--cid --class-id]
                                 [--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

--account -n

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
--deployment-id --did

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

--gid --group-id

Cihaz grubu kimliği. Bu, bağlı IoT Hub cihaz/modül ikizindeki ADUGroup etiketinin değerinden veya etiketi olmayan cihazlar için $default oluşturulur.

--instance -i

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

Özellik Değer
Parametre grubu: Account Identifier Arguments

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--cid --class-id

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.

--resource-group -g

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

Özellik Değer
Parametre grubu: Account Identifier Arguments
--status

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.

Özellik Değer
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.

Özellik Değer
Default value: False
--help -h

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

--only-show-errors

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

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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.

Özellik Değer
Default value: False