az iot device registration

  • Pratinjau
  • Referensi

Catatan

Referensi ini adalah bagian dari ekstensi azure-iot untuk Azure CLI (versi 2.37.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah pendaftaran perangkat az iot. Pelajari lebih lanjut tentang ekstensi.

Grup perintah ini dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Mengelola pendaftaran perangkat IoT untuk IoT Device Provisioning Service.

Gunakan az iot dps enrollment registration atau az iot dps enrollment-group registration untuk melihat dan menghapus pendaftaran.

Perintah

Nama Deskripsi Jenis Status
az iot device registration create

Daftarkan perangkat IoT dengan IoT Device Provisioning Service.

 Ekstensi Pratinjau

az iot device registration create

Pratinjau

Grup perintah 'pendaftaran perangkat iot' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Daftarkan perangkat IoT dengan IoT Device Provisioning Service.

Mekanisme pengesahan berikut didukung:

  • Kunci konten
  • Sertifikat x509 Jika menggunakan metode autentikasi x509, sertifikat dan file kunci (dan frasa sandi jika diperlukan) harus disediakan.
az iot device registration create --registration-id
                                  [--auth-type {key, login}]
                                  [--certificate-file-path]
                                  [--ck]
                                  [--dps-name]
                                  [--enrollment-group-id]
                                  [--host]
                                  [--id-scope]
                                  [--key]
                                  [--key-file-path]
                                  [--login]
                                  [--pass]
                                  [--payload]
                                  [--resource-group]

Contoh

Daftarkan perangkat IoT menggunakan pendaftaran individu.

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

Daftarkan perangkat IoT menggunakan pendaftaran grup.

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

Daftarkan perangkat IoT menggunakan pendaftaran individu, Cakupan ID Device Provisioning Service, dan kunci konten yang diberikan. Ini akan melewati pengambilan Cakupan ID dan kunci simetris pendaftaran individal.

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

Daftarkan perangkat IoT menggunakan pendaftaran grup, Cakupan ID Device Provisioning Service, dan kunci konten grup pendaftaran yang diberikan. Ini akan melewati pengambilan Cakupan ID dan kunci simetris grup pendaftaran. Kunci konten yang digunakan untuk pendaftaran perangkat akan dihitung dari kunci konten yang diberikan.

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

Daftarkan perangkat IoT menggunakan pendaftaran grup, Cakupan ID Device Provisioning Service, dan kunci konten yang diberikan. Ini akan melewati pengambilan Cakupan ID. Perhatikan bahwa karena kunci konten harus menjadi kunci perangkat komputasi, id grup pendaftaran tidak diperlukan.

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

Daftarkan perangkat IoT menggunakan pendaftaran individu, Cakupan ID Device Provisioning Service, dan sertifikat dan file kunci yang diberikan. Ini akan melewati pengambilan Cakupan ID.

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

Daftarkan perangkat IoT menggunakan pendaftaran individu, Cakupan ID Device Provisioning Service, dan sertifikat serta file kunci dan frasa sandi yang diberikan untuk file kunci. Ini akan melewati pengambilan Cakupan ID.

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

Daftarkan perangkat IoT menggunakan pendaftaran grup, Cakupan ID Device Provisioning Service, dan sertifikat dan file kunci yang diberikan. Ini akan melewati pengambilan Cakupan ID. Perhatikan bahwa id pendaftaran grup tidak diperlukan untuk pengesahan x509 dan subjek file sertifikat adalah id pendaftaran.

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

Parameter yang Diperlukan

--registration-id --rid

ID pendaftaran perangkat atau ID pendaftaran individual.

Parameter Opsional

--auth-type

Menunjukkan apakah operasi harus memperoleh kunci kebijakan secara otomatis atau menggunakan sesi Azure ACTIVE Directory saat ini. Jika jenis autentikasi masuk dan nama host sumber daya disediakan, pencarian sumber daya akan dilewati kecuali diperlukan. Anda dapat mengonfigurasi default menggunakan az configure --defaults iothub-data-auth-type=<auth-type-value>.

nilai yang diterima: key, login
nilai default: key
--certificate-file-path --cp

Jalur ke file PEM sertifikat. Diperlukan untuk pendaftaran x509.

--ck --compute-key

Bendera untuk menunjukkan bahwa kunci konten untuk pendaftaran perangkat harus dihitung dari kunci yang diberikan dengan --symmetric-key.

nilai default: False
--dps-name -n

Nama Azure IoT Hub Device Provisioning Service. Diperlukan jika --login tidak disediakan atau argumen authenticaton dan --id-scope tidak disediakan.

--enrollment-group-id --gid --group-id

ID grup pendaftaran. Hanya diperlukan untuk mengambil argumen autentikasi.

--host --provisioning-host

Titik akhir menunjuk ke host provisi untuk digunakan.

nilai default: global.azure-devices-provisioning.net
--id-scope --scope

Cakupan Id Dari Azure IoT Hub Device Provisioning Service. Jika disediakan dengan argumen autentikasi, akan menghindari login sesi.

--key --symmetric-key

Kunci akses bersama simetris untuk pendaftaran perangkat.

--key-file-path --kp

Jalur ke file PEM kunci. Diperlukan untuk pendaftaran x509.

--login -l

Perintah ini mendukung entitas string koneksi dengan hak untuk melakukan tindakan. Gunakan untuk menghindari login sesi melalui "az login". Jika entitas string koneksi dan nama disediakan, string koneksi lebih diprioritaskan. Diperlukan jika --dps-name tidak disediakan atau argumen authenticaton dan --id-scope tidak disediakan.

--pass --passphrase

Frase sandi untuk sertifikat.

--payload

Payload alokasi kustom sebagai JSON. Khusus untuk digunakan dengan kebijakan alokasi kustom menggunakan Azure Functions.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.