Share via


az iot central device

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 central device . Altre informazioni sulle estensioni.

Gestire e configurare i dispositivi IoT Central.

Comandi

Nome Descrizione Tipo Stato
az iot central device attestation

Gestire e configurare l'attestazione del dispositivo IoT Central.

Estensione Disponibilità generale
az iot central device attestation create

Creare un'attestazione di un singolo dispositivo.

Estensione Disponibilità generale
az iot central device attestation delete

Rimuovere un'attestazione di un singolo dispositivo.

Estensione Disponibilità generale
az iot central device attestation show

Ottenere l'attestazione del dispositivo.

Estensione Disponibilità generale
az iot central device attestation update

Aggiornare un'attestazione di un singolo dispositivo tramite patch.

Estensione Disponibilità generale
az iot central device c2d-message

Eseguire i comandi di messaggistica da cloud a dispositivo.

Estensione Disponibilità generale
az iot central device c2d-message purge

Elimina la coda di messaggi da cloud a dispositivo per il dispositivo di destinazione.

Estensione Disponibilità generale
az iot central device command

Eseguire i comandi del dispositivo.

Estensione Disponibilità generale
az iot central device command history

Ottenere i dettagli per la richiesta di comando e la risposta più recenti inviate al dispositivo.

Estensione Disponibilità generale
az iot central device command run

Eseguire un comando in un dispositivo e visualizzare la risposta associata. Non monitora gli aggiornamenti delle proprietà che il comando può eseguire.

Estensione Disponibilità generale
az iot central device compute-device-key

Generare una chiave di firma di accesso condiviso del dispositivo derivata.

Estensione Disponibilità generale
az iot central device create

Creare un dispositivo in IoT Central.

Estensione Disponibilità generale
az iot central device delete

Eliminare un dispositivo da IoT Central.

Estensione Disponibilità generale
az iot central device edge

Gestire e configurare i dispositivi perimetrali IoT Central.

Estensione Disponibilità generale
az iot central device edge children

Gestire i dispositivi figlio di dispositivi IoT Edge.

Estensione Disponibilità generale
az iot central device edge children add

Aggiungere dispositivi come elementi figlio a un dispositivo perimetrale di destinazione.

Estensione Anteprima
az iot central device edge children list

Ottenere l'elenco degli elementi figlio di un dispositivo IoT Edge.

Estensione Disponibilità generale
az iot central device edge children remove

Rimuovere i dispositivi figlio da un dispositivo perimetrale di destinazione.

Estensione Anteprima
az iot central device edge manifest

Gestire i manifesti dei dispositivi IoT Edge.

Estensione Anteprima
az iot central device edge manifest show

Ottenere il manifesto della distribuzione associato al dispositivo IoT Edge specificato.

Estensione Anteprima
az iot central device edge module

Gestire i moduli dei dispositivi IoT Edge.

Estensione Anteprima
az iot central device edge module list

Ottenere l'elenco dei moduli in un dispositivo IoT Edge.

Estensione Anteprima
az iot central device edge module restart

Riavviare un modulo in un dispositivo IoT Edge.

Estensione Anteprima
az iot central device edge module show

Ottenere un modulo in un dispositivo IoT Edge.

Estensione Anteprima
az iot central device list

Ottenere l'elenco dei dispositivi per un'applicazione IoT Central.

Estensione Disponibilità generale
az iot central device list-components

Elencare i componenti presenti in un dispositivo.

Estensione Disponibilità generale
az iot central device list-modules

Elencare i moduli presenti in un dispositivo.

Estensione Disponibilità generale
az iot central device manual-failback

Ripristina il comando di failover eseguito in precedenza spostando di nuovo il dispositivo nel hub IoT originale.

Estensione Disponibilità generale
az iot central device manual-failover

Eseguire un failover manuale del dispositivo tra più hub IoT per convalidare la capacità del firmware del dispositivo di riconnettersi usando DPS a un hub IoT diverso.

Estensione Disponibilità generale
az iot central device registration-info

Ottenere informazioni di registrazione sui dispositivi da IoT Central.

Estensione Disponibilità generale
az iot central device show

Ottenere un dispositivo da IoT Central.

Estensione Disponibilità generale
az iot central device show-credentials

Ottenere le credenziali del dispositivo da IoT Central.

