Condividi tramite

az dt twin component

  • Riferimento

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

Visualizzare e aggiornare i componenti del gemello digitale di un'istanza di Gemelli digitali.

Comandi

Nome Descrizione Tipo Status
az dt twin component show

Mostra i dettagli di un componente del gemello digitale.

 Estensione GA
az dt twin component update

Aggiornare un componente del gemello digitale tramite la specifica della patch JSON.

 Estensione GA

az dt twin component show

Mostra i dettagli di un componente del gemello digitale.

az dt twin component show --component
                          --dt-name
                          --twin-id
                          [--resource-group]

Esempio

Visualizzare i dettagli di un componente di gemelli digitali

az dt twin component show -n {instance_or_hostname} --twin-id {twin_id} --component Thermostat

Parametri necessari

--component

Percorso del componente DTDL.

--dt-name --dtn -n

Nome dell'istanza di Gemelli digitali o nome host. Se viene specificato un nome di istanza, la sottoscrizione utente viene prima di tutto eseguita una query per l'istanza di destinazione per recuperare il nome host. Se viene specificato un nome host, la query di sottoscrizione viene ignorata e il valore specificato viene usato per l'interazione successiva.

--twin-id -t

ID del gemello digitale.

Parametri facoltativi

--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito usando az configure --defaults group={name}.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az dt twin component update

Aggiornare un componente del gemello digitale tramite la specifica della patch JSON.

Gli aggiornamenti ai valori delle proprietà e agli elementi $model possono verificarsi nella stessa richiesta. Le operazioni sono limitate all'aggiunta, alla sostituzione e alla rimozione.

az dt twin component update --component
                            --dt-name
                            --json-patch
                            --twin-id
                            [--etag]
                            [--resource-group]

Esempio

Aggiornare un componente del gemello digitale tramite la specifica della patch JSON.

az dt twin component update -n {instance_or_hostname} --twin-id {twin_id} --component {component_path} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

Aggiornare un componente del gemello digitale tramite la specifica della patch JSON.

az dt twin component update -n {instance_or_hostname} --twin-id {twin_id} --component {component_path} --json-patch '[
  {"op":"replace", "path":"/Temperature", "value": 20.5},
  {"op":"add", "path":"/Areas", "value": ["ControlSystem"]}
]'

Aggiornare un componente del gemello digitale tramite la specifica della patch JSON definita in un file.

az dt twin component update -n {instance_or_hostname} --twin-id {twin_id} --component {component_path} --json-patch ./my/patch/document.json

Parametri necessari

--component

Percorso del componente DTDL.

--dt-name --dtn -n

Nome dell'istanza di Gemelli digitali o nome host. Se viene specificato un nome di istanza, la sottoscrizione utente viene prima di tutto eseguita una query per l'istanza di destinazione per recuperare il nome host. Se viene specificato un nome host, la query di sottoscrizione viene ignorata e il valore specificato viene usato per l'interazione successiva.

--json-patch --patch

Specifica di aggiornamento descritta da JSON-patch. Gli aggiornamenti ai valori delle proprietà e agli elementi $model possono verificarsi nella stessa richiesta. Le operazioni sono limitate all'aggiunta, alla sostituzione e alla rimozione. Specificare il percorso del file o il codice JSON inline.

--twin-id -t

ID del gemello digitale.

Parametri facoltativi

--etag -e

Valore del tag di entità. Il comando avrà esito positivo se l'etag corrisponde all'etag corrente per la risorsa.

--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito usando az configure --defaults group={name}.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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