az iot du device group

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 group komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

Cihaz grubu yönetimi.

Cihaz grubu, bir cihaz koleksiyonudur. Cihaz grupları, dağıtımları birçok cihaza ölçeklendirmek için bir yol sağlar. Her cihaz aynı anda tam olarak bir cihaz grubuna aittir. Cihaz Güncelleştirmesi özellikli bir cihaz hub'a bağlandığında ve özelliklerini bildirdiğinde bir cihaz grubu otomatik olarak oluşturulur.

Komutlar

Name Description Tür Durum
az iot du device group delete

Cihaz grubunu silin.

Extension GA
az iot du device group list

Örnek içindeki cihaz gruplarını listeleme.

Extension GA
az iot du device group show

En iyi güncelleştirme ve güncelleştirme uyumluluğu dahil olmak üzere bir cihaz grubuyla ilgili ayrıntıları gösterin.

Extension GA

az iot du device group delete

Cihaz grubunu silin.

Cihaz grupları otomatik olarak temizlenmez, ancak geçmiş amacıyla korunur. Bu işlem, gruba gerek yoksa veya grubun geçmişini tutması gerekiyorsa kullanılabilir. Grup silindikten sonra bir cihaz bir grup için yeniden bağlanırsa, geçmiş olmadan otomatik olarak yeniden oluşturulur.

az iot du device group delete --account
                              --gid --group-id
                              --instance
                              [--acquire-policy-token]
                              [--change-reference]
                              [--resource-group]
                              [--yes {false, true}]

Örnekler

Cihaz grubunu silin.

az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id}

Onay istemini atlayan bir cihaz grubunu silin.

az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id} -y

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.

--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
--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 group list

Örnek içindeki cihaz gruplarını listeleme.

az iot du device group list --account
                            --instance
                            [--order-by]
                            [--resource-group]

Örnekler

Cihaz gruplarını listeleyin.

az iot du device group list -n {account_name} -i {instance_name}

Cihaz gruplarını istenen sırada listeleyin; bu örnekte deviceCount.

az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCount

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

--order-by

Döndürülen grup kümesini sıralar. groupId, deviceCount, createdDateTime, subgroupsWithNewUpdatesAvailableCount, subgroupsWithUpdatesInProgressCount veya subgroupsWithOnLatestUpdateCount ölçütüne göre sıralayabilirsiniz.

--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 group show

En iyi güncelleştirme ve güncelleştirme uyumluluğu dahil olmak üzere bir cihaz grubuyla ilgili ayrıntıları gösterin.

az iot du device group show --account
                            --gid --group-id
                            --instance
                            [--best-updates {false, true}]
                            [--resource-group]
                            [--update-compliance {false, true}]

Örnekler

Cihaz grubunu gösterme.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id}

Bir cihaz grubu için kullanılabilen en iyi güncelleştirmeleri gösterin. Bu bayrak, komutu liste döndürecek şekilde değiştirir.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --best-updates

Cihaz grubu için güncelleştirme uyumluluğunu gösterme.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --update-compliance

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.

--best-updates

Komutun cihaz grubu için kullanılabilir en iyi güncelleştirmeleri getirmesi gerektiğini belirten bayrak, her güncelleştirmeye kaç cihaz gerektiğinin sayısı da dahil olmak üzere. En iyi güncelleştirme, bir cihaz sınıfının tüm uyumluluk belirtimlerini karşılayan en son güncelleştirmedir.

Özellik Değer
Parametre grubu: Update Arguments
Kabul edilen değerler: false, true
--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
--update-compliance

Komutu gösteren bayrak, en son güncelleştirmesinde kaç cihazın olduğu, kaç yeni güncelleştirmeye ihtiyaç duyulduğunu ve yeni güncelleştirme alma işleminin devam ettiğini gösteren cihaz grubu güncelleştirme uyumluluk bilgilerini getirmelidir.

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