Estensione Disponibilità generale
az iot central device telemetry

Eseguire una query sul dispositivo IoT Central per l'ultimo valore di telemetria.

Estensione Disponibilità generale
az iot central device telemetry show

Ottenere l'ultimo valore di telemetria da un dispositivo.

Estensione Disponibilità generale
az iot central device twin

Gestire i dispositivi gemelli IoT Central.

Estensione Disponibilità generale
az iot central device twin replace

Sostituire i valori delle proprietà scrivibili di un dispositivo, un componente del dispositivo o un modulo dispositivo o un componente del modulo del dispositivo.

Estensione Disponibilità generale
az iot central device twin show

Ottenere tutti i valori delle proprietà di un dispositivo, un componente del dispositivo, un modulo dispositivo o un componente del modulo del dispositivo.

Estensione Disponibilità generale
az iot central device twin update

Aggiornare i valori delle proprietà scrivibili di un dispositivo, un componente del dispositivo, un modulo dispositivo o un componente del modulo del dispositivo.

Estensione Disponibilità generale
az iot central device update

Aggiornare un dispositivo in IoT Central.

Estensione Disponibilità generale

az iot central device compute-device-key

Generare una chiave di firma di accesso condiviso del dispositivo derivata.

Generare una chiave del dispositivo derivata da una chiave di firma di accesso condiviso a livello di gruppo.

az iot central device compute-device-key --device-id
                                         --pk

Esempio

Utilizzo di base

az iot central device compute-device-key --pk {primaryKey} --device-id {deviceid}

Parametri necessari

--device-id -d

ID dispositivo del dispositivo di destinazione. È possibile trovare l'ID dispositivo facendo clic sul pulsante Connessione nella pagina Dettagli dispositivo.

--pk --primary-key

Chiave di accesso condiviso simmetrica primaria archiviata in formato Base64.

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 central device create

Creare un dispositivo in IoT Central.

