az iot hub message-endpoint update

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 az iot hub message-endpoint update . Pelajari lebih lanjut tentang ekstensi.

Grup perintah 'iot hub message-endpoint' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Perbarui properti titik akhir yang ada untuk IoT Hub.

Perintah

Nama Deskripsi Jenis Status
az iot hub message-endpoint update cosmosdb-container

Perbarui properti titik akhir Kontainer Cosmos DB yang ada untuk IoT Hub.

Ekstensi Pratinjau
az iot hub message-endpoint update eventhub

Perbarui properti titik akhir Pusat Aktivitas yang ada untuk IoT Hub.

Ekstensi Pratinjau
az iot hub message-endpoint update servicebus-queue

Perbarui properti titik akhir antrean Bus Layanan yang ada untuk IoT Hub.

Ekstensi Pratinjau
az iot hub message-endpoint update servicebus-topic

Perbarui properti titik akhir Topik Bus Layanan yang sudah ada untuk IoT Hub.

Ekstensi Pratinjau
az iot hub message-endpoint update storage-container

Perbarui properti titik akhir Kontainer Penyimpanan yang ada untuk IoT Hub.

Ekstensi Pratinjau

az iot hub message-endpoint update cosmosdb-container

Pratinjau

Grup perintah 'iot hub message-endpoint' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Perbarui properti titik akhir Kontainer Cosmos DB yang ada untuk IoT Hub.

Jika memperbarui jenis autentikasi dari titik akhir Kontainer Cosmos DB berbasis kunci ke berbasis identitas, Anda harus memberikan identitas (melalui --identity) dan uri titik akhir (melalui --endpoint-uri). Kunci primer lama dan kunci sekunder akan nulled out.

Jika memperbarui jenis autentikasi dari titik akhir Kontainer Cosmos DB berbasis identitas ke berbasis kunci, Anda harus menyediakan string koneksi (melalui --connection-string), kunci primer (melalui --primary-key) atau kunci sekunder (melalui --secondary-key).

Nama kontainer untuk titik akhir tidak dapat diubah. Nama akun hanya dapat diubah jika kontainer dengan nama yang sama ada di kedua akun.

az iot hub message-endpoint update cosmosdb-container --en
                                                      --hub-name
                                                      [--connection-string]
                                                      [--database-name]
                                                      [--endpoint-resource-group]
                                                      [--endpoint-subscription-id]
                                                      [--endpoint-uri]
                                                      [--identity]
                                                      [--partition-key-name]
                                                      [--partition-key-template]
                                                      [--pk]
                                                      [--resource-group]
                                                      [--secondary-key]

Contoh

Perbarui titik akhir Kontainer Cosmos DB berbasis kunci atau berbasis identitas untuk IoT Hub untuk menggunakan string koneksi baru yang ditentukan.

az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --connection-string {connection_string}

Perbarui titik akhir Kontainer Cosmos DB untuk IoT Hub untuk menggunakan kunci primer dan kunci sekunder tertentu.

az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --pk {primary_key} --sk {secondary_key}

Perbarui titik akhir Kontainer Cosmos DB untuk IoT Hub untuk menggunakan identitas yang ditetapkan sistem dan nama kunci partisi. Templat kunci partisi akan menjadi default.

az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --pkn {partition_key_name} --identity [system]

Perbarui titik akhir Kontainer Cosmos DB berbasis kunci untuk IoT Hub untuk menggunakan identitas yang ditetapkan pengguna (Anda dapat menghilangkan --endpoint-uri jika titik akhir sudah berbasis identitas).

az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri}

Parameter yang Diperlukan

--en --endpoint --endpoint-name

Nama titik akhir perutean.

--hub-name -n

Nama IoT Hub.

Parameter Opsional

--connection-string -c

Koneksi string titik akhir perutean.

--database-name --db

Nama database cosmos DB di akun cosmos DB.

--endpoint-resource-group --erg -r

Grup sumber daya resoure Titik akhir. Jika tidak disediakan, grup sumber daya IoT Hub akan digunakan.

--endpoint-subscription-id -s

Id Langganan sumber daya Titik Akhir. Jika tidak disediakan, langganan IoT Hub akan digunakan.

--endpoint-uri

Uri sumber daya titik akhir.

--identity

Gunakan identitas terkelola yang ditetapkan sistem atau ditetapkan pengguna untuk autentikasi titik akhir. Gunakan "[system]" untuk merujuk ke identitas yang ditetapkan sistem atau ID sumber daya untuk merujuk ke identitas yang ditetapkan pengguna.

--partition-key-name --pkn

