az iot hub device-identity

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ı, 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.	Extension	GA
az iot hub device-identity children add	Cihazları hedef uç cihazına alt öğe olarak ekleyin.	Extension	GA
az iot hub device-identity children list	Atanan alt cihazların koleksiyonunu verir.	Extension	GA
az iot hub device-identity children remove	Alt cihazları hedef uç cihazından kaldırın.	Extension	GA
az iot hub device-identity connection-string	IoT cihazının bağlantı dizesi yönetin.	Extension	GA
az iot hub device-identity connection-string show	Belirli bir IoT Hub cihazı bağlantı dizesi gösterin.	Extension	GA
az iot hub device-identity create	IoT Hub bir cihaz oluşturun.	Extension	GA
az iot hub device-identity delete	bir IoT Hub cihazı silin.	Extension	GA
az iot hub device-identity export	Bir IoT Hub Azure Depolama blob kapsayıcısına tüm cihaz kimliklerini dışarı aktarın.	Extension	GA
az iot hub device-identity import	Cihaz kimliklerini depolama kapsayıcısı blobundan bir IoT Hub içeri aktarın.	Extension	GA
az iot hub device-identity list	IoT Hub cihazları listeleme.	Extension	GA
az iot hub device-identity parent	IoT cihazları için üst cihaz ilişkilerini yönetme.	Extension	GA
az iot hub device-identity parent set	Hedef cihazın üst cihazını ayarlayın.	Extension	GA
az iot hub device-identity parent show	Hedef cihazın üst cihazını alın.	Extension	GA
az iot hub device-identity renew-key	sas kimlik doğrulaması ile IoT Hub cihazların hedef anahtarlarını yenileyin.	Extension	GA
az iot hub device-identity show	bir IoT Hub cihazının ayrıntılarını alın.	Extension	GA
az iot hub device-identity update	bir IoT Hub cihazını güncelleştirin.	Extension	GA

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
                                  [--acquire-policy-token]
                                  [--am --auth-method {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--change-reference]
                                  [--device-scope]
                                  [--edge-enabled --ee {false, true}]
                                  [--hub-name]
                                  [--login]
                                  [--od --output-dir]
                                  [--pk --primary-key]
                                  [--primary-thumbprint --ptp]
                                  [--resource-group]
                                  [--secondary-key --sk]
                                  [--secondary-thumbprint --stp]
                                  [--sta --status {disabled, enabled}]
                                  [--star --status-reason]
                                  [--valid-days --vd]

Ö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

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

--am --auth-method

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

Özellik	Değer
Default value:	shared_private_key
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.

Özellik	Değer
Parametre grubu:	Access Control Arguments
Default value:	key
Kabul edilen değerler:	key, login

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

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

Özellik	Değer
Parametre grubu:	Device Scope Arguments

--edge-enabled --ee

Kenar etkinleştirmeyi gösteren bayrak.

Özellik	Değer
Default value:	False
Kabul edilen değerler:	false, true

--hub-name -n

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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--od --output-dir

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

Özellik	Değer
Parametre grubu:	X.509 Arguments

--pk --primary-key

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

Özellik	Değer
Parametre grubu:	Symmetric Key Arguments

--primary-thumbprint --ptp

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

Özellik	Değer
Parametre grubu:	X.509 Arguments

--resource-group -g

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

--secondary-key --sk

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

Özellik	Değer
Parametre grubu:	Symmetric Key Arguments

--secondary-thumbprint --stp

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

Özellik	Değer
Parametre grubu:	X.509 Arguments

--sta --status

Oluşturuldukten sonra cihaz durumunu ayarlayın.

Özellik	Değer
Default value:	enabled
Kabul edilen değerler:	disabled, 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.

Özellik	Değer
Parametre grubu:	X.509 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 hub device-identity delete

bir IoT Hub cihazı silin.

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

Gerekli Parametreler

--device-id -d

Hedef Cihaz Kimliği.

İ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

--auth-type

Özellik	Değer
Parametre grubu:	Access Control Arguments
Default value:	key
Kabul edilen değerler:	key, login

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--login -l

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu 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.

Ö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 hub device-identity export

Bir IoT Hub 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 Okuma' destekleyen paylaşılan erişim ilkesi IoT Hub Kayıt Defteri Yazma' VEYA IoT Hub 'IoT Hub Veri Katkıda Bulunanı' rolüne sahip bir sorumlu.

Depolama hesabı adı ve blob kapsayıcı adı parametreleri yalnızca depolama hesabı giriş IoT Hub 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 [--acquire-policy-token]
                                  [--auth-type {key, login}]
                                  [--bc --blob-container]
                                  [--bcu --blob-container-uri]
                                  [--change-reference]
                                  [--hub-name]
                                  [--identity]
                                  [--ik --include-keys {false, true}]
                                  [--login]
                                  [--resource-group]
                                  [--sa --storage-account]

Ö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 Verileri 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]

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 Verileri 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}

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

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