az iot central device create --app-id
                             --device-id
                             [--api-version {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri]
                             [--device-name]
                             [--organizations]
                             [--simulated {false, true}]
                             [--template]
                             [--token]

Esempio

Creare un dispositivo

az iot central device create --app-id {appid} --device-id {deviceid}

Creare un dispositivo simulato

az iot central device create --app-id {appid} --device-id {deviceid} --template {devicetemplateid} --simulated

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--device-id -d

Identificatore univoco per il dispositivo. Stringa con distinzione tra maiuscole/minuscole (lunghezza massima 128 caratteri) con caratteri alfanumerici ASCII a 7 bit più alcuni caratteri speciali: - . + % _ # * ? ! ( ) , : = @ $ '.

Parametri facoltativi

--api-version --av
Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

valori accettati: 2022-06-30-preview, 2022-07-31
valore predefinito: 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

valore predefinito: azureiotcentral.com
--device-name

Nome del dispositivo leggibile. Esempio: Frigorifero.

--organizations --orgs

Assegnare il dispositivo alle organizzazioni specificate. Elenco delimitato da virgole di ID organizzazione. Versione minima supportata: 1.1-preview.

--simulated

Aggiungere questo flag se si vuole configurare IoT Central come dispositivo simulato. --template è obbligatorio se è true.

valori accettati: false, true
valore predefinito: False
--template

ID modello centrale. Esempio: dtmi:errorpkindbz:modelDefinition:iild3tm_uo.

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 central device delete

Eliminare un dispositivo da IoT Central.

az iot central device delete --app-id
                             --device-id
                             [--api-version {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri]
                             [--token]

Esempio

Eliminare un dispositivo

az iot central device delete --app-id {appid} --device-id {deviceid}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--device-id -d

ID dispositivo del dispositivo di destinazione. È possibile trovare l'ID dispositivo facendo clic sul pulsante Connessione nella pagina Dettagli dispositivo.

Parametri facoltativi

--api-version --av
Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

valori accettati: 2022-06-30-preview, 2022-07-31
valore predefinito: 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

valore predefinito: azureiotcentral.com
--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 central device list

Ottenere l'elenco dei dispositivi per un'applicazione IoT Central.

az iot central device list --app-id
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--edge-only]
                           [--token]

Esempio

Elencare tutti i dispositivi in un'applicazione, ordinati in base all'ID dispositivo (impostazione predefinita)

az iot central device list --app-id {appid}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

Parametri facoltativi

--api-version --av
Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

valori accettati: 2022-06-30-preview, 2022-07-31
valore predefinito: 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

valore predefinito: azureiotcentral.com
--edge-only -e

Elenca solo i dispositivi IoT Edge.

valore predefinito: False
--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 central device list-components

Elencare i componenti presenti in un dispositivo.

az iot central device list-components --app-id
                                      --device-id
                                      [--api-version {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--mn]
                                      [--token]

Esempio

Elencare i componenti presenti in un dispositivo

az iot central device list-components --app-id {appid} --device-id {deviceid}

Elencare i componenti presenti in un modulo del dispositivo

az iot central device list-components --app-id {appid} --module-name {modulename} --device-id {deviceid}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--device-id -d

ID dispositivo del dispositivo di destinazione. È possibile trovare l'ID dispositivo facendo clic sul pulsante Connessione nella pagina Dettagli dispositivo.

Parametri facoltativi

--api-version --av
Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

valori accettati: 2022-06-30-preview, 2022-07-31
valore predefinito: 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

valore predefinito: azureiotcentral.com
--mn --module-name

Nome del modulo del dispositivo.

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 central device list-modules

Elencare i moduli presenti in un dispositivo.

az iot central device list-modules --app-id
                                   --device-id
                                   [--api-version {2022-06-30-preview, 2022-07-31}]
                                   [--central-api-uri]
                                   [--token]

Esempio

Elencare i moduli presenti in un dispositivo

az iot central device list-modules --app-id {appid} --device-id {deviceid}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--device-id -d

ID dispositivo del dispositivo di destinazione. È possibile trovare l'ID dispositivo facendo clic sul pulsante Connessione nella pagina Dettagli dispositivo.

Parametri facoltativi

--api-version --av
Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

valori accettati: 2022-06-30-preview, 2022-07-31
valore predefinito: 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

valore predefinito: azureiotcentral.com
--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 central device manual-failback

Ripristina il comando di failover eseguito in precedenza spostando di nuovo il dispositivo nel hub IoT originale.

Per altre informazioni sulla disponibilità elevata, vedere https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

az iot central device manual-failback --app-id
                                      --device-id
                                      [--api-version {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--token]

Esempio

Ripristina il comando di failover eseguito in precedenza spostando di nuovo il dispositivo nel hub IoT originale

az iot central device manual-failback --app-id {appid} --device-id {deviceid}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--device-id -d

ID dispositivo del dispositivo di destinazione. È possibile trovare l'ID dispositivo facendo clic sul pulsante Connessione nella pagina Dettagli dispositivo.

Parametri facoltativi

--api-version --av
Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

valori accettati: 2022-06-30-preview, 2022-07-31
valore predefinito: 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

valore predefinito: azureiotcentral.com
--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 central device manual-failover

Eseguire un failover manuale del dispositivo tra più hub IoT per convalidare la capacità del firmware del dispositivo di riconnettersi usando DPS a un hub IoT diverso.

Per altre informazioni sulla disponibilità elevata e sul valore predefinito per ttl-minutes, vedere https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

az iot central device manual-failover --app-id
                                      --device-id
                                      [--api-version {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--token]
                                      [--ttl]

Esempio

Eseguire un failover manuale del dispositivo tra più hub IoT per convalidare la capacità del firmware del dispositivo di riconnettersi usando DPS a un hub IoT diverso.

az iot central device manual-failover --app-id {appid} --device-id {deviceid} --ttl-minutes {ttl_minutes}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--device-id -d

ID dispositivo del dispositivo di destinazione. È possibile trovare l'ID dispositivo facendo clic sul pulsante Connessione nella pagina Dettagli dispositivo.

Parametri facoltativi

--api-version --av
Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

valori accettati: 2022-06-30-preview, 2022-07-31
valore predefinito: 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

valore predefinito: azureiotcentral.com
--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

--ttl --ttl-minutes

Numero intero positivo. Durata (TTL) in minuti per riportare il dispositivo all'hub originale. Ha un valore predefinito nel back-end. Vedere la documentazione sull'ora predefinita del back-end più recente per il valore live visitando https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

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 central device registration-info

Ottenere informazioni di registrazione sui dispositivi da IoT Central.

Nota: questo comando può richiedere una quantità significativa di tempo per restituire se non viene specificato alcun ID dispositivo e l'app contiene molti dispositivi.

az iot central device registration-info --app-id
                                        --device-id
                                        [--api-version {2022-06-30-preview, 2022-07-31}]
                                        [--central-api-uri]
                                        [--token]

Esempio

Ottenere informazioni di registrazione nel dispositivo specificato

az iot central device registration-info --app-id {appid} --device-id {deviceid}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--device-id -d

ID dispositivo del dispositivo di destinazione. È possibile trovare l'ID dispositivo facendo clic sul pulsante Connessione nella pagina Dettagli dispositivo.

Parametri facoltativi

--api-version --av
Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

valori accettati: 2022-06-30-preview, 2022-07-31
valore predefinito: 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

valore predefinito: azureiotcentral.com
--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 central device show

Ottenere un dispositivo da IoT Central.

az iot central device show --app-id
                           --device-id
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--token]

Esempio

Ottenere un dispositivo

az iot central device show --app-id {appid} --device-id {deviceid}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--device-id -d

ID dispositivo del dispositivo di destinazione. È possibile trovare l'ID dispositivo facendo clic sul pulsante Connessione nella pagina Dettagli dispositivo.

Parametri facoltativi

--api-version --av
Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

valori accettati: 2022-06-30-preview, 2022-07-31
valore predefinito: 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

valore predefinito: azureiotcentral.com
--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 central device show-credentials

Ottenere le credenziali del dispositivo da IoT Central.

az iot central device show-credentials --app-id
                                       --device-id
                                       [--api-version {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri]
                                       [--token]

Esempio

Ottenere le credenziali del dispositivo per un dispositivo

az iot central device show-credentials --app-id {appid} --device-id {deviceid}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--device-id -d

ID dispositivo del dispositivo di destinazione. È possibile trovare l'ID dispositivo facendo clic sul pulsante Connessione nella pagina Dettagli dispositivo.

Parametri facoltativi

--api-version --av
Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

valori accettati: 2022-06-30-preview, 2022-07-31
valore predefinito: 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

valore predefinito: azureiotcentral.com
--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 central device update

Aggiornare un dispositivo in IoT Central.

Consente di modificare le proprietà seguenti di un dispositivo: "displayName", "template", "simulated", "enabled" e "organizations". Impossibile modificare l'ID dispositivo.

az iot central device update --app-id
                             --device-id
                             [--api-version {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri]
                             [--device-name]
                             [--enable {false, true}]
                             [--organizations]
                             [--simulated {false, true}]
                             [--template]
                             [--token]

Esempio

Aggiornare un nome visualizzato del dispositivo

az iot central device update --app-id {appid} --device-id {deviceid} --device-name {deviceName}

Trasformare un dispositivo simulato in un dispositivo reale

az iot central device update --app-id {appid} --device-id {deviceid} --simulated false

Aggiornare le organizzazioni per il dispositivo

az iot central device update --app-id {appid} --device-id {deviceid} --organizations {organizations}

Disabilitare un dispositivo

az iot central device update --app-id {appid} --device-id {deviceid} --enable false

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--device-id -d

ID dispositivo del dispositivo di destinazione. È possibile trovare l'ID dispositivo facendo clic sul pulsante Connessione nella pagina Dettagli dispositivo.

Parametri facoltativi

--api-version --av
Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

valori accettati: 2022-06-30-preview, 2022-07-31
valore predefinito: 2022-07-31
--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

valore predefinito: azureiotcentral.com
--device-name

Nome del dispositivo leggibile. Esempio: Frigorifero.

--enable

Aggiungere questo flag se si vuole che IoT Central abiliti o disabiliti il dispositivo.

valori accettati: false, true
--organizations --orgs

Assegnare il dispositivo alle organizzazioni specificate. Elenco delimitato da virgole di ID organizzazione. Versione minima supportata: 1.1-preview.

--simulated

Aggiungere questo flag se si vuole configurare IoT Central come dispositivo simulato. --template è obbligatorio se è true.

valori accettati: false, true
--template

ID modello centrale. Esempio: dtmi:errorpkindbz:modelDefinition:iild3tm_uo.

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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.