Nama kunci partisi yang terkait dengan Kontainer SQL Cosmos DB ini jika ada. Untuk menghapus properti ini, atur ini ke "".

--partition-key-template --pkt

Templat untuk menghasilkan nilai kunci partisi sintetis untuk digunakan dengan Kontainer SQL Cosmos DB ini. Templat harus menyertakan setidaknya salah satu tempat penampung berikut: {iothub}, {deviceid}, {DD}, {MM}, dan {YYYY}. Setiap tempat penampung dapat ditentukan paling banyak sekali, tetapi komponen pesanan dan non-tempat penampung bersifat arbitrer. Jika nama kunci partisi disediakan, templat kunci partisi default ke {deviceid}-{YYYY}-{MM}. Untuk menghapus properti ini, atur ini ke "".

--pk --primary-key

Kunci utama akun cosmos DB.

--resource-group -g

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

--secondary-key --sk

Kunci sekunder akun cosmos DB.

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.

az iot hub message-endpoint update eventhub

Pratinjau

Grup perintah 'iot hub message-endpoint' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Perbarui properti titik akhir Pusat Aktivitas yang ada untuk IoT Hub.

Jika memperbarui jenis autentikasi dari titik akhir Event Hub berbasis kunci ke berbasis identitas, Anda harus memberikan identitas (melalui --identity), uri titik akhir (melalui --endpoint-uri) dan jalur entitas (melalui --entity-path). String koneksi lama akan nulled out.

Jika memperbarui jenis autentikasi dari titik akhir Event Hub berbasis identitas ke berbasis kunci, Anda harus menyediakan string koneksi (melalui --connection-string). Uri titik akhir lama dan jalur entitas akan nulled out.

az iot hub message-endpoint update eventhub --en
                                            --hub-name
                                            [--connection-string]
                                            [--endpoint-resource-group]
                                            [--endpoint-subscription-id]
                                            [--endpoint-uri]
                                            [--entity-path]
                                            [--identity]
                                            [--resource-group]

Contoh

Perbarui titik akhir Pusat Aktivitas berbasis kunci atau identitas untuk IoT Hub untuk menggunakan string koneksi baru yang ditentukan.

az iot hub message-endpoint update eventhub -n {iothub_name} --en {endpoint_name} -c {connection_string}

Perbarui titik akhir Pusat Aktivitas untuk IoT Hub untuk menggunakan identitas yang ditetapkan sistem dan jalur entitas yang berbeda.

az iot hub message-endpoint update eventhub -n {iothub_name} --en {endpoint_name} --entity-path {entity_path} --identity [system]

Perbarui titik akhir Event Hub berbasis kunci untuk IoT Hub untuk menggunakan identitas yang ditetapkan pengguna (Anda dapat menghilangkan --endpoint-uri jika titik akhir sudah berbasis identitas).

az iot hub message-endpoint update eventhub -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri} --entity-path {entity_path}

Parameter yang Diperlukan

--en --endpoint --endpoint-name

Nama titik akhir perutean.

--hub-name -n

Nama IoT Hub.

Parameter Opsional

--connection-string -c

Koneksi string titik akhir perutean.

--endpoint-resource-group --erg -r

Grup sumber daya resoure Titik akhir. Jika tidak disediakan, grup sumber daya IoT Hub akan digunakan.

--endpoint-subscription-id -s

Id Langganan sumber daya Titik Akhir. Jika tidak disediakan, langganan IoT Hub akan digunakan.

--endpoint-uri

Uri sumber daya titik akhir.

--entity-path

Jalur entitas sumber daya titik akhir.

--identity

Gunakan identitas terkelola yang ditetapkan sistem atau ditetapkan pengguna untuk autentikasi titik akhir. Gunakan "[system]" untuk merujuk ke identitas yang ditetapkan sistem atau ID sumber daya untuk merujuk ke identitas yang ditetapkan pengguna.

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

az iot hub message-endpoint update servicebus-queue

Pratinjau

Grup perintah 'iot hub message-endpoint' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Perbarui properti titik akhir antrean Bus Layanan yang ada untuk IoT Hub.

Jika memperbarui jenis autentikasi dari titik akhir antrean Bus Layanan berbasis kunci ke berbasis identitas, Anda harus memberikan identitas (melalui --identity), uri titik akhir (melalui --endpoint-uri) dan jalur entitas (melalui --entity-path). String koneksi lama akan nulled out.

Jika memperbarui jenis autentikasi dari titik akhir antrean Bus Layanan berbasis identitas ke berbasis kunci, Anda harus menyediakan string koneksi (melalui --connection-string). Uri titik akhir lama dan jalur entitas akan nulled out.

