Condividi tramite


az iot hub message-endpoint update

Nota

Questo riferimento fa parte dell'estensione azure-iot per l'interfaccia della riga di comando di Azure (versione 2.46.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot hub message-endpoint update . Altre informazioni sulle estensioni.

Il gruppo di comandi 'iot hub message-endpoint' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare le proprietà di un endpoint esistente per un hub IoT.

Comandi

Nome Descrizione Tipo Stato
az iot hub message-endpoint update cosmosdb-container

Aggiornare le proprietà di un endpoint contenitore Cosmos DB esistente per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint update eventhub

Aggiornare le proprietà di un endpoint dell'hub eventi esistente per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint update servicebus-queue

Aggiornare le proprietà di un endpoint bus di servizio Queue esistente per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint update servicebus-topic

Aggiornare le proprietà di un endpoint argomento bus di servizio esistente per un hub IoT.

Estensione Anteprima
az iot hub message-endpoint update storage-container

Aggiornare le proprietà di un endpoint contenitore di archiviazione esistente per un hub IoT.

Estensione Anteprima

az iot hub message-endpoint update cosmosdb-container

Anteprima

Il gruppo di comandi 'iot hub message-endpoint' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare le proprietà di un endpoint contenitore Cosmos DB esistente per un hub IoT.

Se si aggiorna il tipo di autenticazione da un endpoint del contenitore Cosmos DB basato su chiave a quello basato su identità, è necessario specificare l'identità (tramite --identity) e l'URI dell'endpoint (tramite --endpoint-uri). La chiave primaria precedente e la chiave secondaria verranno annullate.

Se si aggiorna il tipo di autenticazione da un endpoint del contenitore Cosmos DB basato su identità a un endpoint del contenitore Cosmos DB basato su chiave, è necessario specificare il stringa di connessione (tramite --connection-string), la chiave primaria (tramite --primary-key) o la chiave secondaria (tramite --secondary-key).

Impossibile modificare il nome del contenitore per l'endpoint. I nomi degli account possono essere modificati solo se i contenitori con lo stesso nome esistono in entrambi gli account.

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]

Esempio

Aggiornare un endpoint del contenitore Cosmos DB basato su chiave o identità per un hub IoT per usare un nuovo stringa di connessione specificato.

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

Aggiornare un endpoint del contenitore Cosmos DB per un hub IoT per usare una chiave primaria e una chiave secondaria specificate.

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

Aggiornare un endpoint del contenitore Cosmos DB per un hub IoT per usare l'identità assegnata dal sistema e un nome di chiave di partizione. Il modello di chiave di partizione sarà l'impostazione predefinita.

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

Aggiornare un endpoint contenitore Cosmos DB basato su chiave per un hub IoT per usare l'identità assegnata dall'utente (è possibile omettere --endpoint-uri se l'endpoint è già basato sull'identità).

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

Parametri necessari

--en --endpoint --endpoint-name

Nome dell'endpoint di routing.

--hub-name -n

hub IoT nome.

Parametri facoltativi

--connection-string -c

Stringa di connessione dell'endpoint di routing.

--database-name --db

Nome del database cosmos DB nell'account cosmos DB.

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

Gruppo di risorse della risorsa Endpoint. Se non specificato, verrà usato il gruppo di risorse del hub IoT.

--endpoint-subscription-id -s

ID sottoscrizione della risorsa endpoint. Se non specificato, verrà usata la sottoscrizione del hub IoT.

--endpoint-uri

URI della risorsa endpoint.

--identity

Usare un'identità gestita assegnata dal sistema o assegnata dall'utente per l'autenticazione dell'endpoint. Usare "[system]" per fare riferimento all'identità assegnata dal sistema o a un ID risorsa per fare riferimento a un'identità assegnata dall'utente.

--partition-key-name --pkn

Nome della chiave di partizione associata a questo contenitore SQL di Cosmos DB, se presente. Per cancellare questa proprietà, impostarla su "".

--partition-key-template --pkt

Modello per la generazione di un valore di chiave di partizione sintetica da usare con questo contenitore SQL di Cosmos DB. Il modello deve includere almeno uno dei segnaposto seguenti: {iothub}, {deviceid}, {DD}, {MM}e {AAAA}. Qualsiasi segnaposto può essere specificato al massimo una volta, ma i componenti di ordine e non segnaposto sono arbitrari. Se viene specificato il nome della chiave di partizione, per impostazione predefinita il modello di chiave di partizione è {deviceid}-{AAAA}-{MM}. Per cancellare questa proprietà, impostarla su "".

--pk --primary-key

Chiave primaria dell'account cosmos DB.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--secondary-key --sk

Chiave secondaria dell'account cosmos DB.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot hub message-endpoint update eventhub

Anteprima

