Condividi tramite


az dt twin

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

Gestire e configurare i gemelli digitali di un'istanza di Gemelli digitali.

Comandi

Nome Descrizione Tipo Stato
az dt twin component

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

Estensione Disponibilità generale
az dt twin component show

Mostra i dettagli di un componente del gemello digitale.

Estensione Disponibilità generale
az dt twin component update

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

Estensione Disponibilità generale
az dt twin create

Creare un gemello digitale in un'istanza di .

Estensione Disponibilità generale
az dt twin delete

Rimuovere un gemello digitale. Tutte le relazioni che fanno riferimento a questo gemello devono essere già eliminate.

Estensione Disponibilità generale
az dt twin delete-all

Elimina tutti i gemelli digitali all'interno di un'istanza di Gemelli digitali, incluse tutte le relazioni per tali gemelli.

Estensione Disponibilità generale
az dt twin query

Eseguire una query sui gemelli digitali di un'istanza di . Consente di attraversare le relazioni e filtrare in base ai valori delle proprietà.

Estensione Disponibilità generale
az dt twin relationship

Gestire e configurare le relazioni tra gemelli digitali di un'istanza di Gemelli digitali.

Estensione Disponibilità generale
az dt twin relationship create

Creare una relazione tra gemelli digitali di origine e destinazione.

Estensione Disponibilità generale
az dt twin relationship delete

Eliminare una relazione tra gemelli digitali in un'istanza di Gemelli digitali.

Estensione Disponibilità generale
az dt twin relationship delete-all

Elimina tutte le relazioni tra gemelli digitali all'interno di un'istanza di Gemelli digitali, incluse le relazioni in ingresso.

Estensione Disponibilità generale
az dt twin relationship list

Elencare le relazioni di un gemello digitale.

Estensione Disponibilità generale
az dt twin relationship show

Mostra i dettagli di una relazione con un gemello digitale.

Estensione Disponibilità generale
az dt twin relationship update

Aggiorna le proprietà di una relazione tra due gemelli digitali tramite la specifica della patch JSON.

Estensione Disponibilità generale
az dt twin show

Visualizzare i dettagli di un gemello digitale.

Estensione Disponibilità generale
az dt twin telemetry

Testare e convalidare le route di eventi e gli endpoint di un'istanza di Gemelli digitali.

Estensione Disponibilità generale
az dt twin telemetry send

Invia i dati di telemetria per conto di un gemello digitale. Se viene fornito il percorso del componente, i dati di telemetria generati sono per conto del componente.

Estensione Disponibilità generale
az dt twin update

Aggiornare un gemello digitale dell'istanza tramite la specifica della patch JSON.

Estensione Disponibilità generale

az dt twin create

Creare un gemello digitale in un'istanza di .

--properties può essere inline JSON o percorso di file. Nota: le proprietà --sono necessarie per i dispositivi gemelli che contengono componenti.

az dt twin create --dt-name
                  --dtmi
                  --twin-id
                  [--if-none-match]
                  [--properties]
                  [--resource-group]

Esempio

Creare un gemello digitale da un modello esistente (creato in precedenza).

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id}

Creare un gemello digitale da un modello esistente (creato in precedenza) con tag if-none-match.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id} --if-none-match

Creare un gemello digitale da un modello esistente (creato in precedenza). Creare un'istanza con i valori delle proprietà.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:DeviceInformation;1" --twin-id {twin_id} --properties '{"manufacturer": "Microsoft"}'

Creare un gemello digitale con un componente da modelli esistenti (creati in precedenza). Creare un'istanza del componente con le proprietà minime.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
    "Thermostat": {
        "$metadata": {},
    }
}'

Creare un gemello digitale con un componente da modelli esistenti (creati in precedenza). Creare un'istanza con i valori delle proprietà.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
    "Temperature": 10.2,
    "Thermostat": {
        "$metadata": {},
        "setPointTemp": 23.12
    }
}'

