az iot hub device-identity
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 hub device-identity . Pelajari lebih lanjut tentang ekstensi.
Mengelola perangkat IoT.
Perintah
Nama | Deskripsi | Jenis | Status |
---|---|---|---|
az iot hub device-identity children |
Mengelola hubungan perangkat anak-anak untuk perangkat edge IoT. |
Ekstensi | GA |
az iot hub device-identity children add |
Tambahkan perangkat sebagai turunan ke perangkat edge target. |
Ekstensi | GA |
az iot hub device-identity children list |
Menghasilkan kumpulan perangkat anak yang ditetapkan. |
Ekstensi | GA |
az iot hub device-identity children remove |
Hapus perangkat anak dari perangkat edge target. |
Ekstensi | GA |
az iot hub device-identity connection-string |
Mengelola string koneksi perangkat IoT. |
Ekstensi | GA |
az iot hub device-identity connection-string show |
Tampilkan string koneksi perangkat IoT Hub tertentu. |
Ekstensi | GA |
az iot hub device-identity create |
Membuat perangkat di IoT Hub. |
Ekstensi | GA |
az iot hub device-identity delete |
Menghapus perangkat IoT Hub. |
Ekstensi | GA |
az iot hub device-identity export |
Ekspor semua identitas perangkat dari IoT Hub ke kontainer blob Azure Storage. |
Ekstensi | GA |
az iot hub device-identity import |
Impor identitas perangkat ke IoT Hub dari blob kontainer penyimpanan. |
Ekstensi | GA |
az iot hub device-identity list |
Mencantumkan perangkat di IoT Hub. |
Ekstensi | GA |
az iot hub device-identity parent |
Mengelola hubungan perangkat induk untuk perangkat IoT. |
Ekstensi | GA |
az iot hub device-identity parent set |
Atur perangkat induk perangkat target. |
Ekstensi | GA |
az iot hub device-identity parent show |
Dapatkan perangkat induk perangkat target. |
Ekstensi | GA |
az iot hub device-identity renew-key |
Memperbarui kunci target perangkat IoT Hub dengan autentikasi sas. |
Ekstensi | GA |
az iot hub device-identity show |
Dapatkan detail perangkat IoT Hub. |
Ekstensi | GA |
az iot hub device-identity update |
Memperbarui perangkat IoT Hub. |
Ekstensi | GA |
az iot hub device-identity create
Membuat perangkat di IoT Hub.
Saat menggunakan metode autentikasi shared_private_key (juga dikenal sebagai kunci konten), jika tidak ada kunci kustom yang disediakan, layanan akan menghasilkannya untuk perangkat.
Jika cakupan perangkat disediakan untuk perangkat edge, nilai akan secara otomatis dikonversi ke cakupan induk.
az iot hub device-identity create --device-id
[--am {shared_private_key, x509_ca, x509_thumbprint}]
[--auth-type {key, login}]
[--device-scope]
[--edge-enabled {false, true}]
[--hub-name]
[--login]
[--od]
[--pk]
[--primary-thumbprint]
[--resource-group]
[--secondary-key]
[--secondary-thumbprint]
[--sta {disabled, enabled}]
[--star]
[--valid-days]
Contoh
Buat perangkat IoT berkemampuan edge dengan otorisasi default (kunci privat bersama).
az iot hub device-identity create -n {iothub_name} -d {device_id} --ee
Buat perangkat IoT dengan otorisasi sertifikat yang ditandatangani sendiri, hasilkan sertifikasi yang berlaku selama 10 hari lalu gunakan thumbprint-nya.
az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --valid-days 10
Buat perangkat IoT dengan otorisasi sertifikat yang ditandatangani sendiri, hasilkan sertifikasi kedaluwarsa default (365 hari) dan output ke direktori target.
az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --output-dir /path/to/output
Buat perangkat IoT dengan otorisasi sertifikat yang ditandatangani sendiri dan secara eksplisit menyediakan thumbprint primer dan sekunder.
az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --ptp {thumbprint_1} --stp {thumbprint_2}
Buat perangkat IoT dengan otorisasi OS akar dengan status dan alasan yang dinonaktifkan.
az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_ca --status disabled --status-reason 'for reasons'
Buat perangkat IoT dengan cakupan perangkat.
az iot hub device-identity create -n {iothub_name} -d {device_id} --device-scope 'ms-azure-iot-edge://edge0-123456789123456789'
Parameter yang Diperlukan
Id Perangkat Target.
Parameter Opsional
Metode otorisasi yang akan dibuat entitas.
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>
.
Cakupan perangkat. Untuk perangkat edge, ini dibuat secara otomatis dan tidak dapat diubah. Untuk perangkat daun, atur ini untuk membuat hubungan turunan/induk.
Bendera yang menunjukkan pengaktifan tepi.
Nama IoT Hub atau nama host. 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 --hub-name tidak disediakan.
Buat sertifikasi yang ditandatangani sendiri dan gunakan thumbprint-nya. Output ke direktori target yang ditentukan.
Kunci akses bersama simetris utama yang disimpan dalam format base64.
Thumbprint sertifikat yang ditandatangani sendiri untuk digunakan untuk thumbprint utama.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Kunci akses bersama simetris sekunder yang disimpan dalam format base64.
Thumbprint sertifikat yang ditandatangani sendiri untuk digunakan untuk thumbprint sekunder.
Atur status perangkat saat pembuatan.
Deskripsi untuk status perangkat.
Buat sertifikasi yang ditandatangani sendiri dan gunakan thumbprint-nya. Berlaku untuk jumlah hari yang ditentukan. Default: 365.
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 hub device-identity delete
Menghapus perangkat IoT Hub.
az iot hub device-identity delete --device-id
[--auth-type {key, login}]
[--etag]
[--hub-name]
[--login]
[--resource-group]
Parameter yang Diperlukan
Id Perangkat Target.
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>
.
Tag Etag atau entitas yang sesuai dengan status terakhir sumber daya. Jika tidak ada etag yang disediakan, nilai '*' digunakan.
Nama IoT Hub atau nama host. 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 --hub-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 hub device-identity export
Ekspor semua identitas perangkat dari IoT Hub ke kontainer blob Azure Storage.
Blob output yang berisi identitas perangkat adalah file teks bernama 'devices.txt'.
Izin yang diperlukan - Baik kebijakan akses bersama IoT Hub yang mendukung 'Baca Registri & Tulis Registri' ATAU prinsipal dengan peran 'Kontributor Data IoT Hub' di IoT Hub.
Nama akun penyimpanan dan parameter nama kontainer blob hanya dapat digunakan ketika akun penyimpanan berada dalam langganan yang sama dengan IoT Hub input. Untuk input uri SAS kontainer blob sebaris, harap tinjau aturan input lingkungan Anda.
Untuk informasi selengkapnya, lihat https://aka.ms/iothub-device-exportimport .
az iot hub device-identity export [--auth-type {key, login}]
[--bc]
[--bcu]
[--hub-name]
[--identity]
[--ik {false, true}]
[--login]
[--resource-group]
[--sa]
Contoh
Ekspor semua identitas perangkat ke kontainer blob yang dikonfigurasi dan sertakan kunci perangkat. Nama kontainer blob dan nama akun penyimpanan disediakan sebagai parameter untuk perintah .
az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name}
Ekspor semua identitas perangkat ke kontainer blob yang dikonfigurasi dan sertakan kunci perangkat. Menggunakan contoh uri SAS sebaris.
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'
Ekspor semua identitas perangkat ke kontainer blob yang dikonfigurasi menggunakan jalur file yang berisi uri SAS.
az iot hub device-identity export -n {iothub_name} --bcu {sas_uri_filepath}
Ekspor semua identitas perangkat ke kontainer blob yang dikonfigurasi dan sertakan kunci perangkat. Menggunakan identitas yang ditetapkan sistem yang memiliki peran Kontributor Data Blob Penyimpanan untuk akun penyimpanan. Nama kontainer blob dan nama akun penyimpanan disediakan sebagai parameter untuk perintah .
az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity [system]
Ekspor semua identitas perangkat ke kontainer blob yang dikonfigurasi dan sertakan kunci perangkat. Menggunakan identitas yang ditetapkan sistem yang memiliki peran Kontributor Data Blob Penyimpanan untuk akun penyimpanan. Uri kontainer blob tidak memerlukan token SAS blob.
az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity [system]
Ekspor semua identitas perangkat ke kontainer blob yang dikonfigurasi dan sertakan kunci perangkat. Menggunakan identitas terkelola yang ditetapkan pengguna yang memiliki peran Kontributor Data Blob Penyimpanan untuk akun penyimpanan. Nama kontainer blob dan nama akun penyimpanan disediakan sebagai parameter untuk perintah .
az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity {managed_identity_resource_id}
Ekspor semua identitas perangkat ke kontainer blob yang dikonfigurasi dan sertakan kunci perangkat. Menggunakan identitas terkelola yang ditetapkan pengguna yang memiliki peran Kontributor Data Blob Penyimpanan untuk akun penyimpanan. Uri kontainer blob tidak memerlukan token SAS blob.
az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity {managed_identity_resource_id}
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>
.
Kontainer blob ini digunakan untuk menghasilkan status pekerjaan impor identitas perangkat dan hasilnya. Parameter diabaikan ketika blob_container_uri disediakan. Akses tulis, baca, dan hapus diperlukan untuk kontainer blob ini.
URI Tanda Tangan Akses Bersama Blob dengan akses tulis, baca, dan hapus ke kontainer blob. Ini digunakan untuk menghasilkan status pekerjaan dan hasilnya. Catatan: saat menggunakan autentikasi berbasis identitas, URI https:// masih diperlukan - tetapi tidak ada token SAS yang diperlukan. Input untuk argumen ini bisa sebaris atau dari jalur file.
Nama IoT Hub atau nama host. Diperlukan jika --login tidak disediakan.
Jenis identitas terkelola untuk menentukan apakah identitas terkelola yang ditetapkan sistem atau identitas terkelola yang ditetapkan pengguna digunakan. Untuk identitas terkelola yang ditetapkan sistem, gunakan [sistem]. Untuk identitas terkelola yang ditetapkan pengguna, berikan id sumber daya identitas terkelola yang ditetapkan pengguna. Identitas ini memerlukan peran Kontributor Data Blob Penyimpanan untuk Akun Penyimpanan.
Jika diatur, kunci diekspor secara normal. Jika tidak, kunci diatur ke null dalam output ekspor.
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 --hub-name tidak disediakan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama akun Azure Storage yang berisi kontainer blob output. Parameter diabaikan ketika blob_container_uri disediakan. Akses tulis, baca, dan hapus diperlukan.
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 hub device-identity import
Impor identitas perangkat ke IoT Hub dari blob kontainer penyimpanan.
File input yang diharapkan yang berisi identitas perangkat harus diberi nama 'devices.txt'. File log output 'importErrors.log' kosong ketika impor berhasil dan berisi log kesalahan jika terjadi kegagalan impor.
Izin yang diperlukan - Baik kebijakan akses bersama IoT Hub yang mendukung 'Baca Registri & Tulis Registri' ATAU prinsipal dengan peran 'Kontributor Data IoT Hub' di IoT Hub.
Nama akun penyimpanan dan parameter nama kontainer blob hanya dapat digunakan ketika akun penyimpanan berada dalam langganan yang sama dengan IoT Hub input. Untuk input uri SAS kontainer blob sebaris, harap tinjau aturan input lingkungan Anda.
Untuk informasi selengkapnya, lihat https://aka.ms/iothub-device-exportimport .
az iot hub device-identity import [--auth-type {key, login}]
[--hub-name]
[--ibc]
[--ibcu]
[--identity]
[--input-storage-account]
[--login]
[--obc]
[--obcu]
[--osa]
[--resource-group]
Contoh
Impor semua identitas perangkat dari blob dengan menyediakan parameter perintah untuk kontainer blob input dan akun penyimpanan serta kontainer blob output dan akun penyimpanan.
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}
Impor semua identitas perangkat dari blob menggunakan uri SAS sebaris.
az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri}
Impor semua identitas perangkat dari blob menggunakan jalur file yang berisi SAS uri.
az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri_filepath} --obcu {output_sas_uri_filepath}
Impor semua identitas perangkat dari blob menggunakan identitas yang ditetapkan sistem yang memiliki peran Kontributor Data Blob Penyimpanan untuk kedua akun penyimpanan. Kontainer blob input dan akun penyimpanan serta kontainer blob output dan akun penyimpanan disediakan sebagai parameter untuk perintah
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]
Impor semua identitas perangkat dari blob menggunakan identitas yang ditetapkan sistem yang memiliki peran Kontributor Data Blob Penyimpanan untuk kedua akun penyimpanan. Uri kontainer blob tidak memerlukan token SAS blob.
az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity [system]
Impor semua identitas perangkat dari blob menggunakan identitas terkelola yang ditetapkan pengguna yang memiliki peran Kontributor Data Blob Penyimpanan untuk kedua akun penyimpanan. Kontainer blob input dan akun penyimpanan serta kontainer blob output dan akun penyimpanan disediakan sebagai parameter untuk perintah
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}
Impor semua identitas perangkat dari blob menggunakan identitas terkelola yang ditetapkan pengguna yang memiliki peran Kontributor Data Blob Penyimpanan untuk kedua akun penyimpanan. Uri kontainer blob tidak memerlukan token SAS blob.
az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity {managed_identity_resource_id}
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>
.
Nama IoT Hub atau nama host. Diperlukan jika --login tidak disediakan.
Kontainer blob ini menyimpan file yang menentukan operasi yang akan dilakukan pada registri identitas. Parameter diabaikan ketika input_blob_container_uri disediakan. Akses baca diperlukan untuk kontainer blob ini.
URI Tanda Tangan Akses Bersama Blob dengan akses baca ke kontainer blob. Blob ini berisi operasi yang akan dilakukan pada registri identitas. Catatan: saat menggunakan autentikasi berbasis identitas, URI https:// masih diperlukan - tetapi tidak ada token SAS yang diperlukan. Input untuk argumen ini bisa sebaris atau dari jalur file.
Jenis identitas terkelola untuk menentukan apakah identitas terkelola yang ditetapkan sistem atau identitas terkelola yang ditetapkan pengguna digunakan. Untuk identitas terkelola yang ditetapkan sistem, gunakan [sistem]. Untuk identitas terkelola yang ditetapkan pengguna, berikan id sumber daya identitas terkelola yang ditetapkan pengguna. Identitas ini memerlukan peran Kontributor Data Blob Penyimpanan untuk peran Akun Penyimpanan dan Kontributor target untuk IoT Hub.
Nama akun Azure Storage yang berisi kontainer blob input. Hanya diperlukan saat input_blob_container_uri tidak disediakan. Akses baca diperlukan.
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 --hub-name tidak disediakan.
Kontainer blob ini digunakan untuk menghasilkan status pekerjaan impor identitas perangkat dan hasilnya. Hanya diperlukan saat input_blob_container_uri tidak disediakan. Akses tulis diperlukan untuk kontainer blob ini.
URI Tanda Tangan Akses Bersama Blob dengan akses tulis ke kontainer blob. Ini digunakan untuk menghasilkan status pekerjaan dan hasilnya. Catatan: saat menggunakan autentikasi berbasis Identitas, URI https:// tanpa token SAS masih diperlukan. Input untuk argumen ini bisa sebaris atau dari jalur file.
Nama akun Azure Storage yang berisi kontainer blob output. Parameter diabaikan ketika output_blob_container_uri disediakan. Akses tulis diperlukan.
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 hub device-identity list
Mencantumkan perangkat di IoT Hub.
Perintah ini adalah alias untuk az iot hub device-twin list
, yang sangat direkomendasikan atas perintah ini. Di masa mendatang, perintah ini az iot hub device-identity list
dapat diubah atau tidak digunakan lagi.
az iot hub device-identity list [--auth-type {key, login}]
[--edge-enabled {false, true}]
[--hub-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 iothub-data-auth-type=<auth-type-value>
.
Bendera yang menunjukkan pengaktifan tepi.
Nama IoT Hub atau nama host. 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 --hub-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 hub device-identity renew-key
Memperbarui kunci target perangkat IoT Hub dengan autentikasi sas.
az iot hub device-identity renew-key --device-id
--hub-name
--key-type {primary, secondary, swap}
[--auth-type {key, login}]
[--etag]
[--login]
[--resource-group]
Contoh
Perbarui kunci primer.
az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt primary
Tukar kunci primer dan sekunder.
az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt swap
Parameter yang Diperlukan
Id Perangkat Target.
Nama IoT Hub atau nama host. Diperlukan jika --login tidak disediakan.
Jenis kunci target untuk diregenerasi.
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>
.
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 --hub-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 hub device-identity show
Dapatkan detail perangkat IoT Hub.
az iot hub device-identity show --device-id
[--auth-type {key, login}]
[--hub-name]
[--login]
[--resource-group]
Parameter yang Diperlukan
Id Perangkat Target.
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>
.
Nama IoT Hub atau nama host. 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 --hub-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 hub device-identity update
Memperbarui perangkat IoT Hub.
Gunakan --set diikuti oleh penetapan properti untuk memperbarui perangkat. Manfaatkan parameter yang dikembalikan dari 'iot hub device-identity show'.
az iot hub device-identity update --device-id
[--add]
[--am {shared_private_key, x509_ca, x509_thumbprint}]
[--auth-type {key, login}]
[--edge-enabled {false, true}]
[--etag]
[--force-string]
[--hub-name]
[--login]
[--pk]
[--primary-thumbprint]
[--remove]
[--resource-group]
[--secondary-key]
[--secondary-thumbprint]
[--set]
[--sta {disabled, enabled}]
[--star]
Contoh
Mengaktifkan kemampuan edge untuk perangkat
az iot hub device-identity update -d {device_id} -n {iothub_name} --set capabilities.iotEdge=true
Aktifkan kemampuan edge untuk perangkat menggunakan argumen kenyamanan.
az iot hub device-identity update -d {device_id} -n {iothub_name} --ee
Menonaktifkan status perangkat
az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled
Nonaktifkan status perangkat menggunakan argumen kenyamanan.
az iot hub device-identity update -d {device_id} -n {iothub_name} --status disabled
Dalam satu perintah
az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled capabilities.iotEdge=true
Parameter yang Diperlukan
Id Perangkat Target.
Parameter Opsional
Tambahkan objek ke daftar objek dengan menentukan jalur dan pasangan nilai kunci. Contoh: --add property.listProperty <key=value, string or JSON string>
.
Metode otorisasi yang akan dibuat entitas.
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>
.
Bendera yang menunjukkan pengaktifan tepi.
Tag Etag atau entitas yang sesuai dengan status terakhir sumber daya. Jika tidak ada etag yang disediakan, nilai '*' digunakan.
Saat menggunakan 'set' atau 'add', pertahankan literal string alih-alih mencoba mengonversi ke JSON.
Nama IoT Hub atau nama host. 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 --hub-name tidak disediakan.
Kunci akses bersama simetris utama yang disimpan dalam format base64.
Thumbprint sertifikat yang ditandatangani sendiri untuk digunakan untuk thumbprint utama.
Menghapus properti atau elemen dari daftar. Contoh: --remove property.list <indexToRemove>
ATAU --remove propertyToRemove
.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Kunci akses bersama simetris sekunder yang disimpan dalam format base64.
Thumbprint sertifikat yang ditandatangani sendiri untuk digunakan untuk thumbprint sekunder.
Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=<value>
.
Atur status perangkat saat pembuatan.
Deskripsi untuk status perangkat.
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.