--auth-type

Özellik	Değer
Parametre grubu:	Access Control Arguments
Default value:	key
Kabul edilen değerler:	key, login

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

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--hub-name -n

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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

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

Özellik	Değer
Default value:	False
Kabul edilen değerler:	false, true

--login -l

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu 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.

Ö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 hub device-identity import

Cihaz kimliklerini depolama kapsayıcısı blobundan bir IoT Hub içeri 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 Okuma' destekleyen paylaşılan erişim ilkesi IoT Hub Kayıt Defteri Yazma' VEYA IoT Hub 'IoT Hub Veri Katkıda Bulunanı' rolüne sahip bir sorumlu.

Daha fazla bilgi için bkz. https://aka.ms/iothub-device-exportimport.

az iot hub device-identity import [--acquire-policy-token]
                                  [--auth-type {key, login}]
                                  [--change-reference]
                                  [--hub-name]
                                  [--ibc --input-blob-container]
                                  [--ibcu --input-blob-container-uri]
                                  [--identity]
                                  [--input-storage-account --isa]
                                  [--login]
                                  [--obc --output-blob-container]
                                  [--obcu --output-blob-container-uri]
                                  [--osa --output-storage-account]
                                  [--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 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. 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 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} --identity [system]

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

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

İ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

--auth-type

Özellik	Değer
Parametre grubu:	Access Control Arguments
Default value:	key
Kabul edilen değerler:	key, login

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--hub-name -n

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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--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, hedef Depolama Hesabı için Bir Depolama Blobu Veri Katkıda Bulunanı rolü ve IoT Hub için 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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--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ı. az configure --defaults group=<name>kullanarak varsayılan grubu 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.

Ö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 hub device-identity list

IoT Hub 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 --ee {false, true}]
                                [--hub-name]
                                [--login]
                                [--resource-group]
                                [--top]

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

--auth-type

Özellik	Değer
Parametre grubu:	Access Control Arguments
Default value:	key
Kabul edilen değerler:	key, login

--edge-enabled --ee

Kenar etkinleştirmeyi gösteren bayrak.

Özellik	Değer
Default value:	False
Kabul edilen değerler:	false, true

--hub-name -n

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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--login -l

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--resource-group -g

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

--top

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

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

Ö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 hub device-identity renew-key

sas kimlik doğrulaması ile IoT Hub cihazların hedef anahtarlarını yenileyin.

Şu anda toplu anahtar yeniden oluşturma için etag'ler ve anahtar türü swap desteklenmiyor. Toplu Anahtar yeniden oluşturma işlemi, tek bir cihaz anahtarı yeniden oluşturma işleminden farklı bir çıkış biçimi oluşturur.