az iot hub message-endpoint update servicebus-queue --en
                                                    --hub-name
                                                    [--connection-string]
                                                    [--endpoint-resource-group]
                                                    [--endpoint-subscription-id]
                                                    [--endpoint-uri]
                                                    [--entity-path]
                                                    [--identity]
                                                    [--resource-group]

Contoh

Perbarui titik akhir antrean Bus Layanan berbasis kunci atau berbasis identitas untuk IoT Hub untuk menggunakan string koneksi baru yang ditentukan.

az iot hub message-endpoint update servicebus-queue -n {iothub_name} --en {endpoint_name} -c {connection_string}

Perbarui titik akhir antrean Bus Layanan untuk IoT Hub untuk menggunakan identitas yang ditetapkan sistem dan jalur entitas yang berbeda.

az iot hub message-endpoint update servicebus-queue -n {iothub_name} --en {endpoint_name} --entity-path {entity_path} --identity [system]

Perbarui titik akhir antrean Bus Layanan berbasis kunci untuk IoT Hub untuk menggunakan identitas yang ditetapkan pengguna (Anda dapat menghilangkan --endpoint-uri jika titik akhir sudah berbasis identitas).

az iot hub message-endpoint update servicebus-queue -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri} --entity-path {entity_path}

Parameter yang Diperlukan

--en --endpoint --endpoint-name

Nama titik akhir perutean.

--hub-name -n

Nama IoT Hub.

Parameter Opsional

--connection-string -c

Koneksi string titik akhir perutean.

--endpoint-resource-group --erg -r

Grup sumber daya resoure Titik akhir. Jika tidak disediakan, grup sumber daya IoT Hub akan digunakan.

--endpoint-subscription-id -s

Id Langganan sumber daya Titik Akhir. Jika tidak disediakan, langganan IoT Hub akan digunakan.

--endpoint-uri

Uri sumber daya titik akhir.

--entity-path

Jalur entitas sumber daya titik akhir.

--identity

Gunakan identitas terkelola yang ditetapkan sistem atau ditetapkan pengguna untuk autentikasi titik akhir. Gunakan "[system]" untuk merujuk ke identitas yang ditetapkan sistem atau ID sumber daya untuk merujuk ke identitas yang ditetapkan pengguna.

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

az iot hub message-endpoint update servicebus-topic

Pratinjau

Grup perintah 'iot hub message-endpoint' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Perbarui properti titik akhir Topik Bus Layanan yang sudah ada untuk IoT Hub.

Jika memperbarui jenis autentikasi dari titik akhir topik Bus Layanan berbasis kunci ke berbasis identitas, Anda harus memberikan identitas (melalui --identity), uri titik akhir (melalui --endpoint-uri) dan jalur entitas (melalui --entity-path). String koneksi lama akan nulled out.

Jika memperbarui jenis autentikasi dari titik akhir topik Bus Layanan berbasis identitas ke berbasis kunci, Anda harus menyediakan string koneksi (melalui --connection-string). Uri titik akhir lama dan jalur entitas akan nulled out.

az iot hub message-endpoint update servicebus-topic --en
                                                    --hub-name
                                                    [--connection-string]
                                                    [--endpoint-resource-group]
                                                    [--endpoint-subscription-id]
                                                    [--endpoint-uri]
                                                    [--entity-path]
                                                    [--identity]
                                                    [--resource-group]

Contoh

Perbarui titik akhir Topik Bus Layanan berbasis kunci atau berbasis identitas untuk IoT Hub untuk menggunakan string koneksi baru yang ditentukan.

az iot hub message-endpoint update servicebus-topic -n {iothub_name} --en {endpoint_name} -c {connection_string}

Perbarui titik akhir Topik Bus Layanan untuk IoT Hub untuk menggunakan identitas yang ditetapkan sistem dan jalur entitas yang berbeda.

az iot hub message-endpoint update servicebus-topic -n {iothub_name} --en {endpoint_name} --entity-path {entity_path} --identity [system]

Perbarui titik akhir Topik Bus Layanan berbasis kunci untuk IoT Hub untuk menggunakan identitas yang ditetapkan pengguna (Anda dapat menghilangkan --endpoint-uri jika titik akhir sudah berbasis identitas).

az iot hub message-endpoint update servicebus-topic -n {iothub_name} --en {endpoint_name}  --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri} --entity-path {entity_path}

Parameter yang Diperlukan

--en --endpoint --endpoint-name

Nama titik akhir perutean.

--hub-name -n

Nama IoT Hub.

Parameter Opsional

