az iot edge

  • Riferimento

Nota

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

Gestione delle soluzioni IoT in IoT Edge.

Comandi

Nome Descrizione Tipo Stato
az iot edge deployment

Gestire le distribuzioni di IoT Edge su larga scala.

 Estensione Disponibilità generale
az iot edge deployment create

Creare una distribuzione IoT Edge in un hub IoT di destinazione.

 Estensione Disponibilità generale
az iot edge deployment delete

Eliminare una distribuzione di IoT Edge.

 Estensione Disponibilità generale
az iot edge deployment list

Elencare le distribuzioni di IoT Edge in un hub IoT.

 Estensione Disponibilità generale
az iot edge deployment show

Ottenere i dettagli di una distribuzione di IoT Edge.

 Estensione Disponibilità generale
az iot edge deployment show-metric

Valutare una metrica di sistema di destinazione definita in una distribuzione IoT Edge.

 Estensione Disponibilità generale
az iot edge deployment update

Aggiornare le proprietà specificate di una distribuzione di IoT Edge.

 Estensione Disponibilità generale
az iot edge devices

Comandi per gestire i dispositivi IoT Edge.

 Estensione Disponibilità generale
az iot edge devices create

Creare e configurare più dispositivi perimetrali in un hub IoT.

 Estensione Sperimentale
az iot edge export-modules

Esportare la configurazione dei moduli perimetrali in un singolo dispositivo perimetrale.

 Estensione Disponibilità generale
az iot edge set-modules

Impostare i moduli perimetrali in un singolo dispositivo.

 Estensione Disponibilità generale

az iot edge export-modules

Esportare la configurazione dei moduli perimetrali in un singolo dispositivo perimetrale.

L'output della configurazione del modulo gemello può essere usato direttamente come --content di "az iot edge set-modules".

az iot edge export-modules --device-id
                           [--auth-type {key, login}]
                           [--hub-name]
                           [--login]
                           [--resource-group]

Esempio

Esportare la configurazione del modulo gemello in un dispositivo di destinazione.

az iot edge export-modules --hub-name {iothub_name} --device-id {device_id}

Parametri necessari

--device-id -d

ID dispositivo di destinazione.

Parametri facoltativi

--auth-type

Indica se l'operazione deve derivare automaticamente una chiave di criteri o usare la sessione di Azure AD corrente. Se il tipo di autenticazione è login e viene specificato il nome host della risorsa, la ricerca della risorsa verrà ignorata a meno che non sia necessario. È possibile configurare l'impostazione predefinita usando az configure --defaults iothub-data-auth-type=<auth-type-value>.

valori accettati: key, login
valore predefinito: key
--hub-name -n

hub IoT nome o nome host. Obbligatorio se non viene specificato --login.

--login -l

Questo comando supporta un'entità stringa di connessione con diritti per eseguire l'azione. Usare per evitare l'accesso di sessione tramite "az login". Se vengono forniti sia un stringa di connessione di entità che un nome, il stringa di connessione ha priorità. Obbligatorio se --hub-name non è specificato.

--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 edge set-modules

Impostare i moduli perimetrali in un singolo dispositivo.

Il contenuto dei moduli è json e sotto forma di {"modulesContent":{...}} o {"content":{"modulesContent":{...}}}.

Per impostazione predefinita, le proprietà dei moduli di sistema $edgeAgent e $edgeHub vengono convalidate in base agli schemi installati con l'estensione IoT. Questa opzione può essere disabilitata tramite l'opzione --no-validation.

Nota: al momento dell'esecuzione, il comando restituirà la raccolta di moduli applicati al dispositivo.

az iot edge set-modules --content
                        --device-id
                        [--auth-type {key, login}]
                        [--hub-name]
                        [--login]
                        [--resource-group]

Esempio

Testare i moduli perimetrali durante lo sviluppo impostando moduli in un dispositivo di destinazione.

az iot edge set-modules --hub-name {iothub_name} --device-id {device_id} --content ../modules_content.json

Parametri necessari

--content -k

Contenuto della distribuzione di IoT Edge. Specificare il percorso del file o il codice JSON non elaborato.

--device-id -d

ID dispositivo di destinazione.

Parametri facoltativi

--auth-type

Indica se l'operazione deve derivare automaticamente una chiave di criteri o usare la sessione di Azure AD corrente. Se il tipo di autenticazione è login e viene specificato il nome host della risorsa, la ricerca della risorsa verrà ignorata a meno che non sia necessario. È possibile configurare l'impostazione predefinita usando az configure --defaults iothub-data-auth-type=<auth-type-value>.

valori accettati: key, login
valore predefinito: key
--hub-name -n

hub IoT nome o nome host. Obbligatorio se non viene specificato --login.

--login -l

Questo comando supporta un'entità stringa di connessione con diritti per eseguire l'azione. Usare per evitare l'accesso di sessione tramite "az login". Se vengono forniti sia un stringa di connessione di entità che un nome, il stringa di connessione ha priorità. Obbligatorio se --hub-name non è specificato.

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