az iot hub message-endpoint update

  • Preview
  • Reference

Poznámka

Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.37.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az iot hub message-endpoint update . Přečtěte si další informace o rozšířeních.

Skupina příkazů iot Hub message-endpoint je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Aktualizujte vlastnosti existujícího koncového bodu pro IoT Hub.

Příkazy

Name Description Typ Stav
az iot hub message-endpoint update cosmosdb-container

Aktualizujte vlastnosti existujícího koncového bodu kontejneru Cosmos DB pro IoT Hub.

 Rozšíření Preview
az iot hub message-endpoint update eventhub

Aktualizujte vlastnosti existujícího koncového bodu centra událostí pro IoT Hub.

 Rozšíření Preview
az iot hub message-endpoint update servicebus-queue

Aktualizujte vlastnosti existujícího koncového bodu fronty služby Service Bus pro IoT Hub.

 Rozšíření Preview
az iot hub message-endpoint update servicebus-topic

Aktualizujte vlastnosti existujícího koncového bodu tématu služby Service Bus pro IoT Hub.

 Rozšíření Preview
az iot hub message-endpoint update storage-container

Aktualizujte vlastnosti existujícího koncového bodu kontejneru úložiště pro IoT Hub.

 Rozšíření Preview

az iot hub message-endpoint update cosmosdb-container

Preview

Skupina příkazů iot Hub message-endpoint je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Aktualizujte vlastnosti existujícího koncového bodu kontejneru Cosmos DB pro IoT Hub.

Pokud aktualizujete typ ověřování z klíče na koncový bod kontejneru Cosmos DB založený na klíči, musíte zadat identitu (prostřednictvím --identity) a identifikátor URI koncového bodu (přes --endpoint-uri). Starý primární klíč a sekundární klíč budou mít hodnotu null.

Pokud aktualizujete typ ověřování z koncového bodu kontejneru cosmos DB založeného na identitě na klíč, musíte zadat připojovací řetězec (prostřednictvím --connection-string), primárního klíče (prostřednictvím --primárního klíče) nebo sekundárního klíče (přes --secondary-key).

Název kontejneru pro koncový bod nelze změnit. Názvy účtů je možné změnit pouze v případě, že v obou účtech existují kontejnery se stejným názvem.

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]

Příklady

Aktualizujte koncový bod kontejneru Cosmos DB založený na klíči nebo identitě pro IoT Hub tak, aby používal nový zadaný připojovací řetězec.

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

Aktualizujte koncový bod kontejneru služby Cosmos DB pro Službu IoT Hub tak, aby používal zadaný primární klíč a sekundární klíč.

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

Aktualizujte koncový bod kontejneru cosmos DB pro IoT Hub tak, aby používal identitu přiřazenou systémem a název klíče oddílu. Šablona klíče oddílu bude výchozí.

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

Aktualizace koncového bodu kontejneru cosmos DB založeného na klíči pro Službu IoT Hub tak, aby používala identitu přiřazenou uživatelem (pokud je koncový bod už založený na identitě, můžete vynechat --endpoint-uri).

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

Povinné parametry

--en --endpoint --endpoint-name

Název koncového bodu směrování

--hub-name -n

Název ioT Hubu

Volitelné parametry

--connection-string -c

Připojení řetězec koncového bodu směrování.

--database-name --db

Název databáze cosmos DB v účtu cosmos DB.

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

Skupina prostředků resoure koncového bodu Pokud není k dispozici, použije se skupina prostředků ioT Hubu.

--endpoint-subscription-id -s

ID předplatného prostředku koncového bodu Pokud není k dispozici, použije se předplatné ioT Hubu.

--endpoint-uri

Identifikátor URI prostředku koncového bodu.

--identity

Pro ověřování koncových bodů použijte spravovanou identitu přiřazenou systémem nebo přiřazenou uživatelem. Pomocí [system] můžete odkazovat na identitu přiřazenou systémem nebo ID prostředku a odkazovat na identitu přiřazenou uživatelem.

--partition-key-name --pkn

Název klíče oddílu přidruženého k tomuto kontejneru SQL služby Cosmos DB, pokud existuje. Pokud chcete tuto vlastnost vymazat, nastavte ji na "".

--partition-key-template --pkt

Šablona pro generování hodnoty syntetického klíče oddílu pro použití s tímto kontejnerem SQL služby Cosmos DB. Šablona musí obsahovat alespoň jeden z následujících zástupných symbolů: {iothub}, {deviceid}, {DD}, {MM} a {YYYY}. Všechny zástupné symboly mohou být zadány najednou, ale pořadí a neschybné součásti jsou libovolné. Pokud je zadán název klíče oddílu, šablona klíče oddílu je ve výchozím nastavení {deviceid}-{YYYY}-{MM}. Pokud chcete tuto vlastnost vymazat, nastavte ji na "".

--pk --primary-key

Primární klíč účtu cosmos DB.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--secondary-key --sk

Sekundární klíč účtu cosmos DB.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot hub message-endpoint update eventhub

Preview

Skupina příkazů iot Hub message-endpoint je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Aktualizujte vlastnosti existujícího koncového bodu centra událostí pro IoT Hub.

Pokud aktualizujete typ ověřování z koncového bodu centra událostí založeného na klíči na koncový bod centra událostí založený na identitě, musíte zadat identitu (prostřednictvím --identity), identifikátor URI koncového bodu (prostřednictvím --endpoint-uri) a cestu entity (přes --entity-path). Starý připojovací řetězec bude mít hodnotu null.

Pokud aktualizujete typ ověřování z koncového bodu centra událostí založeného na identitě na koncový bod centra událostí založený na klíči, musíte zadat připojovací řetězec (přes --connection-string). Původní identifikátor URI koncového bodu a cesta entity budou null.

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]

Příklady

Aktualizace koncového bodu centra událostí založeného na klíči nebo identitě pro IoT Hub tak, aby používala nový zadaný připojovací řetězec.

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

Aktualizujte koncový bod centra událostí pro IoT Hub tak, aby používal identitu přiřazenou systémem a jinou cestu entity.

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

Aktualizace koncového bodu centra událostí založeného na klíči pro IoT Hub tak, aby používala identitu přiřazenou uživatelem (pokud je koncový bod už založený na identitě, můžete vynechat --endpoint-uri).

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}

Povinné parametry

--en --endpoint --endpoint-name

Název koncového bodu směrování

--hub-name -n

Název ioT Hubu

Volitelné parametry

--connection-string -c

Připojení řetězec koncového bodu směrování.

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

Skupina prostředků resoure koncového bodu Pokud není k dispozici, použije se skupina prostředků ioT Hubu.

--endpoint-subscription-id -s

ID předplatného prostředku koncového bodu Pokud není k dispozici, použije se předplatné ioT Hubu.

--endpoint-uri

Identifikátor URI prostředku koncového bodu.

--entity-path

Cesta entity prostředku koncového bodu.

--identity

Pro ověřování koncových bodů použijte spravovanou identitu přiřazenou systémem nebo přiřazenou uživatelem. Pomocí [system] můžete odkazovat na identitu přiřazenou systémem nebo ID prostředku a odkazovat na identitu přiřazenou uživatelem.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot hub message-endpoint update servicebus-queue

Preview

Skupina příkazů iot Hub message-endpoint je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Aktualizujte vlastnosti existujícího koncového bodu fronty služby Service Bus pro IoT Hub.

Pokud aktualizujete typ ověřování z klíče na koncový bod fronty service bus založené na identitě, musíte zadat identitu (prostřednictvím --identity), identifikátor URI koncového bodu (přes --endpoint-uri) a cestu entity (přes --entity-path). Starý připojovací řetězec bude mít hodnotu null.

Pokud aktualizujete typ ověřování z koncového bodu fronty služby Service Bus založeného na identitě na klíč, musíte zadat připojovací řetězec (prostřednictvím řetězce --connection-string). Původní identifikátor URI koncového bodu a cesta entity budou null.

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]

Příklady

Aktualizujte koncový bod fronty service bus založené na klíči nebo identitě pro IoT Hub tak, aby používal nový zadaný připojovací řetězec.

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

Aktualizujte koncový bod fronty služby Service Bus pro IoT Hub tak, aby používal identitu přiřazenou systémem a jinou cestu entity.

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

Aktualizace koncového bodu fronty service bus založeného na klíči pro IoT Hub tak, aby používala identitu přiřazenou uživatelem (pokud je koncový bod už založený na identitě, můžete vynechat --endpoint-uri).

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}

Povinné parametry

--en --endpoint --endpoint-name

Název koncového bodu směrování

--hub-name -n

Název ioT Hubu

Volitelné parametry

--connection-string -c

Připojení řetězec koncového bodu směrování.

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

Skupina prostředků resoure koncového bodu Pokud není k dispozici, použije se skupina prostředků ioT Hubu.

--endpoint-subscription-id -s

ID předplatného prostředku koncového bodu Pokud není k dispozici, použije se předplatné ioT Hubu.

--endpoint-uri

Identifikátor URI prostředku koncového bodu.

--entity-path

Cesta entity prostředku koncového bodu.

--identity

Pro ověřování koncových bodů použijte spravovanou identitu přiřazenou systémem nebo přiřazenou uživatelem. Pomocí [system] můžete odkazovat na identitu přiřazenou systémem nebo ID prostředku a odkazovat na identitu přiřazenou uživatelem.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot hub message-endpoint update servicebus-topic

Preview

Skupina příkazů iot Hub message-endpoint je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Aktualizujte vlastnosti existujícího koncového bodu tématu služby Service Bus pro IoT Hub.