Il gruppo di comandi 'iot hub message-endpoint' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare le proprietà di un endpoint dell'hub eventi esistente per un hub IoT.

Se si aggiorna il tipo di autenticazione da un endpoint dell'hub eventi basato su chiave a quello basato su identità, è necessario specificare l'identità (tramite --identity), l'URI dell'endpoint (tramite --endpoint-uri) e il percorso dell'entità (tramite --entity-path). Il stringa di connessione precedente verrà disattivato.

Se si aggiorna il tipo di autenticazione da un endpoint dell'hub eventi basato su identità a un endpoint dell'hub eventi basato su chiave, è necessario specificare il stringa di connessione (tramite --connection-string). L'URI dell'endpoint precedente e il percorso dell'entità verranno disattivati.

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]

Esempio

Aggiornare un endpoint dell'hub eventi basato su chiave o identità per un hub IoT per usare un nuovo stringa di connessione specificato.

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

Aggiornare un endpoint dell'hub eventi per un hub IoT per usare l'identità assegnata dal sistema e un percorso di entità diverso.

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

Aggiornare un endpoint dell'hub eventi basato su chiave per un hub IoT per usare l'identità assegnata dall'utente (è possibile omettere --endpoint-uri se l'endpoint è già basato sull'identità).

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}

Parametri necessari

--en --endpoint --endpoint-name

Nome dell'endpoint di routing.

--hub-name -n

hub IoT nome.

Parametri facoltativi

--connection-string -c

Stringa di connessione dell'endpoint di routing.

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

Gruppo di risorse della risorsa Endpoint. Se non specificato, verrà usato il gruppo di risorse del hub IoT.

--endpoint-subscription-id -s

ID sottoscrizione della risorsa endpoint. Se non specificato, verrà usata la sottoscrizione del hub IoT.

--endpoint-uri

URI della risorsa endpoint.

--entity-path

Percorso dell'entità della risorsa endpoint.

--identity

Usare un'identità gestita assegnata dal sistema o assegnata dall'utente per l'autenticazione dell'endpoint. Usare "[system]" per fare riferimento all'identità assegnata dal sistema o a un ID risorsa per fare riferimento a un'identità assegnata dall'utente.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot hub message-endpoint update servicebus-queue

Anteprima

Il gruppo di comandi 'iot hub message-endpoint' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare le proprietà di un endpoint bus di servizio Queue esistente per un hub IoT.

Se si aggiorna il tipo di autenticazione da un endpoint basato su chiave a bus di servizio coda basata su identità, è necessario specificare l'identità (tramite --identity), l'URI dell'endpoint (tramite --endpoint-uri) e il percorso dell'entità (tramite --entity-path). Il stringa di connessione precedente verrà disattivato.

Se si aggiorna il tipo di autenticazione da un endpoint basato su identità a un endpoint della coda basato su chiavi bus di servizio, è necessario specificare il stringa di connessione (tramite --connection-string). L'URI dell'endpoint precedente e il percorso dell'entità verranno disattivati.

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]

Esempio

Aggiornare un endpoint della coda basato su chiave o identità bus di servizio per un hub IoT per usare un nuovo stringa di connessione specificato.

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

Aggiornare un endpoint della coda bus di servizio per un hub IoT per usare l'identità assegnata dal sistema e un percorso di entità diverso.

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

Aggiornare un endpoint della coda basato su chiavi bus di servizio per un hub IoT per usare l'identità assegnata dall'utente (è possibile omettere --endpoint-uri se l'endpoint è già basato sull'identità).

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}

Parametri necessari

--en --endpoint --endpoint-name

Nome dell'endpoint di routing.

--hub-name -n

hub IoT nome.

Parametri facoltativi

--connection-string -c

Stringa di connessione dell'endpoint di routing.

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

Gruppo di risorse della risorsa Endpoint. Se non specificato, verrà usato il gruppo di risorse del hub IoT.

--endpoint-subscription-id -s

ID sottoscrizione della risorsa endpoint. Se non specificato, verrà usata la sottoscrizione del hub IoT.

--endpoint-uri

URI della risorsa endpoint.

--entity-path

Percorso dell'entità della risorsa endpoint.

--identity

Usare un'identità gestita assegnata dal sistema o assegnata dall'utente per l'autenticazione dell'endpoint. Usare "[system]" per fare riferimento all'identità assegnata dal sistema o a un ID risorsa per fare riferimento a un'identità assegnata dall'utente.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot hub message-endpoint update servicebus-topic

Anteprima

Il gruppo di comandi 'iot hub message-endpoint' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare le proprietà di un endpoint argomento bus di servizio esistente per un hub IoT.

Se si aggiorna il tipo di autenticazione da un endpoint basato su chiave a bus di servizio un endpoint dell'argomento basato su identità, è necessario specificare l'identità (tramite --identity), l'URI dell'endpoint (tramite --endpoint-uri) e il percorso dell'entità (tramite --entity-path). Il stringa di connessione precedente verrà disattivato.