--connection-string -c

Koneksi string titik akhir perutean.

--endpoint-resource-group --erg -r

Grup sumber daya resoure Titik akhir. Jika tidak disediakan, grup sumber daya IoT Hub akan digunakan.

--endpoint-subscription-id -s

Id Langganan sumber daya Titik Akhir. Jika tidak disediakan, langganan IoT Hub akan digunakan.

--endpoint-uri

Uri sumber daya titik akhir.

--entity-path

Jalur entitas sumber daya titik akhir.

--identity

Gunakan identitas terkelola yang ditetapkan sistem atau ditetapkan pengguna untuk autentikasi titik akhir. Gunakan "[system]" untuk merujuk ke identitas yang ditetapkan sistem atau ID sumber daya untuk merujuk ke identitas yang ditetapkan pengguna.

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

az iot hub message-endpoint update storage-container

Pratinjau

Grup perintah 'iot hub message-endpoint' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Perbarui properti titik akhir Kontainer Penyimpanan yang ada untuk IoT Hub.

Jika memperbarui jenis autentikasi dari titik akhir Kontainer Penyimpanan berbasis kunci ke berbasis identitas, Anda harus memberikan identitas (melalui --identity) dan uri titik akhir (melalui --endpoint-uri). String koneksi lama akan nulled out.

Jika memperbarui jenis autentikasi dari titik akhir Kontainer Penyimpanan berbasis identitas ke berbasis kunci, Anda harus menyediakan string koneksi (melalui --connection-string).

Nama kontainer dan pengodean untuk titik akhir tidak dapat diubah. Nama akun hanya dapat diubah jika kontainer dengan nama yang sama ada di kedua akun.

az iot hub message-endpoint update storage-container --en
                                                     --hub-name
                                                     [--batch-frequency]
                                                     [--chunk-size]
                                                     [--connection-string]
                                                     [--endpoint-resource-group]
                                                     [--endpoint-subscription-id]
                                                     [--endpoint-uri]
                                                     [--ff]
                                                     [--identity]
                                                     [--resource-group]

Contoh

Perbarui titik akhir Kontainer Penyimpanan berbasis kunci atau berbasis identitas untuk IoT Hub untuk menggunakan string koneksi baru yang ditentukan.

az iot hub message-endpoint update storage-container -n {iothub_name} --en {endpoint_name} -c {connection_string}

Perbarui titik akhir Kontainer Penyimpanan untuk IoT Hub untuk menggunakan identitas yang ditetapkan sistem dengan frekuensi batch, ukuran gugus, dan format nama file yang diberikan.

az iot hub message-endpoint update storage-container -n {iothub_name} --en {endpoint_name}  -b {batch_frequency} -w {chunk_size} --ff {file_format} --identity [system]

Perbarui titik akhir Kontainer Penyimpanan berbasis kunci untuk IoT Hub untuk menggunakan identitas yang ditetapkan pengguna (Anda dapat menghilangkan --endpoint-uri jika titik akhir sudah berbasis identitas).

az iot hub message-endpoint update storage-container -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri}

Parameter yang Diperlukan

--en --endpoint --endpoint-name

Nama titik akhir perutean.

--hub-name -n

Nama IoT Hub.

Parameter Opsional

--batch-frequency -b

Minta frekuensi batch dalam detik. Jumlah waktu maksimum yang dapat berlalu sebelum data ditulis ke blob, antara 60 dan 720 detik.

--chunk-size -w

Meminta ukuran gugus dalam megabyte (MB). Ukuran maksimum blob, antara 10 dan 500 MB.

--connection-string -c

Koneksi string titik akhir perutean.

--endpoint-resource-group --erg -r

Grup sumber daya resoure Titik akhir. Jika tidak disediakan, grup sumber daya IoT Hub akan digunakan.

--endpoint-subscription-id -s

Id Langganan sumber daya Titik Akhir. Jika tidak disediakan, langganan IoT Hub akan digunakan.

--endpoint-uri

Uri sumber daya titik akhir.

--ff --file-name-format

Format nama file untuk blob. Format nama file harus berisi bidang {iothub}, {partition}, {YYYY}, {MM}, {DD}, {HH} dan {mm}. Semua parameter bersifat wajib tetapi dapat diurutkan ulang dengan atau tanpa pemisah.

--identity

Gunakan identitas terkelola yang ditetapkan sistem atau ditetapkan pengguna untuk autentikasi titik akhir. Gunakan "[system]" untuk merujuk ke identitas yang ditetapkan sistem atau ID sumber daya untuk merujuk ke identitas yang ditetapkan pengguna.

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