az iot dps enrollment-group
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 az iot dps enrollment-group . Pelajari lebih lanjut tentang ekstensi.
Mengelola grup pendaftaran di Azure IoT Hub Device Provisioning Service.
Perintah
Nama | Deskripsi | Jenis | Status |
---|---|---|---|
az iot dps enrollment-group compute-device-key |
Buat kunci SAS perangkat turunan untuk grup pendaftaran di Azure IoT Hub Device Provisioning Service. |
Ekstensi | GA |
az iot dps enrollment-group create |
Buat grup pendaftaran di Azure IoT Hub Device Provisioning Service. |
Ekstensi | GA |
az iot dps enrollment-group delete |
Menghapus grup pendaftaran di Azure IoT Hub Device Provisioning Service. |
Ekstensi | GA |
az iot dps enrollment-group list |
Mencantumkan grup pendaftaran di Azure IoT Hub Device Provisioning Service. |
Ekstensi | GA |
az iot dps enrollment-group registration |
Mengelola pendaftaran perangkat sisi layanan untuk grup pendaftaran di Azure IoT Hub Device Provisioning Service. |
Ekstensi | GA |
az iot dps enrollment-group registration delete |
Menghapus pendaftaran perangkat untuk grup pendaftaran di Azure IoT Hub Device Provisioning Service. |
Ekstensi | GA |
az iot dps enrollment-group registration list |
Mencantumkan pendaftaran perangkat untuk grup pendaftaran di Azure IoT Hub Device Provisioning Service. |
Ekstensi | GA |
az iot dps enrollment-group registration show |
Dapatkan pendaftaran perangkat untuk grup pendaftaran di Azure IoT Hub Device Provisioning Service. |
Ekstensi | GA |
az iot dps enrollment-group show |
Dapatkan detail grup pendaftaran di Azure IoT Hub Device Provisioning Service. |
Ekstensi | GA |
az iot dps enrollment-group update |
Perbarui grup pendaftaran di Azure IoT Hub Device Provisioning Service. |
Ekstensi | GA |
az iot dps enrollment-group compute-device-key
Buat kunci SAS perangkat turunan untuk grup pendaftaran di Azure IoT Hub Device Provisioning Service.
az iot dps enrollment-group compute-device-key --registration-id
[--auth-type {key, login}]
[--dps-name]
[--eid]
[--key]
[--login]
[--resource-group]
Contoh
Komputasi kunci perangkat dengan kunci konten yang diberikan.
az iot dps enrollment-group compute-device-key --key {enrollement_group_symmetric_key} --registration-id {registration_id}
Komputasi kunci perangkat dengan grup pendaftaran yang diberikan.
az iot dps enrollment-group compute-device-key -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --registration-id {registration_id}
Parameter yang Diperlukan
ID pendaftaran perangkat.
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 iotdps-data-auth-type=<auth-type-value>
.
Nama atau nama host Azure IoT Hub Device Provisioning Service. Diperlukan jika --login tidak disediakan.
ID grup pendaftaran.
Kunci akses bersama simetris untuk grup pendaftaran. Ini melewati registri Device Provisioning Service dan menghasilkan token SAS langsung dari kunci konten yang disediakan tanpa validasi lebih lanjut. Semua parameter perintah lainnya selain DARI ID pendaftaran akan diabaikan.
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.
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.
az iot dps enrollment-group create
Buat grup pendaftaran di Azure IoT Hub Device Provisioning Service.
Harap sediakan format sertifikat menggunakan pengodean Base64 ASCII dan sertifikat harus memiliki segmen BEGIN dan END yang cocok, misalnya: mulailah dengan '-----BEGIN CERTIFICATE-----' dan berakhir dengan '-----END CERTIFICATE-----'.
az iot dps enrollment-group create --eid
[--allocation-policy {custom, geoLatency, hashed, static}]
[--api-version]
[--auth-type {key, login}]
[--ca-name]
[--certificate-path]
[--dps-name]
[--edge-enabled {false, true}]
[--ih]
[--initial-twin-properties]
[--initial-twin-tags]
[--login]
[--pk]
[--provisioning-status {disabled, enabled}]
[--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scn]
[--scp]
[--secondary-key]
[--webhook-url]
Contoh
Buat grup pendaftaran '{enrollment_id}' di layanan provisi Azure IoT '{dps_name}' di grup sumber daya '{resource_group_name} menggunakan sertifikat perantara sebagai sertifikat utama'.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem
Buat grup pendaftaran '{enrollment_id}' di layanan provisi Azure IoT '{dps_name}' di grup sumber daya '{resource_group_name} menggunakan sertifikat CA {certificate_name} sebagai sertifikat sekunder'.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name}
Buat grup pendaftaran '{enrollment_id}' di layanan provisi Azure IoT 'MyDps' di grup sumber daya '{resource_group_name}' dengan status provisi 'diaktifkan', properti kembar awal '{"location":{"region":"US"}}' dan tag kembar awal '{"version_dps":"1"}' menggunakan sertifikat perantara sebagai sertifikat utama.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem --provisioning-status enabled --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version_dps':'1'}"
Buat grup pendaftaran '{enrollment_id}' di layanan provisi Azure IoT '{dps_name}' di grup sumber daya '{resource_group_name} dengan tipe pengesahan 'simetris'.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {primary_key} --secondary-key {secondary_key}
Buat grup pendaftaran '{enrollment_id}' dengan kebijakan alokasi kustom,
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy custom --webhook-url {webhook_url} --api-version {api_version}
Parameter yang Diperlukan
ID grup pendaftaran.
Parameter Opsional
Jenis kebijakan alokasi untuk menentukan bagaimana perangkat ditetapkan ke IoT Hub. Jika tidak disediakan, kebijakan alokasi akan menjadi default kebijakan alokasi saat ini yang ditetapkan untuk instans Device Provisioning Service.
Versi API dari jenis layanan provisi yang dikirim dalam permintaan alokasi kustom. Versi minimum yang didukung: Pratinjau 2018-09-01.
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 iotdps-data-auth-type=<auth-type-value>
.
Nama sertifikat OS akar utama. Jika pengesahan dengan sertifikat OS akar diinginkan, maka nama ca akar harus disediakan.
Jalur ke file yang berisi sertifikat utama. Jika pengesahan dengan sertifikat perantara diinginkan, jalur sertifikat harus disediakan.
Nama atau nama host Azure IoT Hub Device Provisioning Service. Diperlukan jika --login tidak disediakan.
Bendera yang menunjukkan pengaktifan tepi.
Nama host IoT Hub target yang terkait dengan kebijakan alokasi. Gunakan daftar yang dipisahkan spasi untuk beberapa IoT Hub.
Properti kembar perangkat awal.
Tag kembar perangkat awal.
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.
Kunci akses bersama simetris utama yang disimpan dalam format base64.
Mengaktifkan atau menonaktifkan entri pendaftaran.
Kebijakan untuk menentukan bagaimana data perangkat harus ditangani pada provisi ulang ke IoT Hub yang berbeda.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama sertifikat OS akar sekunder. Jika pengesahan dengan sertifikat OS akar diinginkan, maka nama ca akar harus disediakan.
Jalur ke file yang berisi sertifikat sekunder. Jika pengesahan dengan sertifikat perantara diinginkan, jalur sertifikat harus disediakan.
Kunci akses bersama simetris sekunder yang disimpan dalam format base64.
URL webhook Azure Function yang digunakan untuk permintaan alokasi kustom.
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.
az iot dps enrollment-group delete
Menghapus grup pendaftaran di Azure IoT Hub Device Provisioning Service.
az iot dps enrollment-group delete --eid
[--auth-type {key, login}]
[--dps-name]
[--etag]
[--login]
[--resource-group]
Parameter yang Diperlukan
ID grup pendaftaran.
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 iotdps-data-auth-type=<auth-type-value>
.
Nama atau nama host Azure IoT Hub Device Provisioning Service. Diperlukan jika --login tidak disediakan.
Tag Etag atau entitas yang sesuai dengan status terakhir sumber daya. Jika tidak ada etag yang disediakan, nilai '*' digunakan.
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.
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.
az iot dps enrollment-group list
Mencantumkan grup pendaftaran di Azure IoT Hub Device Provisioning Service.
az iot dps enrollment-group list [--auth-type {key, login}]
[--dps-name]
[--login]
[--resource-group]
[--top]
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 iotdps-data-auth-type=<auth-type-value>
.
Nama atau nama host Azure IoT Hub Device Provisioning Service. Diperlukan jika --login tidak disediakan.
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.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Jumlah maksimum elemen yang akan dikembalikan. Gunakan -1 untuk tidak terbatas.
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.
az iot dps enrollment-group show
Dapatkan detail grup pendaftaran di Azure IoT Hub Device Provisioning Service.
az iot dps enrollment-group show --eid
[--auth-type {key, login}]
[--dps-name]
[--keys {false, true}]
[--login]
[--resource-group]
Contoh
Penggunaan dasar
az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {enrollment_id}
Sertakan informasi pengesahan lengkap dalam hasil untuk grup pendaftaran kunci konten
az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {symmetric_key_enrollment_id} --show-keys
Parameter yang Diperlukan
ID grup pendaftaran.
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 iotdps-data-auth-type=<auth-type-value>
.
Nama atau nama host Azure IoT Hub Device Provisioning Service. Diperlukan jika --login tidak disediakan.
Sertakan kunci pengesahan dan informasi dalam hasil grup pendaftaran.
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.
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.
az iot dps enrollment-group update
Perbarui grup pendaftaran di Azure IoT Hub Device Provisioning Service.
Harap sediakan format sertifikat menggunakan pengodean Base64 ASCII dan sertifikat harus memiliki segmen BEGIN dan END yang cocok, misalnya: mulailah dengan '-----BEGIN CERTIFICATE-----' dan berakhir dengan '-----END CERTIFICATE-----'.
az iot dps enrollment-group update --eid
[--allocation-policy {custom, geoLatency, hashed, static}]
[--api-version]
[--auth-type {key, login}]
[--ca-name]
[--certificate-path]
[--dps-name]
[--edge-enabled {false, true}]
[--etag]
[--ih]
[--initial-twin-properties]
[--initial-twin-tags]
[--login]
[--pk]
[--provisioning-status {disabled, enabled}]
[--rc {false, true}]
[--remove-secondary-certificate {false, true}]
[--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scn]
[--scp]
[--secondary-key]
[--webhook-url]
Contoh
Perbarui grup pendaftaran '{enrollment_id}' di layanan provisi Azure IoT '{dps_name}' di grup sumber daya '{resource_group_name}' dengan properti kembar awal dan tag kembar awal.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --initial-twin-properties "{'location':{'region':'USA'}}" --initial-twin-tags "{'version_dps':'2'}" --etag AAAAAAAAAAA=
Perbarui grup pendaftaran '{enrollment_id}' di layanan provisi Azure IoT '{dps_name}' di grup sumber daya '{resource_group_name}' dengan sertifikat perantara utama baru dan hapus sertifikat perantara sekunder yang ada.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/NewCertificate.pem --remove-secondary-certificate --etag AAAAAAAAAAA=
Perbarui grup pendaftaran '{enrollment_id}' di layanan provisi Azure IoT '{dps_name}' di grup sumber daya '{resource_group_name}' dengan sertifikat CA sekunder baru '{certificate_name}' dan hapus sertifikat CA utama yang ada.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name} --remove-certificate --etag AAAAAAAAAAA=
Perbarui grup pendaftaran '{enrollment_id}' di layanan provisi Azure IoT '{dps_name}' di grup sumber daya '{resource_group_name}' dengan kunci utama baru.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {new_primary_key} --etag AAAAAAAAAAA=
Parameter yang Diperlukan
ID grup pendaftaran.
Parameter Opsional
Jenis kebijakan alokasi untuk menentukan bagaimana perangkat ditetapkan ke IoT Hub. Jika tidak disediakan, kebijakan alokasi akan menjadi default kebijakan alokasi saat ini yang ditetapkan untuk instans Device Provisioning Service.
Versi API dari jenis layanan provisi yang dikirim dalam permintaan alokasi kustom. Versi minimum yang didukung: Pratinjau 2018-09-01.
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 iotdps-data-auth-type=<auth-type-value>
.
Nama sertifikat OS akar utama. Jika pengesahan dengan sertifikat OS akar diinginkan, maka nama ca akar harus disediakan.
Jalur ke file yang berisi sertifikat utama. Jika pengesahan dengan sertifikat perantara diinginkan, jalur sertifikat harus disediakan.
Nama atau nama host Azure IoT Hub Device Provisioning Service. Diperlukan jika --login tidak disediakan.
Bendera yang menunjukkan pengaktifan tepi.
Tag Etag atau entitas yang sesuai dengan status terakhir sumber daya. Jika tidak ada etag yang disediakan, nilai '*' digunakan.
Nama host IoT Hub target yang terkait dengan kebijakan alokasi. Gunakan daftar yang dipisahkan spasi untuk beberapa IoT Hub.
Properti kembar perangkat awal.
Tag kembar perangkat awal.
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.
Kunci akses bersama simetris utama yang disimpan dalam format base64.
Mengaktifkan atau menonaktifkan entri pendaftaran.
Bendera untuk menghapus sertifikat utama saat ini.
Bendera untuk menghapus sertifikat sekunder saat ini.
Kebijakan untuk menentukan bagaimana data perangkat harus ditangani pada provisi ulang ke IoT Hub yang berbeda.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama sertifikat OS akar sekunder. Jika pengesahan dengan sertifikat OS akar diinginkan, maka nama ca akar harus disediakan.
Jalur ke file yang berisi sertifikat sekunder. Jika pengesahan dengan sertifikat perantara diinginkan, jalur sertifikat harus disediakan.
Kunci akses bersama simetris sekunder yang disimpan dalam format base64.
URL webhook Azure Function yang digunakan untuk permintaan alokasi kustom.
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.