az iot hub device-identity

Not

Bu başvuru, Azure CLI (sürüm 2.37.0 veya üzeri) için azure-iot uzantısının bir parçasıdır. Uzantı, bir 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

Name	Description	Tür	Durum
az iot hub device-identity children	IoT edge cihazları için alt cihaz ilişkilerini yönetme.	Dahili	GA
az iot hub device-identity children add	Cihazları hedef uç cihazına alt öğe olarak ekleyin.	Dahili	GA
az iot hub device-identity children list	Atanan alt cihazların koleksiyonunu verir.	Dahili	GA
az iot hub device-identity children remove	Alt cihazları hedef uç cihazından kaldırın.	Dahili	GA
az iot hub device-identity connection-string	IoT cihazının bağlantı dizesi yönetin.	Dahili	GA
az iot hub device-identity connection-string show	Belirli bir IoT Hub cihazı bağlantı dizesi gösterin.	Dahili	GA
az iot hub device-identity create	IoT Hub'da cihaz oluşturma.	Dahili	GA
az iot hub device-identity delete	IoT Hub cihazını silme.	Dahili	GA
az iot hub device-identity export	IoT Hub'dan azure Depolama blob kapsayıcısına tüm cihaz kimliklerini dışarı aktarın.	Dahili	GA
az iot hub device-identity import	Cihaz kimliklerini bir depolama kapsayıcısı blobundan IoT Hub'a aktarın.	Dahili	GA
az iot hub device-identity list	IoT Hub'daki cihazları listeleme.	Dahili	GA
az iot hub device-identity parent	IoT cihazları için üst cihaz ilişkilerini yönetme.	Dahili	GA
az iot hub device-identity parent set	Hedef cihazın üst cihazını ayarlayın.	Dahili	GA
az iot hub device-identity parent show	Hedef cihazın üst cihazını alın.	Dahili	GA
az iot hub device-identity renew-key	Sas kimlik doğrulaması ile IoT Hub cihazının hedef anahtarlarını yenileyin.	Dahili	GA
az iot hub device-identity show	IoT Hub cihazının ayrıntılarını alın.	Dahili	GA
az iot hub device-identity update	IoT Hub cihazını güncelleştirme.	Dahili	GA

az iot hub device-identity create

IoT Hub'da cihaz oluşturma.

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 yetkilendirme (paylaşılan özel anahtar) ile 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 birincil ve ikincil parmak izlerini açıkça sağlayın.

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

Durumu ve nedeni devre dışı olan kök CA yetkilendirmesi 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 Kimliği.

İ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 oturumunu mu kullanması gerektiğini gösterir. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı 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

varsayılan değer: False

--hub-name -n

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

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi 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ğlanırsa, 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ı. 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.

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

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

varsayılan değer: json

--query

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

--subscription

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

az iot hub device-identity delete

IoT Hub cihazını silme.

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 Kimliği.

İ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. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

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ğlanmadıysa '*' değeri kullanılır.

--hub-name -n

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

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi 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ğlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

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

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

varsayılan değer: json

--query

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

--subscription

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

az iot hub device-identity export

IoT Hub'dan azure Depolama blob kapsayıcısına tüm cihaz kimliklerini dışarı aktarın.

Cihaz kimliklerini içeren çıkış blobu 'devices.txt' adlı bir metin dosyasıdır.

gerekli izinler - 'Kayıt Defteri Okuma ve Kayıt Defteri Yazma' destekleyen IoT Hub paylaşılan erişim ilkesi VEYA IoT Hub'da 'IoT Hub Veri Katkıda Bulunanı' rolüne sahip bir sorumlu.

Depolama hesap adı ve blob kapsayıcı adı parametreleri yalnızca depolama hesabı giriş IoT Hub'ı ile aynı abonelikte olduğunda kullanılabilir. Satır içi blob kapsayıcı 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://aka.ms/iothub-device-exportimport.

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

Örnekler

