az dt twin

Note

Questo riferimento fa parte dell'estensione azure-iot per l'interfaccia della riga di comando di Azure (versione 2.67.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.	Extension	GA
az dt twin component show	Mostra i dettagli di un componente del gemello digitale.	Extension	GA
az dt twin component update	Aggiornare un componente del gemello digitale tramite la specifica della patch JSON.	Extension	GA
az dt twin create	Creare un gemello digitale in un'istanza di .	Extension	GA
az dt twin delete	Rimuovere un gemello digitale. Tutte le relazioni che fanno riferimento a questo gemello devono essere già eliminate.	Extension	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.	Extension	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à.	Extension	GA
az dt twin relationship	Gestire e configurare le relazioni tra gemelli digitali di un'istanza di Gemelli digitali.	Extension	GA
az dt twin relationship create	Creare una relazione tra gemelli digitali di origine e destinazione.	Extension	GA
az dt twin relationship delete	Eliminare una relazione tra gemelli digitali in un'istanza di Gemelli digitali.	Extension	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.	Extension	GA
az dt twin relationship list	Elencare le relazioni di un gemello digitale.	Extension	GA
az dt twin relationship show	Mostra i dettagli di una relazione con un gemello digitale.	Extension	GA
az dt twin relationship update	Aggiorna le proprietà di una relazione tra due gemelli digitali tramite la specifica della patch JSON.	Extension	GA
az dt twin show	Visualizzare i dettagli di un gemello digitale.	Extension	GA
az dt twin telemetry	Testare e convalidare le route di eventi e gli endpoint di un'istanza di Gemelli digitali.	Extension	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.	Extension	GA
az dt twin update	Aggiornare un gemello digitale dell'istanza tramite la specifica della patch JSON.	Extension	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 --dtn
                  --dtmi --model-id
                  --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

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--if-none-match

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

Proprietà	Valore
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 usando az configure --defaults group={name}.

Parametri globali

--debug

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

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

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

Proprietà	Valore
Valore predefinito:	False

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

--twin-id -t

ID del gemello digitale.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

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

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

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

Proprietà	Valore
Valore predefinito:	False

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--resource-group -g

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

--yes -y

Non richiedere conferma.

Proprietà	Valore
Valore predefinito:	False

Parametri globali

--debug

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

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

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

Proprietà	Valore
Valore predefinito:	False

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 --dtn
                 --query-command
                 [--cost --show-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

--query-command -q

Query utente da eseguire.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--cost --show-cost

Calcola e mostra l'addebito della query.

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

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

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

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

Proprietà	Valore
Valore predefinito:	False

az dt twin show

Visualizzare i dettagli di un gemello digitale.

az dt twin show --dt-name --dtn
                --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

--twin-id -t

ID del gemello digitale.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

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

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

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

Proprietà	Valore
Valore predefinito:	False

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 --dtn
                  --json-patch --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

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

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

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

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

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

Proprietà	Valore
Valore predefinito:	False

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

az dt twin

Comandi

az dt twin create

Esempio

Parametri necessari

Parametri facoltativi

az dt twin delete

Esempio

Parametri necessari

Parametri facoltativi

az dt twin delete-all

Esempio

Parametri necessari

Parametri facoltativi

az dt twin query

Esempio

Parametri necessari

Parametri facoltativi

az dt twin show

Esempio

Parametri necessari

Parametri facoltativi

az dt twin update

Esempio

Parametri necessari

Parametri facoltativi

Commenti e suggerimenti