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 | Status |
---|---|---|---|
az dt twin component |
Visualizzare e aggiornare i componenti del gemello digitale di un'istanza di Gemelli digitali. |
Estensione | GA |
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 create |
Creare un gemello digitale in un'istanza di . |
Estensione | GA |
az dt twin delete |
Rimuovere un gemello digitale. Tutte le relazioni che fanno riferimento a questo gemello devono essere già eliminate. |
Estensione | GA |
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 | GA |
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 | GA |
az dt twin relationship |
Gestire e configurare le relazioni tra gemelli digitali di un'istanza di Gemelli digitali. |
Estensione | GA |
az dt twin relationship create |
Creare una relazione tra gemelli digitali di origine e destinazione. |
Estensione | GA |
az dt twin relationship delete |
Eliminare una relazione tra gemelli digitali in un'istanza di Gemelli digitali. |
Estensione | GA |
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 | GA |
az dt twin relationship list |
Elencare le relazioni di un gemello digitale. |
Estensione | GA |
az dt twin relationship show |
Mostra i dettagli di una relazione con un gemello digitale. |
Estensione | GA |
az dt twin relationship update |
Aggiorna le proprietà di una relazione tra due gemelli digitali tramite la specifica della patch JSON. |
Estensione | GA |
az dt twin show |
Visualizzare i dettagli di un gemello digitale. |
Estensione | GA |
az dt twin telemetry |
Testare e convalidare le route di eventi e gli endpoint di un'istanza di Gemelli digitali. |
Estensione | GA |
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 | GA |
az dt twin update |
Aggiornare un gemello digitale dell'istanza tramite la specifica della patch JSON. |
Estensione | GA |
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
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.
ID modello di Gemelli digitali. Esempio: dtmi:com:example:Room;2.
ID del gemello digitale.
Parametri facoltativi
Indica che l'operazione di creazione deve avere esito negativo se esiste un gemello esistente con lo stesso ID.
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.
Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito usando az configure --defaults group={name}
.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare 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
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.
ID del gemello digitale.
Parametri facoltativi
Valore del tag di entità. Il comando avrà esito positivo se l'etag corrisponde all'etag corrente per la risorsa.
Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito usando az configure --defaults group={name}
.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare 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
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
Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito usando az configure --defaults group={name}
.
Non richiedere conferma.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare 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 proprietà $dtId
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 concetti relativi all'interfaccia della riga di comando di Gemelli digitali https://learn.microsoft.com/en-us/azure/digital-twins/concepts-cli.
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
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 utente da eseguire.
Parametri facoltativi
Calcola e mostra l'addebito della query.
Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito usando az configure --defaults group={name}
.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare 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
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.
ID del gemello digitale.
Parametri facoltativi
Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito usando az configure --defaults group={name}
.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare 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
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.
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.
ID del gemello digitale.
Parametri facoltativi
Valore del tag di entità. Il comando avrà esito positivo se l'etag corrisponde all'etag corrente per la risorsa.
Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito usando az configure --defaults group={name}
.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.