az iot hub device-identity renew-key --device-id
                                     --hub-name
                                     --key-type --kt {both, primary, secondary, swap}
                                     [--acquire-policy-token]
                                     [--auth-type {key, login}]
                                     [--change-reference]
                                     [--etag]
                                     [--im --include-modules {false, true}]
                                     [--login]
                                     [--no-progress {false, true}]
                                     [--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

İki cihaz ve modülleri için ikincil anahtarı yenileyin.

az iot hub device-identity renew-key -d {device_id} {device_id} -n {iothub_name} --kt secondary --include-modules

Hub içindeki tüm cihazlar için her iki anahtarı da yenileyin.

az iot hub device-identity renew-key -d * -n {iothub_name} --kt both

Gerekli Parametreler

--device-id -d

Hedef Cihaz Kimliklerinin boşlukla ayrılmış listesi. Tüm cihazlar için * kullanın.

--hub-name -n

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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--key-type --kt

Yeniden oluşturulacak hedef anahtar türü.

Özellik	Değer
Kabul edilen değerler:	both, primary, secondary, swap

İ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

--auth-type

Özellik	Değer
Parametre grubu:	Access Control Arguments
Default value:	key
Kabul edilen değerler:	key, login

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--etag -e

Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmadıysa '*' değeri kullanılır. Bu bağımsız değişken yalnızca swapiçin geçerlidir.

--im --include-modules

Anahtar yeniden oluşturma sırasında cihaz modüllerini eklemek için bayrak ekleyin.

Özellik	Değer
Default value:	False
Kabul edilen değerler:	false, true

--login -l

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--no-progress

Toplu anahtar yeniden oluşturma işlemi için ilerleme çubuğunu gizleyin.

Özellik	Değer
Default value:	False
Kabul edilen değerler:	false, true

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu 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.

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

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

--auth-type

Özellik	Değer
Parametre grubu:	Access Control Arguments
Default value:	key
Kabul edilen değerler:	key, login

--hub-name -n

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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--login -l

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu 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.

Ö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 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
                                  [--acquire-policy-token]
                                  [--add]
                                  [--am --auth-method {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--change-reference]
                                  [--edge-enabled --ee {false, true}]
                                  [--etag]
                                  [--force-string]
                                  [--hub-name]
                                  [--login]
                                  [--pk --primary-key]
                                  [--primary-thumbprint --ptp]
                                  [--remove]
                                  [--resource-group]
                                  [--secondary-key --sk]
                                  [--secondary-thumbprint --stp]
                                  [--set]
                                  [--sta --status {disabled, enabled}]
                                  [--star --status-reason]

Ö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

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

--add

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	[]

--am --auth-method

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

Özellik	Değer
Kabul edilen değerler:	shared_private_key, x509_ca, x509_thumbprint

--auth-type

Özellik	Değer
Parametre grubu:	Access Control Arguments
Default value:	key
Kabul edilen değerler:	key, login

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--edge-enabled --ee

Kenar etkinleştirmeyi gösteren bayrak.

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	False

--hub-name -n

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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--login -l

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--pk --primary-key

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

Özellik	Değer
Parametre grubu:	Symmetric Key Arguments

--primary-thumbprint --ptp

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

Özellik	Değer
Parametre grubu:	X.509 Arguments

--remove

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	[]

--resource-group -g

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

--secondary-key --sk

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

Özellik	Değer
Parametre grubu:	Symmetric Key Arguments

--secondary-thumbprint --stp

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

Özellik	Değer
Parametre grubu:	X.509 Arguments

--set

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	[]

--sta --status

Oluşturuldukten sonra cihaz durumunu ayarlayın.

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

Ö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

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Aracılığıyla paylaş

az iot hub device-identity

Komutlar

az iot hub device-identity create

Örnekler

Gerekli Parametreler

İsteğe Bağlı Parametreler

az iot hub device-identity delete

Gerekli Parametreler

İsteğe Bağlı Parametreler

az iot hub device-identity export

Örnekler

İsteğe Bağlı Parametreler

az iot hub device-identity import

Örnekler

İsteğe Bağlı Parametreler

az iot hub device-identity list

İsteğe Bağlı Parametreler

az iot hub device-identity renew-key

Örnekler

Gerekli Parametreler

İsteğe Bağlı Parametreler

az iot hub device-identity show

Gerekli Parametreler

İsteğe Bağlı Parametreler

az iot hub device-identity update

Örnekler

Gerekli Parametreler

İsteğe Bağlı Parametreler

Geri Bildirim