Tüm cihaz kimliklerini yapılandırılmış bir blob kapsayıcısına aktarın ve cihaz anahtarlarını ekleyin. Blob kapsayıcı adı ve depolama hesabı adı komutuna parametre olarak sağlanır.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name}

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ış bir 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 Blob Veri Katkıda Bulunanı rollerine sahip sistem tarafından atanan kimliği kullanır. Blob kapsayıcı adı ve depolama hesabı adı komutuna parametre olarak sağlanır.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --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 Blob 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' --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 Blob Veri Katkıda Bulunanı rolüne sahip kullanıcı tarafından atanan yönetilen kimliği kullanır. Blob kapsayıcı adı ve depolama hesabı adı komutuna parametre olarak sağlanır.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity {managed_identity_resource_id}

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 Blob Veri Katkıda Bulunanı rolüne 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' --identity {managed_identity_resource_id}

İ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. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

kabul edilen değerler: key, login

varsayılan değer: key

--bc --blob-container

Bu blob kapsayıcısı, cihaz kimliği içeri aktarma işinin durumunu ve sonuçları çıkarmak için kullanılır. blob_container_uri sağlandığında parametre yoksayılır. Bu blob kapsayıcısı için yazma, okuma ve silme erişimi gereklidir.

--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ı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.

--identity

Sistem tarafından atanan yönetilen kimlik 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 Depolama Blob 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

varsayılan değer: False

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi 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ğlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

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

--sa --storage-account

Çıktı blob kapsayıcısını içeren Azure Depolama hesabının adı. blob_container_uri sağlandığında parametre yoksayılır. Yazma, okuma ve silme erişimi gereklidir.

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

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

varsayılan değer: json

--query

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

--subscription

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

az iot hub device-identity import

Cihaz kimliklerini bir depolama kapsayıcısı blobundan IoT Hub'a aktarın.

Cihaz kimliklerini içeren beklenen giriş dosyası 'devices.txt' olarak adlandırılmalıdır. İçeri aktarma başarılı olduğunda 'importErrors.log' çıkış günlük dosyası boş olur ve içeri aktarma hatası durumunda hata günlükleri içerir.

gerekli izinler - 'Kayıt Defteri Okuma ve Kayıt Defteri Yazma' destekleyen IoT Hub paylaşılan erişim ilkesi VEYA IoT Hub'da 'IoT Hub Veri Katkıda Bulunanı' rolüne sahip bir sorumlu.

Depolama hesap adı ve blob kapsayıcı adı parametreleri yalnızca depolama hesabı giriş IoT Hub'ı ile aynı abonelikte olduğunda kullanılabilir. Satır içi blob kapsayıcı 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://aka.ms/iothub-device-exportimport.

az iot hub device-identity import [--auth-type {key, login}]
                                  [--hub-name]
                                  [--ibc]
                                  [--ibcu]
                                  [--identity]
                                  [--input-storage-account]
                                  [--login]
                                  [--obc]
                                  [--obcu]
                                  [--osa]
                                  [--resource-group]

Örnekler

Giriş blob kapsayıcısı ve depolama hesabının yanı sıra çıkış blob kapsayıcısı ve depolama hesabı için komut parametreleri sağlayarak bir blobdan tüm cihaz kimliklerini içeri aktarın.

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name}

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'sine sahip bir dosya yolu kullanarak bir 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 Depolama Blob Veri Katkıda Bulunanı rollerine sahip sistem tarafından atanan kimliği kullanarak bir blobdan tüm cihaz kimliklerini içeri aktarabilirsiniz. Giriş blob kapsayıcısı ve depolama hesabının yanı sıra çıktı blob kapsayıcısı ve depolama hesabı komutuna parametre olarak sağlanır

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity [system]

Her iki depolama hesabı için Depolama Blob 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} --identity [system]