Parametri necessari

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

--dtmi --model-id -m

ID modello di Gemelli digitali. Esempio: dtmi:com:example:Room;2.

--twin-id -t

ID del gemello digitale.

Parametri facoltativi

--if-none-match

Indica che l'operazione di creazione deve avere esito negativo se esiste un gemello esistente con lo stesso ID.

valore predefinito: False
--properties -p

Valori iniziali delle proprietà per la creazione di un'istanza di un gemello digitale o di componenti correlati. Specificare il percorso del file o il codice JSON inline. Le proprietà sono necessarie per i gemelli che contengono componenti, come minimo è necessario specificare un oggetto $metadata vuoto per ogni componente.

--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È 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 dt twin delete

Rimuovere un gemello digitale. Tutte le relazioni che fanno riferimento a questo gemello devono essere già eliminate.

az dt twin delete --dt-name
                  --twin-id
                  [--etag]
                  [--resource-group]

Esempio

Rimuovere un gemello digitale in base all'ID.

az dt twin delete -n {instance_or_hostname} --twin-id {twin_id}

Rimuovere un gemello digitale in base all'ID usando l'etag.

az dt twin delete -n {instance_or_hostname} --twin-id {twin_id} --etag {etag}

Parametri necessari

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

--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 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 dt twin delete-all

Elimina tutti i gemelli digitali all'interno di un'istanza di Gemelli digitali, incluse tutte le relazioni per tali gemelli.

az dt twin delete-all --dt-name
                      [--resource-group]
                      [--yes]

Esempio

Eliminare tutti i gemelli digitali. Verranno eliminate anche eventuali relazioni che fanno riferimento ai gemelli.

az dt twin delete-all -n {instance_or_hostname}

Parametri necessari

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

Parametri facoltativi

--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
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 dt twin query

Eseguire una query sui gemelli digitali di un'istanza di . Consente di attraversare le relazioni e filtrare in base ai valori delle proprietà.

In molte query gemelle, il $ carattere viene usato per fare riferimento alla $dtId proprietà di un gemello. Nelle shell simili a bash o powershell il $ carattere ha un significato funzionale e deve essere preceduto da un carattere di escape come parte dell'input della query. Per altre informazioni, vedere il documento https://docs.microsoft.com/en-us/azure/digital-twins/concepts-cli concetti relativi all'interfaccia della riga di comando di Gemelli digitali.

az dt twin query --dt-name
                 --query-command
                 [--cost {false, true}]
                 [--resource-group]

Esempio

Eseguire query su tutti i gemelli digitali nell'istanza di destinazione e proiettare tutti gli attributi. Visualizzare anche i costi nelle unità di query.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins" --show-cost

Eseguire query in base al modello e proiettare tutti gli attributi.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins T where IS_OF_MODEL(T, 'dtmi:com:example:Room;2')"

Query che sfrutta '$dtId' con sintassi compatibile con bash

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.\$dtId = 'room0'"

Query che sfrutta '$dtId' con la sintassi compatibile con PowerShell

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.`$dtId = 'room0'"

Parametri necessari

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

--query-command -q

Query utente da eseguire.

Parametri facoltativi

--cost --show-cost

Calcola e mostra l'addebito della query.

valori accettati: false, true
valore predefinito: False
--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È 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 dt twin show

Visualizzare i dettagli di un gemello digitale.

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

Esempio

Visualizzare i dettagli di un gemello digitale.

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

Parametri necessari

--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 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 dt twin update

Aggiornare un gemello digitale dell'istanza 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 update --dt-name
                  --json-patch
                  --twin-id
                  [--etag]
                  [--resource-group]

Esempio

Aggiornare un gemello digitale tramite la specifica della patch JSON.

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

Aggiornare un gemello digitale tramite la specifica della patch JSON e usando etag.

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

Aggiornare un gemello digitale tramite la specifica della patch JSON.

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

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

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

Parametri necessari

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