az iot adr ns link
Note
Questo riferimento fa parte dell'estensione azure-iot per il interfaccia della riga di comando di Azure (versione 2.73.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot adr ns link . Altre informazioni sulle estensioni.
Il gruppo di comandi 'iot adr ns' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Gestire i collegamenti tra uno spazio dei nomi del Registro dispositivi e le risorse downstream.
Collegare prima un servizio Device Provisioning, quindi collegare gli hub IoT. Usare l'aggiornamento per modificare l'identità in ingresso di un collegamento o riprovare a un endpoint non riuscito con l'identità e le impostazioni salvate. Usare show, list e wait per esaminare linkingState. I collegamenti appartengono allo spazio dei nomi . Per scollegare, eliminare prima la risorsa collegata, quindi eseguire l'hub di collegamento/dps/su remove per rimuovere l'endpoint dallo spazio dei nomi. La rimozione non elimina o controlla la risorsa collegata e non attende il completamento del collegamento. Aggiungere/aggiornare attendere che il collegamento abbia esito positivo (--timeout predefinito 600 secondi, --interval 30). Dopo --no-wait, usare link hub/dps/su wait per tenere traccia del completamento.
Comandi
| Nome | Descrizione | Tipo | Status |
|---|---|---|---|
| az iot adr ns link add |
Collegare prima il servizio Device Provisioning, quindi un hub, a uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link dps |
Gestire i collegamenti DPS (endpoint di provisioning) in uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link dps add |
Collegare un servizio Device Provisioning (DPS) a uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link dps list |
Elencare gli endpoint di provisioning dps in uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link dps remove |
Rimuovere un endpoint DPS da uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link dps show |
Visualizzare un singolo endpoint di provisioning dps in uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link dps update |
Aggiornare un endpoint di provisioning dps esistente in uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link dps wait |
Attendere che un endpoint dps venga collegato correttamente. |
Extension | Preview |
| az iot adr ns link hub |
Gestire i collegamenti hub IoT (endpoint di messaggistica) in uno spazio dei nomi del Registro di sistema dei dispositivi. |
Extension | Preview |
| az iot adr ns link hub add |
Collegare un hub IoT a uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link hub list |
Elencare hub IoT endpoint di messaggistica in uno spazio dei nomi del Registro di sistema dei dispositivi. |
Extension | Preview |
| az iot adr ns link hub remove |
Rimuovere un endpoint hub IoT da uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link hub show |
Visualizzare un singolo endpoint di messaggistica hub IoT in uno spazio dei nomi del Registro di sistema dei dispositivi. |
Extension | Preview |
| az iot adr ns link hub update |
Aggiornare un endpoint di messaggistica hub IoT esistente in uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link hub wait |
Attendere che un endpoint hub IoT venga collegato correttamente. |
Extension | Preview |
| az iot adr ns link su |
Gestire i collegamenti degli aggiornamenti software (aggiornamenti degli endpoint) in uno spazio dei nomi del Registro di sistema dei dispositivi. |
Extension | Preview |
| az iot adr ns link su add |
Collegare un'istanza di aggiornamento a uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link su list |
Elencare gli endpoint di aggiornamento degli aggiornamenti software in uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link su remove |
Rimuovere un endpoint dell'istanza di Aggiornamenti software da uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link su show |
Visualizzare un singolo endpoint di aggiornamento degli aggiornamenti software in uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link su update |
Aggiornare un endpoint di aggiornamento degli aggiornamenti software esistente in uno spazio dei nomi del Registro di sistema dispositivi. |
Extension | Preview |
| az iot adr ns link su wait |
Attendere che un endpoint degli aggiornamenti software venga collegato correttamente. |
Extension | Preview |
| az iot adr ns link wait |
Attendere che tutti i collegamenti dello spazio dei nomi selezionati abbiano esito positivo. |
Extension | Preview |
az iot adr ns link add
Il gruppo di comandi 'iot adr ns link' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Collegare prima il servizio Device Provisioning, quindi un hub, a uno spazio dei nomi del Registro di sistema dispositivi.
Convalida entrambe le destinazioni, i nomi degli endpoint, le selezioni di identità e il controllo degli accessi in base al ruolo necessari prima di modificare gli endpoint dello spazio dei nomi. Invia un aggiornamento dello spazio dei nomi solo DPS e attende che l'endpoint dps esatto raggiunga linkingState Succeeded prima di inviare un aggiornamento dell'hub separato. --no-wait attende ancora questa dipendenza dps; ignora l'attesa solo per l'operazione dell'hub finale. Entrambe le fasi di attesa recuperano solo AdrMiNotAuthorized nell'endpoint non modificato dopo aver verificato le assegnazioni di ruolo del servizio necessarie. Il ripristino usa l'aggiornamento dell'endpoint, mai un altro componente aggiuntivo. --timeout (600 secondi) è un budget di mutazione/recupero condiviso per entrambe le fasi dopo il pre-verifica iniziale del controllo degli accessi in base al ruolo, inclusi i controller di dominio, il polling e il backoff di 30/60/120 secondi. Per impostazione predefinita, l'intervallo è 30 secondi. Entrambi devono essere positivi. Non viene aggiunto alcun ritardo quando l'autorizzazione funziona già. Con --no-wait, usare l'hub di collegamento per tenere traccia della fase hub. Rifiutato se lo spazio dei nomi dispone già di un servizio Device Provisioning collegato. Un errore o un timeout del servizio Device Provisioning impedisce l'invio dell'hub. Il completamento parziale non viene eseguito il rollback. Esaminare gli endpoint con collegamento dps show o link hub show e ripristinare gli errori persistenti con l'aggiornamento del collegamento corrispondente, mantenendo l'identità esistente. Dopo l'esito positivo del servizio Device Provisioning, usare l'hub di collegamento per aggiungere solo se l'endpoint dell'hub è assente; usare l'hub di collegamento attendere se è in sospeso. Non rieseguire l'aggiunta di un collegamento combinato quando l'endpoint dps esiste già. Ruoli da servizio a servizio necessari: MI in uscita dello spazio dei nomi -> Collaboratore nel servizio Device Provisioning; DPS selezionato in ingresso MI -> Collaboratore nello spazio dei nomi; mi di sistema assegnato dal sistema dello spazio dei nomi -> Azure Amministratore del Registro di sistema del dispositivo nello spazio dei nomi; MI in uscita dello spazio dei nomi -> Collaboratore allo spazio dei nomi in uscita -> Collaboratore ai dati hub IoT su HUB; quando è selezionata un'identità in ingresso, HUB selezionato MI -> Collaboratore allo spazio dei nomi.
az iot adr ns link add --den --dps-endpoint-name
--dps-id --dps-resource-id
--hen --hub-endpoint-name
--hub-id --hub-resource-id
--namespace --ns
--resource-group
[--acquire-policy-token]
[--change-reference]
[--dps-mi-sa --dps-system-assigned-mi {false, true}]
[--dps-mi-ua --dps-user-assigned-mi]
[--hub-allocation-weight --hub-weight]
[--hub-availability {Available, Disabled}]
[--hub-mi-sa --hub-system-assigned-mi {false, true}]
[--hub-mi-ua --hub-user-assigned-mi]
[--interval]
[--no-wait]
[--timeout]
Esempio
Collegare un hub e un servizio Device Provisioning usando l'identità assegnata dal sistema per entrambi i chiamanti in ingresso
az iot adr ns link add --ns myNamespace -g myResourceGroup \
--hub-endpoint-name primary-hub --hub-id /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.Devices/IotHubs/<hub> --hub-system-assigned-mi \
--dps-endpoint-name primary-dps --dps-id /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.Devices/provisioningServices/<dps> --dps-system-assigned-mi
Collegare entrambe le risorse senza configurare un'identità chiamante in ingresso dell'hub
az iot adr ns link add --ns myNamespace -g myResourceGroup \
--hub-endpoint-name primary-hub --hub-id <hub-id> \
--dps-endpoint-name primary-dps --dps-id <dps-id> --dps-system-assigned-mi
Collegare entrambi con la disponibilità e il peso dell'hub personalizzati
az iot adr ns link add --ns myNamespace -g myResourceGroup \
--hub-endpoint-name primary-hub --hub-id <hub-id> --hub-system-assigned-mi \
--hub-availability Available --hub-allocation-weight 1 \
--dps-endpoint-name primary-dps --dps-id <dps-id> --dps-system-assigned-mi
Attendere il servizio Device Provisioning, inviare l'hub senza attendere, quindi osservare il collegamento hub
az iot adr ns link add --ns myNamespace -g myResourceGroup \
--hub-endpoint-name primary-hub --hub-id <hub-id> \
--dps-endpoint-name primary-dps --dps-id <dps-id> --dps-system-assigned-mi --no-wait
az iot adr ns link hub wait -n primary-hub --ns myNamespace -g myResourceGroup
Parametri necessari
Nome logico della voce dell'endpoint di provisioning dps nello spazio dei nomi.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | DPS Arguments |
Azure ID risorsa del servizio Device Provisioning da collegare.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | DPS Arguments |
Nome logico della voce dell'endpoint di messaggistica hub nello spazio dei nomi.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Hub Arguments |
Azure ID risorsa del hub IoT da collegare.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Hub Arguments |
Nome dello spazio dei nomi del Registro di sistema di dispositivi proprietario di entrambi i nuovi collegamenti.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
ID riferimento di modifica correlato per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
Usare l'identità assegnata dal sistema della risorsa DPS collegata come identità chiamante in ingresso.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | DPS Arguments |
| Valore predefinito: | False |
| Valori accettati: | false, true |
ID risorsa identità assegnata dall'utente collegato alla risorsa dps collegata.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | DPS Arguments |
Peso dell'allocazione degli endpoint di messaggistica hub.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Hub Arguments |
Disponibilità dell'endpoint di messaggistica hub.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Hub Arguments |
| Valori accettati: | Available, Disabled |
Usare l'identità assegnata dal sistema del hub IoT collegato come identità chiamante in ingresso.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Hub Arguments |
| Valore predefinito: | False |
| Valori accettati: | false, true |
ID risorsa identità assegnata dall'utente collegato al hub IoT collegato.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Hub Arguments |
Intervallo di polling in secondi. Deve essere maggiore di zero.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | 30 |
Attendere che il collegamento al servizio Device Provisioning abbia esito positivo, quindi tornare senza attendere l'operazione dell'hub finale.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Budget positivo di mutazione/ripristino condiviso in secondi per dps e hub dopo il controllo degli accessi in base al ruolo iniziale. Impostazione predefinita: 600.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | 600 |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az iot adr ns link wait
Il gruppo di comandi 'iot adr ns link' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Attendere che tutti i collegamenti dello spazio dei nomi selezionati abbiano esito positivo.
Senza un predicato di attesa esplicito, attende che ogni endpoint selezionato abbia linkingState Succeeded e abbia esito negativo immediatamente se si verifica un errore. Definire l'ambito dell'attesa con --hub-endpoint-name, --dps-endpoint-name e/o --su-endpoint-name. Se non viene fornito alcuno, sono inclusi tutti i collegamenti Hub, DPS e Aggiornamenti software attualmente configurati. I predicati di attesa espliciti interfaccia della riga di comando di Azure ispezionano la risorsa dello spazio dei nomi e mantengono il comportamento standard.
az iot adr ns link wait --namespace --ns
--resource-group
[--acquire-policy-token]
[--change-reference]
[--created]
[--custom]
[--deleted]
[--den --dps-endpoint-name]
[--exists]
[--hen --hub-endpoint-name]
[--interval]
[--sen --su-endpoint-name]
[--timeout]
[--updated]
Esempio
Attendere che tutti i collegamenti dello spazio dei nomi configurati abbiano esito positivo
az iot adr ns link wait --ns myNamespace -g myResourceGroup
Attendere l'aggiunta dell'hub e del servizio Device Provisioning creati dal collegamento dps-first combinato
az iot adr ns link wait --ns myNamespace -g myResourceGroup \
--hub-endpoint-name primary-hub --dps-endpoint-name primary-dps
Parametri necessari
Nome dello spazio dei nomi del Registro di sistema del dispositivo proprietario del collegamento.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
ID riferimento di modifica correlato per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
Attendere che provisioningState sia Completato.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | False |
Attendere che un'espressione JMESPath personalizzata restituisca true.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
Attendere l'eliminazione della risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | False |
Endpoint DPS da includere nell'ambito di attesa.
Attendere che la risorsa esista.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | False |
Endpoint hub da includere nell'ambito di attesa.
Intervallo di polling in secondi.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | 30 |
Endpoint degli aggiornamenti software da includere nell'ambito di attesa. Quando non viene specificato alcun nome di endpoint con ambito, vengono inclusi tutti i collegamenti dello spazio dei nomi configurati.
Budget di polling in secondi, incluso il tempo GET. Un get in anteprima è limitato dai timeout del trasporto e non può essere interrotto dalla scadenza del polling.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | 3600 |
Attendere che provisioningState sia Completato.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Wait Condition Arguments |
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |