Share via


az iot central device twin

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

Gestire i dispositivi gemelli IoT Central.

Comandi

Nome Descrizione Tipo Stato
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 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.

Specificando --component-name, --module-name o entrambi per sostituire le proprietà dei componenti del dispositivo, le proprietà del modulo del dispositivo o le proprietà del componente del modulo dispositivo.

az iot central device twin replace --app-id
                                   --content
                                   --device-id
                                   [--api-version {2022-06-30-preview, 2022-07-31}]
                                   [--central-api-uri]
                                   [--co]
                                   [--mn]
                                   [--token]

Esempio

Sostituire le proprietà del dispositivo

az iot central device twin replace --app-id {appid} --device-id {deviceid} -k {content}

Sostituire le proprietà del componente del dispositivo

az iot central device twin replace --app-id {appid} --device-id {deviceid} --co {componentname} -k {content}

Sostituire le proprietà del componente del modulo del dispositivo

az iot central device twin replace --app-id {appid} --device-id {deviceid} --mn {modulename} --co {componentname} -k {content}

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.

--content -k

Configurazione per la richiesta. Specificare il percorso del file JSON o del codice JSON non elaborato. [Esempio di percorso file: ./path/to/file.json] [Esempio JSON stringato: {'a': 'b'}].

--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
--co --component-name

Nome del componente del dispositivo.

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

Specificando --component-name, --module-name o entrambi per ottenere le proprietà dei componenti del dispositivo, le proprietà del modulo del dispositivo o le proprietà del componente del modulo dispositivo.

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

Esempio

Get device properties

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

Ottenere le proprietà dei componenti del dispositivo

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

Ottenere le proprietà del componente del modulo dispositivo

az iot central device twin show --app-id {appid} --device-id {deviceid} --mn {modulename} --co {componentname}

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
--co --component-name

Nome del componente del dispositivo.

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

Specificando --component-name, --module-name o entrambi per aggiornare le proprietà dei componenti del dispositivo, le proprietà del modulo del dispositivo o le proprietà del componente del modulo dispositivo.

az iot central device twin update --app-id
                                  --content
                                  --device-id
                                  [--api-version {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri]
                                  [--co]
                                  [--mn]
                                  [--token]

Esempio

Update device properties

az iot central device twin update --app-id {appid} --device-id {deviceid} -k {content}

Aggiornare le proprietà del componente del dispositivo

az iot central device twin update --app-id {appid} --device-id {deviceid} --co {componentname} -k {content}

Aggiornare le proprietà del componente del modulo di dispositivo

az iot central device twin update --app-id {appid} --device-id {deviceid} --mn {modulename} --co {componentname} -k {content}

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.

--content -k

Configurazione per la richiesta. Specificare il percorso del file JSON o del codice JSON non elaborato. [Esempio di percorso file: ./path/to/file.json] [Esempio JSON stringato: {'a': 'b'}].

--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
--co --component-name

Nome del componente del dispositivo.

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