Her iki depolama hesabı için de Depolama Blob Veri Katkıda Bulunanı rollerine sahip kullanıcı tarafından atanan yönetilen kimliği kullanarak blobdan tüm cihaz kimliklerini içeri aktarabilirsiniz. Giriş blob kapsayıcısı ve depolama hesabının yanı sıra çıktı blob kapsayıcısı ve depolama hesabı komutuna parametre olarak sağlanır

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity {managed_identity_resource_id}

Her iki depolama hesabı için de Depolama Blob Veri Katkıda Bulunanı rollerine sahip kullanıcı tarafından atanan yönetilen kimliği kullanarak 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} --identity {managed_identity_resource_id}

İ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. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

kabul edilen değerler: key, login

varsayılan değer: key

--hub-name -n

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

--ibc --input-blob-container

Bu blob kapsayıcısı, kimlik kayıt defterinde gerçekleştirilecek işlemleri tanımlayan dosyayı depolar. input_blob_container_uri sağlandığında parametre yoksayılır. Bu blob kapsayıcısı için okuma erişimi 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.

--identity

Sistem tarafından atanan yönetilen kimlik 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, IoT Hub için hedef Depolama Hesabı ve Katkıda Bulunan rolü için Depolama Blob Veri Katkıda Bulunanı rolü gerektirir.

--input-storage-account --isa

Giriş blobu kapsayıcısını içeren Azure Depolama hesabının adı. Yalnızca input_blob_container_uri sağlanmadığında gereklidir. Okuma erişimi gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi 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ğlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--obc --output-blob-container

Bu blob kapsayıcısı, cihaz kimliği içeri aktarma işinin durumunu ve sonuçları çıkarmak için kullanılır. Yalnızca input_blob_container_uri sağlanmadığında gereklidir. Bu blob kapsayıcısı için yazma erişimi gereklidir.

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

--osa --output-storage-account

Çıktı blob kapsayıcısını içeren Azure Depolama hesabının adı. output_blob_container_uri sağlandığında parametre yoksayılır. Yazma erişimi gereklidir.

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

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

varsayılan değer: json

--query

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

--subscription

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

az iot hub device-identity list

IoT Hub'daki cihazları listeleme.

Bu komut, için az iot hub device-twin listbir diğer addır ve bu komut üzerinde kesinlikle önerilir. Gelecekte bu az iot hub device-identity list komut değiştirilebilir veya kullanım dışı bırakılabilir.

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. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı 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

varsayılan değer: False

--hub-name -n

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

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi 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ğlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

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

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

varsayılan değer: json

--query

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

--subscription

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

az iot hub device-identity renew-key

Sas kimlik doğrulaması ile 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 Kimliği.

--hub-name -n

IoT Hub adı veya ana bilgisayar 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

İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumunu mu kullanması gerektiğini gösterir. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

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ğlanmadıysa '*' değeri kullanılır.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi 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ğlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

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

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

varsayılan değer: json

--query

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

--subscription

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

az iot hub device-identity show

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 Kimliği.

İ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. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

kabul edilen değerler: key, login

varsayılan değer: key

--hub-name -n

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

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi 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ğlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

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

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

varsayılan değer: json

--query

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

--subscription

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

az iot hub device-identity update

IoT Hub cihazını güncelleştirme.

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şkenlerini 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 Kimliği.

İ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 or JSON string>.

varsayılan değer: []

--am --auth-method

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

kabul edilen değerler: shared_private_key, x509_ca, x509_thumbprint

--auth-type

İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumunu mu kullanması gerektiğini gösterir. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı 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

--etag -e

Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmadıysa '*' 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.

varsayılan değer: False

--hub-name -n

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

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi 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ğlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--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 <indexToRemove> OR --remove propertyToRemove.

varsayılan değer: []

--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 nesneyi güncelleştirin. Örnek: --set property1.property2=<value>.

varsayılan değer: []

--sta --status

Oluşturuldukten sonra cihaz durumunu ayarlayın.

kabul edilen değerler: disabled, enabled

--star --status-reason

Cihaz durumu açıklaması.

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

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

varsayılan değer: json

--query

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

--subscription

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