Se si aggiorna il tipo di autenticazione da un endpoint basato su identità a un endpoint dell'argomento basato su chiavi bus di servizio, è necessario specificare il stringa di connessione (tramite --connection-string). L'URI dell'endpoint precedente e il percorso dell'entità verranno disattivati.

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]

Esempio

Aggiornare un endpoint dell'argomento bus di servizio basato su chiave o identità per un hub IoT per usare un nuovo stringa di connessione specificato.

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

Aggiornare un endpoint dell'argomento bus di servizio per un hub IoT per usare l'identità assegnata dal sistema e un percorso di entità diverso.

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

Aggiornare un endpoint dell'argomento bus di servizio basato su chiave per un hub IoT per usare l'identità assegnata dall'utente (è possibile omettere --endpoint-uri se l'endpoint è già basato sull'identità).

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}

Parametri necessari

--en --endpoint --endpoint-name

Nome dell'endpoint di routing.

--hub-name -n

hub IoT nome.

Parametri facoltativi

--connection-string -c

Stringa di connessione dell'endpoint di routing.

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

Gruppo di risorse della risorsa Endpoint. Se non specificato, verrà usato il gruppo di risorse del hub IoT.

--endpoint-subscription-id -s

ID sottoscrizione della risorsa endpoint. Se non specificato, verrà usata la sottoscrizione del hub IoT.

--endpoint-uri

URI della risorsa endpoint.

--entity-path

Percorso dell'entità della risorsa endpoint.

--identity

Usare un'identità gestita assegnata dal sistema o assegnata dall'utente per l'autenticazione dell'endpoint. Usare "[system]" per fare riferimento all'identità assegnata dal sistema o a un ID risorsa per fare riferimento a un'identità assegnata dall'utente.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot hub message-endpoint update storage-container

Anteprima

Il gruppo di comandi 'iot hub message-endpoint' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare le proprietà di un endpoint contenitore di archiviazione esistente per un hub IoT.

Se si aggiorna il tipo di autenticazione da un endpoint del contenitore di archiviazione basato su chiave a quello basato su identità, è necessario specificare l'identità (tramite --identity) e l'URI dell'endpoint (tramite --endpoint-uri). Il stringa di connessione precedente verrà disattivato.

Se si aggiorna il tipo di autenticazione da un endpoint del contenitore di archiviazione basato su identità a un endpoint contenitore di archiviazione basato su chiave, è necessario specificare il stringa di connessione (tramite --connection-string).

Impossibile modificare il nome e la codifica del contenitore per l'endpoint. I nomi degli account possono essere modificati solo se i contenitori con lo stesso nome esistono in entrambi gli account.

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]

Esempio

Aggiornare un endpoint del contenitore di archiviazione basato su chiave o identità per un hub IoT per usare un nuovo stringa di connessione specificato.

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

Aggiornare un endpoint contenitore di archiviazione per un hub IoT per usare l'identità assegnata dal sistema con la frequenza batch, le dimensioni dei blocchi e il formato del nome file specificati.

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]

Aggiornare un endpoint contenitore di archiviazione basato su chiave per un hub IoT per usare l'identità assegnata dall'utente (è possibile omettere --endpoint-uri se l'endpoint è già basato sull'identità).

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

Parametri necessari

--en --endpoint --endpoint-name

Nome dell'endpoint di routing.

--hub-name -n

hub IoT nome.

Parametri facoltativi

--batch-frequency -b

Frequenza batch richiesta in secondi. Quantità massima di tempo che può trascorrere prima che i dati vengano scritti in un BLOB, compresi tra 60 e 720 secondi.

--chunk-size -w

Dimensioni del blocco della richiesta in megabyte (MB). Dimensione massima dei BLOB, compresa tra 10 e 500 MB.

--connection-string -c

Stringa di connessione dell'endpoint di routing.

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

Gruppo di risorse della risorsa Endpoint. Se non specificato, verrà usato il gruppo di risorse del hub IoT.

--endpoint-subscription-id -s

ID sottoscrizione della risorsa endpoint. Se non specificato, verrà usata la sottoscrizione del hub IoT.

--endpoint-uri

URI della risorsa endpoint.

--ff --file-name-format

Formato del nome file per il BLOB. Il formato del nome file deve contenere {iothub}, {partition}, {AAAA}, {MM}, {DD}, {HH} e {mm} campi. Tutti i parametri sono obbligatori, ma possono essere riordinati con o senza delimitatori.

--identity

Usare un'identità gestita assegnata dal sistema o assegnata dall'utente per l'autenticazione dell'endpoint. Usare "[system]" per fare riferimento all'identità assegnata dal sistema o a un ID risorsa per fare riferimento a un'identità assegnata dall'utente.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.