az iot hub device-identity

Başvuru

Not

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

IoT cihazlarını yönetme.

Komutlar

az iot hub device-identity children	IoT edge cihazları için alt cihaz ilişkilerini yönetme.
az iot hub device-identity children add	Cihazları hedef uç cihazına alt öğe olarak ekleyin.
az iot hub device-identity children list	Atanan alt cihazların koleksiyonunu verir.
az iot hub device-identity children remove	Alt cihazları hedef uç cihazından kaldırın.
az iot hub device-identity connection-string	IoT cihazının bağlantı dizesini yönetin.
az iot hub device-identity connection-string show	Belirli bir IoT Hub cihaz bağlantı dizesini gösterin.
az iot hub device-identity create	IoT Hub bir cihaz oluşturun.
az iot hub device-identity delete	bir IoT Hub cihazı silin.
az iot hub device-identity export	Tüm cihaz kimliklerini bir IoT Hub Azure Depolama blob kapsayıcısına aktarın. Satır içi blob kapsayıcıSı SAS uri girişi için lütfen ortamınızın giriş kurallarını gözden geçirin.
az iot hub device-identity import	Cihaz kimliklerini blobdan bir IoT Hub aktarabilirsiniz. Satır içi blob kapsayıcıSı SAS uri girişi için lütfen ortamınızın giriş kurallarını gözden geçirin.
az iot hub device-identity list	Cihazları bir IoT Hub listeleyin.
az iot hub device-identity parent	IoT cihazları için üst cihaz ilişkilerini yönetme.
az iot hub device-identity parent set	Hedef cihazın üst cihazını ayarlayın.
az iot hub device-identity parent show	Hedef cihazın üst cihazını alın.
az iot hub device-identity renew-key	Sas kimlik doğrulaması ile bir IoT Hub cihazının hedef anahtarlarını yenileyin.
az iot hub device-identity show	bir IoT Hub cihazının ayrıntılarını alın.
az iot hub device-identity update	bir IoT Hub cihazını güncelleştirin.

az iot hub device-identity create

IoT Hub bir cihaz oluşturun.

shared_private_key kimlik doğrulama yöntemini (simetrik anahtarlar olarak da bilinir) kullanırken, özel anahtar sağlanmazsa hizmet bunları cihaz için oluşturur.

Uç cihaz için bir cihaz kapsamı sağlanırsa, değer otomatik olarak üst kapsama dönüştürülür.