Pokud aktualizujete typ ověřování z klíče na koncový bod tématu služby Service Bus založený na klíči, musíte zadat identitu (prostřednictvím --identity), identifikátor URI koncového bodu (přes --endpoint-uri) a cestu entity (přes --entity-path). Starý připojovací řetězec bude mít hodnotu null.

Pokud aktualizujete typ ověřování z koncového bodu tématu služby Service Bus založeného na identitě na klíč, musíte zadat připojovací řetězec (přes --connection-string). Původní identifikátor URI koncového bodu a cesta entity budou null.

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]

Příklady

Aktualizujte koncový bod tématu služby Service Bus založený na klíči nebo identitě pro IoT Hub tak, aby používal nový zadaný připojovací řetězec.

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

Aktualizujte koncový bod tématu služby Service Bus pro IoT Hub tak, aby používal identitu přiřazenou systémem a jinou cestu entity.

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

Aktualizace koncového bodu tématu služby Service Bus založeného na klíči pro službu IoT Hub tak, aby používala identitu přiřazenou uživatelem (pokud koncový bod už je založený na identitě, můžete vynechat --endpoint-uri).

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}

Povinné parametry

--en --endpoint --endpoint-name

Název koncového bodu směrování

--hub-name -n

Název ioT Hubu

Volitelné parametry

--connection-string -c

Připojení řetězec koncového bodu směrování.

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

Skupina prostředků resoure koncového bodu Pokud není k dispozici, použije se skupina prostředků ioT Hubu.

--endpoint-subscription-id -s

ID předplatného prostředku koncového bodu Pokud není k dispozici, použije se předplatné ioT Hubu.

--endpoint-uri

Identifikátor URI prostředku koncového bodu.

--entity-path

Cesta entity prostředku koncového bodu.

--identity

Pro ověřování koncových bodů použijte spravovanou identitu přiřazenou systémem nebo přiřazenou uživatelem. Pomocí [system] můžete odkazovat na identitu přiřazenou systémem nebo ID prostředku a odkazovat na identitu přiřazenou uživatelem.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot hub message-endpoint update storage-container

Preview

Skupina příkazů iot Hub message-endpoint je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Aktualizujte vlastnosti existujícího koncového bodu kontejneru úložiště pro IoT Hub.

Pokud aktualizujete typ ověřování z klíče na koncový bod kontejneru úložiště založeného na identitě, musíte zadat identitu (prostřednictvím --identity) a identifikátor URI koncového bodu (přes --endpoint-uri). Starý připojovací řetězec bude mít hodnotu null.

Pokud aktualizujete typ ověřování z koncového bodu kontejneru úložiště založeného na identitě na koncový bod kontejneru úložiště založený na klíči, musíte zadat připojovací řetězec (přes --connection-string).

Název a kódování kontejneru pro koncový bod nelze změnit. Názvy účtů je možné změnit pouze v případě, že v obou účtech existují kontejnery se stejným názvem.

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]

Příklady

Aktualizujte koncový bod kontejneru úložiště založeného na klíči nebo identitě pro IoT Hub tak, aby používal nový zadaný připojovací řetězec.

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

Aktualizujte koncový bod kontejneru úložiště pro IoT Hub tak, aby používal identitu přiřazenou systémem s danou dávkovou frekvencí, velikostí bloku dat a formátem názvu souboru.

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]

Aktualizace koncového bodu kontejneru úložiště založeného na klíči pro IoT Hub tak, aby používala identitu přiřazenou uživatelem (pokud je koncový bod už založený na identitě, můžete vynechat --endpoint-uri).

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

Povinné parametry

--en --endpoint --endpoint-name

Název koncového bodu směrování

--hub-name -n

Název ioT Hubu

Volitelné parametry

--batch-frequency -b

Frekvence dávky požadavků v sekundách. Maximální doba, která může uplynout před zápisem dat do objektu blob, mezi 60 a 720 sekund.

--chunk-size -w

Velikost bloku požadavku v megabajtech (MB). Maximální velikost objektů blob v rozsahu 10 až 500 MB.

--connection-string -c

Připojení řetězec koncového bodu směrování.

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

Skupina prostředků resoure koncového bodu Pokud není k dispozici, použije se skupina prostředků ioT Hubu.

--endpoint-subscription-id -s

ID předplatného prostředku koncového bodu Pokud není k dispozici, použije se předplatné ioT Hubu.

--endpoint-uri

Identifikátor URI prostředku koncového bodu.

--ff --file-name-format

Formát názvu souboru objektu blob. Formát názvu souboru musí obsahovat pole {iothub}, {partition}, {RRRR}, {MM}, {DD}, {HH} a {mm}. Všechny parametry jsou povinné, ale dají se změnit jejich pořadí pomocí oddělovačů nebo bez oddělovačů.

--identity

Pro ověřování koncových bodů použijte spravovanou identitu přiřazenou systémem nebo přiřazenou uživatelem. Pomocí [system] můžete odkazovat na identitu přiřazenou systémem nebo ID prostředku a odkazovat na identitu přiřazenou uživatelem.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.