az iot device registration

Note

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

Bu komut grubu önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

IoT Cihazı Sağlama Hizmeti için IoT cihaz kayıtlarını yönetin.

Kayıtları görüntülemek ve silmek için veya az iot dps enrollment registration kullanınaz iot dps enrollment-group registration.

Komutlar

Name Description Tür Durum
az iot device registration create

IoT Cihazı Sağlama Hizmeti'ne bir IoT cihazı kaydedin.

Extension Preview

az iot device registration create

Önizleme

'iot cihaz kaydı' komut grubu önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

IoT Cihazı Sağlama Hizmeti'ne bir IoT cihazı kaydedin.

Aşağıdaki kanıtlama mekanizmaları desteklenir:

  • Simetrik anahtar
  • x509 sertifikası x509 kimlik doğrulama yöntemleri kullanılıyorsa, sertifika ve anahtar dosyaları (ve gerekirse parola) sağlanmalıdır.
az iot device registration create --registration-id --rid
                                  [--acquire-policy-token]
                                  [--auth-type {key, login}]
                                  [--certificate-file-path --cp]
                                  [--change-reference]
                                  [--ck --compute-key]
                                  [--dps-name]
                                  [--enrollment-group-id --gid --group-id]
                                  [--host --provisioning-host]
                                  [--id-scope --scope]
                                  [--key --symmetric-key]
                                  [--key-file-path --kp]
                                  [--login]
                                  [--pass --passphrase]
                                  [--payload]
                                  [--resource-group]

Örnekler

Tek bir kayıt kullanarak ioT cihazı kaydetme.

az iot device registration create -n {dps_name} --rid {registration_id}

Grup kaydı kullanarak ioT cihazı kaydetme.

az iot device registration create -n {dps_name} --rid {registration_id} --gid {group_enrollment_id}

Tek bir kayıt, Cihaz Sağlama Hizmeti Kimliği Kapsamı ve verilen simetrik anahtarı kullanarak bir IoT cihazı kaydedin. Bu, KIMLIK Kapsamı ve bölünmez kayıt simetrik anahtarını almayı atlar.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

Grup kaydı, Cihaz Sağlama Hizmet Kimliği Kapsamı ve verilen kayıt grubu simetrik anahtarı kullanarak bir IoT cihazı kaydedin. Bu, Kimlik Kapsamı ve kayıt grubu simetrik anahtarını almayı atlar. Cihaz kaydı için kullanılan simetrik anahtar, verilen simetrik anahtardan hesaplanır.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --gid {group_enrollment_id} --key {symmetric_key} --ck

Grup kaydı, Cihaz Sağlama Hizmeti Kimliği Kapsamı ve verilen simetrik anahtarı kullanarak bir IoT cihazı kaydedin. Bu, Kimlik Kapsamının alınmasını atlar. Simetrik anahtarın hesaplanan cihaz anahtarı olması gerektiğinden kayıt grubu kimliğinin gerekli olmadığını unutmayın.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

Tek bir kayıt, Cihaz Sağlama Hizmet Kimliği Kapsamı ve verilen sertifika ve anahtar dosyalarını kullanarak bir IoT cihazı kaydedin. Bu, Kimlik Kapsamının alınmasını atlar.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

Tek bir kayıt, Cihaz Sağlama Hizmeti Kimlik Kapsamı ve anahtar dosyası için verilen sertifika ve anahtar dosyaları ile parolayı kullanarak bir IoT cihazı kaydedin. Bu, Kimlik Kapsamının alınmasını atlar.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file} --pass {passphrase}

Grup kaydı, Cihaz Sağlama Hizmet Kimliği Kapsamı ve verilen sertifika ve anahtar dosyalarını kullanarak bir IoT cihazı kaydedin. Bu, Kimlik Kapsamının alınmasını atlar. x509 kanıtlamaları için grup kayıt kimliğinin gerekli olmadığını ve sertifika dosyasının konusunun kayıt kimliği olduğunu unutmayın.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

Gerekli Parametreler

--registration-id --rid

Cihaz kayıt kimliği veya bireysel kayıt 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 Policy belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--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
--certificate-file-path --cp

Sertifika PEM dosyasının yolu. x509 kayıtları için gereklidir.

Özellik Değer
Parametre grubu: x509 Authentication Arguments
--change-reference

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

Özellik Değer
Parametre grubu: Global Policy Arguments
--ck --compute-key

Cihaz kaydı için simetrik anahtarın verilen anahtardan --symmetric-key ile hesaplanması gerektiğini belirten bayrak.

Özellik Değer
Parametre grubu: Symmetric Key Authentication Arguments
Default value: False
--dps-name -n

Azure IoT Hub Cihaz Sağlama Hizmeti'nin adı. --login sağlanmadıysa veya authenticaton bağımsız değişkenleri ve --id-scope sağlanmadıysa gereklidir.

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

Kayıt grubu kimliği. Yalnızca kimlik doğrulama bağımsız değişkenlerini almak için gereklidir.

--host --provisioning-host

Kullanılacak sağlama konağına işaret eden uç nokta.

Özellik Değer
Default value: global.azure-devices-provisioning.net
--id-scope --scope

Azure IoT Hub Cihaz Sağlama Hizmetinin Kimlik Kapsamı. Kimlik doğrulama bağımsız değişkenleriyle sağlanırsa oturum açma işlemi engellenir.

Özellik Değer
Parametre grubu: DPS Identifier Arguments
--key --symmetric-key

Cihaz kaydı için simetrik paylaşılan erişim anahtarı.

Özellik Değer
Parametre grubu: Symmetric Key Authentication Arguments
--key-file-path --kp

Anahtar PEM dosyasının yolu. x509 kayıtları için gereklidir.

Özellik Değer
Parametre grubu: x509 Authentication Arguments
--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık connection string destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık connection string hem de ad sağlanırsa, connection string öncelik alır. --dps-name sağlanmadıysa veya authenticaton bağımsız değişkenleri ve --id-scope sağlanmadıysa gereklidir.

Özellik Değer
Parametre grubu: DPS Identifier Arguments
--pass --passphrase

Sertifikanın parolası.

Özellik Değer
Parametre grubu: x509 Authentication Arguments
--payload

JSON olarak özel ayırma yükü. Özellikle Azure Functions kullanan özel ayırma ilkeleriyle kullanım için.

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