az iot hub device-identity create --device-id
                                  [--am {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--device-scope]
                                  [--edge-enabled {false, true}]
                                  [--hub-name]
                                  [--login]
                                  [--od]
                                  [--pk]
                                  [--primary-thumbprint]
                                  [--resource-group]
                                  [--secondary-key]
                                  [--secondary-thumbprint]
                                  [--sta {disabled, enabled}]
                                  [--star]
                                  [--valid-days]

Örnekler

Varsayılan yetkilendirmeye (paylaşılan özel anahtar) sahip uç özellikli bir IoT cihazı oluşturun.

az iot hub device-identity create -n {iothub_name} -d {device_id} --ee

Otomatik olarak imzalanan sertifika yetkilendirmesine sahip bir IoT cihazı oluşturun, 10 gün boyunca geçerli bir sertifika oluşturun ve parmak izini kullanın.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --valid-days 10

Otomatik olarak imzalanan sertifika yetkilendirmesine sahip bir IoT cihazı oluşturun, varsayılan süre sonu sertifikası (365 gün) oluşturun ve hedef dizine çıkış yapın.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --output-dir /path/to/output

Otomatik olarak imzalanan sertifika yetkilendirmesi ile bir IoT cihazı oluşturun ve açıkça birincil ve ikincil parmak izleri sağlayın.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --ptp {thumbprint_1} --stp {thumbprint_2}

Kök CA yetkilendirmesi devre dışı durumu ve nedeni olan bir IoT cihazı oluşturun.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_ca --status disabled --status-reason 'for reasons'

Cihaz kapsamına sahip bir IoT cihazı oluşturun.

az iot hub device-identity create -n {iothub_name} -d {device_id} --device-scope 'ms-azure-iot-edge://edge0-123456789123456789'

Gerekli Parametreler

--device-id -d

Hedef Cihaz.

İsteğe Bağlı Parametreler

--am --auth-method

Varlığın oluşturulacağı yetkilendirme yöntemi.

kabul edilen değerler: shared_private_key, x509_ca, x509_thumbprint

varsayılan değer: shared_private_key

--auth-type

İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

kabul edilen değerler: key, login

varsayılan değer: key

--device-scope

Cihazın kapsamı. Uç cihazlar için bu otomatik olarak oluşturulur ve sabittir. Yaprak cihazlar için bunu alt/üst ilişki oluşturacak şekilde ayarlayın.

--edge-enabled --ee

Kenar etkinleştirmeyi gösteren bayrak.

kabul edilen değerler: false, true

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--od --output-dir

Otomatik olarak imzalanan sertifika oluşturun ve parmak izini kullanın. Belirtilen hedef dizine çıktı.

--pk --primary-key

Base64 biçiminde depolanan birincil simetrik paylaşılan erişim anahtarı.

--primary-thumbprint --ptp

Birincil parmak izi için kullanılacak otomatik olarak imzalanan sertifika parmak izi.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

--secondary-key --sk

base64 biçiminde depolanan ikincil simetrik paylaşılan erişim anahtarı.

--secondary-thumbprint --stp

İkincil parmak izi için kullanılacak otomatik olarak imzalanan sertifika parmak izi.

--sta --status

Oluşturuldukten sonra cihaz durumunu ayarlayın.

kabul edilen değerler: disabled, enabled

varsayılan değer: enabled

--star --status-reason

Cihaz durumu açıklaması.

--valid-days --vd

Otomatik olarak imzalanan sertifika oluşturun ve parmak izini kullanın. Belirtilen gün sayısı için geçerlidir. Varsayılan: 365.

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, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapı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 hub device-identity delete

bir IoT Hub cihazı silin.

az iot hub device-identity delete --device-id
                                  [--auth-type {key, login}]
                                  [--etag]
                                  [--hub-name]
                                  [--login]
                                  [--resource-group]

Gerekli Parametreler

--device-id -d

Hedef Cihaz.

İsteğe Bağlı Parametreler

--auth-type

kabul edilen değerler: key, login

varsayılan değer: key

--etag -e

Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmazsa '*' değeri kullanılır.

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--login -l

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults 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, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapı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 hub device-identity export

Tüm cihaz kimliklerini bir IoT Hub Azure Depolama blob kapsayıcısına aktarın. Satır içi blob kapsayıcıSı SAS uri girişi için lütfen ortamınızın giriş kurallarını gözden geçirin.

Daha fazla bilgi için bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry#import-and-export-device-identities.

az iot hub device-identity export --bcu
                                  --hub-name
                                  [--auth-type {identity, key}]
                                  [--identity]
                                  [--ik {false, true}]
                                  [--resource-group]

Örnekler

Tüm cihaz kimliklerini yapılandırılmış bir blob kapsayıcısına aktarın ve cihaz anahtarlarını ekleyin. Satır içi SAS uri örneği kullanır.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices?sv=2019-02-02&st=2020-08-23T22%3A35%3A00Z&se=2020-08-24T22%3A35%3A00Z&sr=c&sp=rwd&sig=VrmJ5sQtW3kLzYg10VqmALGCp4vtYKSLNjZDDJBSh9s%3D'

SAS uri'sini içeren bir dosya yolu kullanarak tüm cihaz kimliklerini yapılandırılmış blob kapsayıcısına aktarın.

az iot hub device-identity export -n {iothub_name} --bcu {sas_uri_filepath}

Tüm cihaz kimliklerini yapılandırılmış bir blob kapsayıcısına aktarın ve cihaz anahtarlarını ekleyin. Depolama hesabı için Depolama Blobu Veri Katkıda Bulunanı rollerine sahip sistem tarafından atanan kimliği kullanır. Blob kapsayıcısı uri'sinin blob SAS belirtecini gerektirmemesi.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --auth-type identity --identity [system]

Tüm cihaz kimliklerini yapılandırılmış bir blob kapsayıcısına aktarın ve cihaz anahtarlarını ekleyin. Depolama hesabı için Depolama Blobu Veri Katkıda Bulunanı rollerine ve IoT hub'ına katkıda bulunana sahip kullanıcı tarafından atanan yönetilen kimliği kullanır. Blob kapsayıcısı uri'sinin blob SAS belirtecini gerektirmemesi.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --auth-type identity --identity {managed_identity_resource_id}

Gerekli Parametreler

--bcu --blob-container-uri

Blob kapsayıcısına yazma, okuma ve silme erişimiyle Blob Paylaşılan Erişim İmzası URI'sini kullanın. Bu, işin durumunu ve sonuçları çıkarmak için kullanılır. Not: Kimlik tabanlı kimlik doğrulaması kullanılırken https:// URI'sı hala gereklidir ancak SAS belirteci gerekmez. Bu bağımsız değişkenin girişi satır içi veya dosya yolundan olabilir.

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

İsteğe Bağlı Parametreler

--auth-type --storage-authentication-type

Depolama kapsayıcısıyla iletişim kurmak için kimlik doğrulama türü.

kabul edilen değerler: identity, key

--identity

Sistem tarafından atanan yönetilen kimliğin veya kullanıcı tarafından atanan yönetilen kimliğin kullanılıp kullanılmadığını belirlemek için yönetilen kimlik türü. Sistem tarafından atanan yönetilen kimlik için [system] kullanın. Kullanıcı tarafından atanan yönetilen kimlik için, kullanıcı tarafından atanan yönetilen kimlik kaynak kimliğini sağlayın. Bu kimlik, Depolama Hesabı için bir Depolama Blobu Veri Katkıda Bulunanı rolleri gerektirir.

--ik --include-keys

Ayarlanırsa anahtarlar normal şekilde dışarı aktarılır. Aksi takdirde, dışarı aktarma çıkışında anahtarlar null olarak ayarlanır.

kabul edilen değerler: false, true

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults 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, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapı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 hub device-identity import

Cihaz kimliklerini blobdan bir IoT Hub aktarabilirsiniz. Satır içi blob kapsayıcıSı SAS uri girişi için lütfen ortamınızın giriş kurallarını gözden geçirin.

Daha fazla bilgi için bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry#import-and-export-device-identities.

az iot hub device-identity import --hub-name
                                  --ibcu
                                  --obcu
                                  [--auth-type {identity, key}]
                                  [--identity]
                                  [--resource-group]

Örnekler

Satır içi SAS uri'lerini kullanarak bir blobdan tüm cihaz kimliklerini içeri aktarabilirsiniz.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri}

SAS uri'sini içeren bir dosya yolu kullanarak blobdan tüm cihaz kimliklerini içeri aktarabilirsiniz.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri_filepath} --obcu {output_sas_uri_filepath}

Her iki depolama hesabı için de Depolama Blobu Veri Katkıda Bulunanı rollerine sahip sistem tarafından atanan kimliği kullanarak bir blobdan tüm cihaz kimliklerini içeri aktarabilirsiniz. Blob kapsayıcısı uri'sinin blob SAS belirtecini gerektirmemesi.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --auth-type identity --identity [system]

Hem depolama hesapları hem de IoT hub'ı için katkıda bulunan için Depolama Blobu Veri Katkıda Bulunanı rollerine sahip kullanıcı tarafından atanan yönetilen kimliği kullanarak blobdan tüm cihaz kimliklerini içeri aktarın. Blob kapsayıcısı uri'sinin blob SAS belirtecini gerektirmemesi.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --auth-type identity --identity {managed_identity_resource_id}

Gerekli Parametreler

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--ibcu --input-blob-container-uri

Blob kapsayıcısına okuma erişimi olan Blob Paylaşılan Erişim İmzası URI'si. Bu blob, kimlik kayıt defterinde gerçekleştirilecek işlemleri içerir. Not: Kimlik tabanlı kimlik doğrulaması kullanılırken https:// URI'sı hala gereklidir ancak SAS belirteci gerekmez. Bu bağımsız değişkenin girişi satır içi veya dosya yolundan olabilir.

--obcu --output-blob-container-uri

Blob kapsayıcısına yazma erişimi olan Blob Paylaşılan Erişim İmzası URI'si. Bu, işin durumunu ve sonuçları çıkarmak için kullanılır. Not: Kimlik tabanlı kimlik doğrulaması kullanılırken SAS belirteci olmadan bir https:// URI'sine ihtiyaç duyulur. Bu bağımsız değişkenin girişi satır içi veya dosya yolundan olabilir.

İsteğe Bağlı Parametreler

--auth-type --storage-authentication-type

Depolama kapsayıcısıyla iletişim kurmak için kimlik doğrulama türü.

kabul edilen değerler: identity, key

--identity

Sistem tarafından atanan yönetilen kimliğin veya kullanıcı tarafından atanan yönetilen kimliğin kullanılıp kullanılmadığını belirlemek için yönetilen kimlik türü. Sistem tarafından atanan yönetilen kimlik için [system] kullanın. Kullanıcı tarafından atanan yönetilen kimlik için, kullanıcı tarafından atanan yönetilen kimlik kaynak kimliğini sağlayın. Bu kimlik, hedef Depolama Hesabı için Bir Depolama Blobu Veri Katkıda Bulunanı rolü ve IoT Hub için Katkıda Bulunan rolü gerektirir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults 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, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapı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 hub device-identity list

Cihazları bir IoT Hub listeleyin.

az iot hub device-identity list [--auth-type {key, login}]
                                [--edge-enabled {false, true}]
                                [--hub-name]
                                [--login]
                                [--resource-group]
                                [--top]

İsteğe Bağlı Parametreler

--auth-type

İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumunu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

kabul edilen değerler: key, login

varsayılan değer: key

--edge-enabled --ee

Kenar etkinleştirmeyi gösteren bayrak.

kabul edilen değerler: false, true

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--login -l

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--top

Döndürülecek öğe sayısı üst sınırı. Sınırsız için -1 kullanın.

varsayılan değer: 1000

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, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapı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 hub device-identity renew-key

Sas kimlik doğrulaması ile bir IoT Hub cihazının hedef anahtarlarını yenileyin.

az iot hub device-identity renew-key --device-id
                                     --hub-name
                                     --key-type {primary, secondary, swap}
                                     [--auth-type {key, login}]
                                     [--etag]
                                     [--login]
                                     [--resource-group]

Örnekler

Birincil anahtarı yenileyin.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt primary

Birincil ve ikincil anahtarları değiştirin.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt swap

Gerekli Parametreler

--device-id -d

Hedef Cihaz.

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--key-type --kt

Yeniden oluşturulacak hedef anahtar türü.

kabul edilen değerler: primary, secondary, swap

İsteğe Bağlı Parametreler

--auth-type

kabul edilen değerler: key, login

varsayılan değer: key

--etag -e

Kaynağın son durumuna karşılık gelen Etag veya varlık etiketi. Etag sağlanmazsa '*' değeri kullanılır.

--login -l

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults 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, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapı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 hub device-identity show

bir IoT Hub cihazının ayrıntılarını alın.

az iot hub device-identity show --device-id
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--resource-group]

