Condividi tramite

az dt twin relationship

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

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

Comandi

Nome Descrizione Tipo Status
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 relationship create

Creare una relazione tra gemelli digitali di origine e destinazione.

--properties può essere inline JSON o percorso di file.

az dt twin relationship create --dt-name
                               --kind
                               --relationship-id
                               --source
                               --target
                               [--if-none-match]
                               [--properties]
                               [--resource-group]

Esempio

Creare una relazione tra due gemelli digitali.

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id}

Creare una relazione tra due gemelli digitali con tag if-none-match

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --if-none-match

Creare una relazione con proprietà inizializzate tra due gemelli digitali.

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --properties '{"ownershipUser": "me", "ownershipDepartment": "Computer Science"}'

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.

--kind --relationship

Nome o tipo di relazione. Ad esempio: 'contains'.

--relationship-id -r

ID relazione.

--source --twin-id -t

ID del gemello di origine per una relazione.

--target --target-twin-id

ID del gemello di destinazione per una relazione.

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 una relazione con gemelli digitali. Specificare il percorso del file o il codice JSON inline.

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

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

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

Esempio

Eliminare una relazione con gemelli digitali.

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

Eliminare una relazione con gemelli digitali usando l'etag.

az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_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.

--relationship-id -r

ID relazione.

--source --twin-id -t

ID del gemello di origine per una relazione.

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.

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.

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

Esempio

Eliminare tutte le relazioni tra gemelli digitali associate al gemello.

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

Eliminare tutte le relazioni tra gemelli digitali all'interno dell'ambiente di gemelli digitali.

az dt twin relationship 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 usando az configure --defaults group={name}.

--source --twin-id -t

ID del gemello di origine per una relazione.

--yes -y

Non richiedere conferma.

Valore predefinito: False
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 relationship list

Elencare le relazioni di un gemello digitale.

az dt twin relationship list --dt-name
                             --source
                             [--incoming {false, true}]
                             [--kind]
                             [--resource-group]

Esempio

Elencare le relazioni in uscita di un gemello digitale.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id}

Elencare le relazioni in uscita di un gemello digitale e filtrare la relazione 'contains'

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains

Elencare le relazioni in ingresso di un gemello digitale.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --incoming

Elencare le relazioni in ingresso di un gemello digitale e filtrare la relazione 'contains'.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains --incoming

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.

--source --twin-id -t

ID del gemello di origine per una relazione.

Parametri facoltativi

--incoming

Recupera tutte le relazioni in ingresso per un gemello digitale.

Valori accettati: false, true
Valore predefinito: False
--kind --relationship

Filtra il risultato in base al tipo di relazione.

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

Mostra i dettagli di una relazione con un gemello digitale.

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

Esempio

Mostra i dettagli di una relazione con un gemello digitale.

az dt twin relationship show -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_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.

--relationship-id -r

ID relazione.

--source --twin-id -t

ID del gemello di origine per una relazione.

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

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

Le operazioni sono limitate all'aggiunta, alla sostituzione e alla rimozione.

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

Esempio

Aggiornare una relazione tra gemelli digitali tramite la specifica della patch JSON.

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

Aggiornare una relazione tra gemelli digitali tramite la specifica della patch JSON e usare etag.

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

Aggiornare una relazione tra gemelli digitali tramite la specifica della patch JSON.

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

Aggiornare una relazione tra gemelli digitali tramite la specifica della patch JSON definita in un file.

az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --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.

--relationship-id -r

ID relazione.

--source --twin-id -t

ID del gemello di origine per una relazione.

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.