az iot device registration
Catatan
Referensi ini adalah bagian dari ekstensi azure-iot untuk Azure CLI (versi 2.46.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
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
ID pendaftaran perangkat atau ID pendaftaran individual.
Parameter Opsional
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>
.
Jalur ke file PEM sertifikat. Diperlukan untuk pendaftaran x509.
Bendera untuk menunjukkan bahwa kunci konten untuk pendaftaran perangkat harus dihitung dari kunci yang diberikan dengan --symmetric-key.
Nama Azure IoT Hub Device Provisioning Service. Diperlukan jika --login tidak disediakan atau argumen authenticaton dan --id-scope tidak disediakan.
ID grup pendaftaran. Hanya diperlukan untuk mengambil argumen autentikasi.
Titik akhir menunjuk ke host provisi untuk digunakan.
Cakupan Id Dari Azure IoT Hub Device Provisioning Service. Jika disediakan dengan argumen autentikasi, akan menghindari login sesi.
Kunci akses bersama simetris untuk pendaftaran perangkat.
Jalur ke file PEM kunci. Diperlukan untuk pendaftaran x509.
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.
Frase sandi untuk sertifikat.
Payload alokasi kustom sebagai JSON. Khusus untuk digunakan dengan kebijakan alokasi kustom menggunakan Azure Functions.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Parameter Global
Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.
Menampilkan pesan bantuan ini dan keluar.
Hanya menampilkan kesalahan, menyembunyikan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.