Gerekli Parametreler

--device-id -d

Hedef Cihaz.

İsteğe Bağlı Parametreler

--auth-type

kabul edilen değerler: key, login

varsayılan değer: key

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--login -l

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults 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, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapı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 hub device-identity update

bir IoT Hub cihazını güncelleştirin.

Bir cihazı güncelleştirmek için --set ve ardından özellik atamaları kullanın. 'iot hub device-identity show'dan döndürülen parametrelerden yararlanın.

az iot hub device-identity update --device-id
                                  [--add]
                                  [--am {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--edge-enabled {false, true}]
                                  [--etag]
                                  [--force-string]
                                  [--hub-name]
                                  [--login]
                                  [--pk]
                                  [--primary-thumbprint]
                                  [--remove]
                                  [--resource-group]
                                  [--secondary-key]
                                  [--secondary-thumbprint]
                                  [--set]
                                  [--sta {disabled, enabled}]
                                  [--star]

Örnekler

Cihaz için uç özelliklerini açma

az iot hub device-identity update -d {device_id} -n {iothub_name} --set capabilities.iotEdge=true

Kolaylık bağımsız değişkenlerini kullanarak cihaz için uç özelliklerini açın.

az iot hub device-identity update -d {device_id} -n {iothub_name} --ee

Cihaz durumunu devre dışı bırakma

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled

Kolaylık bağımsız değişkeni kullanarak cihaz durumunu devre dışı bırakın.

az iot hub device-identity update -d {device_id} -n {iothub_name} --status disabled

Tek komutta

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled capabilities.iotEdge=true

Gerekli Parametreler

--device-id -d

Hedef Cihaz.

İsteğe Bağlı Parametreler

--add

Bir yol ve anahtar değer çiftleri belirterek nesne listesine nesne ekleyin. Örnek: --add property.listProperty <key=value, string veya JSON string>.

--am --auth-method

Varlığın oluşturulacağı yetkilendirme yöntemi.

kabul edilen değerler: shared_private_key, x509_ca, x509_thumbprint

--auth-type

kabul edilen değerler: key, login

varsayılan değer: key

--edge-enabled --ee

Kenar etkinleştirmeyi gösteren bayrak.

kabul edilen değerler: false, true

--etag -e

Kaynağın son durumuna karşılık gelen Etag veya varlık etiketi. Etag sağlanmazsa '*' değeri kullanılır.

--force-string

'set' veya 'add' kullanırken, JSON'a dönüştürmeye çalışmak yerine dize değişmez değerlerini koruyun.

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--login -l

--pk --primary-key

Base64 biçiminde depolanan birincil simetrik paylaşılan erişim anahtarı.

--primary-thumbprint --ptp

Birincil parmak izi için kullanılacak otomatik olarak imzalanan sertifika parmak izi.

--remove

Bir özelliği veya öğeyi listeden kaldırın. Örnek: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--secondary-key --sk

base64 biçiminde depolanan ikincil simetrik paylaşılan erişim anahtarı.

--secondary-thumbprint --stp

İkincil parmak izi için kullanılacak otomatik olarak imzalanan sertifika parmak izi.

--set

Ayarlanacağı özellik yolunu ve değerini belirterek bir nesneyi güncelleştirin. Örnek: --set property1.property2=.

--sta --status

Oluşturma sırasında cihaz durumunu ayarlayın.

kabul edilen değerler: disabled, enabled

--star --status-reason

Cihaz durumu için açıklama.

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, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapı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.