az dt twin relationship

Feljegyzés

Ez a hivatkozás az Azure CLI azure-iot bővítményének része (2.46.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az dt twin kapcsolati parancs első futtatásakor. További információ a bővítményekről.

A Digital Twins-példányok digitális ikerkapcsolatainak kezelése és konfigurálása.

Parancsok

Name	Description	Típus	Állapot
az dt twin relationship create	Hozzon létre kapcsolatot a forrás és a cél digitális ikerpéldányok között.	Mellék	FE
az dt twin relationship delete	Digitális ikerkapcsolat törlése egy Digital Twins-példányon.	Mellék	FE
az dt twin relationship delete-all	Törli az összes digitális ikerkapcsolatot egy Digital Twins-példányon belül, beleértve a bejövő kapcsolatokat is.	Mellék	FE
az dt twin relationship list	Egy digitális ikerpéldány kapcsolatainak listázása.	Mellék	FE
az dt twin relationship show	Egy digitális ikerkapcsolat részleteinek megjelenítése.	Mellék	FE
az dt twin relationship update	Két digitális ikerpéldány közötti kapcsolat tulajdonságainak frissítése JSON-javítás specifikáción keresztül.	Mellék	FE

az dt twin relationship create

Hozzon létre kapcsolatot a forrás és a cél digitális ikerpéldányok között.

A --tulajdonságok lehetnek beágyazott JSON-fájlok vagy fájlelérési utak.

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

Példák

Hozzon létre kapcsolatot két digitális ikerpéldány között.

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

Kapcsolat létrehozása két digitális ikerpéldány között if-none-match címkével

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

Hozzon létre kapcsolatot két digitális ikerpéldány inicializált tulajdonságaival.

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"}'

Kötelező paraméterek

--dt-name --dtn -n

Digital Twins-példány neve vagy állomásneve. Ha meg van adva egy példánynév, a rendszer először lekérdezi a felhasználói előfizetést, hogy a célpéldány lekérje a gazdagépnevet. Ha meg van adva egy gazdagépnév, a rendszer kihagyja az előfizetési lekérdezést, és a megadott értéket használja a rendszer a későbbi interakcióhoz.

--kind --relationship

Kapcsolat neve vagy típusa. Például: "tartalmaz".

--relationship-id -r

Kapcsolatazonosító.

--source --twin-id -t

A kapcsolat forrás ikerazonosítója.

--target --target-twin-id

A kapcsolat cél ikerazonosítója.

Opcionális paraméterek

--if-none-match

Azt jelzi, hogy a létrehozási műveletnek sikertelennek kell lennie, ha egy azonos azonosítóval rendelkező meglévő ikerpéldány létezik.

alapértelmezett érték: False

--properties -p

A digitális ikerkapcsolatok példányosításának kezdeti tulajdonságértékei. Adja meg a fájl elérési útját vagy a beágyazott JSON-t.

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az dt twin relationship delete

Digitális ikerkapcsolat törlése egy Digital Twins-példányon.

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

Példák

Digitális ikerkapcsolat törlése.

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

Digitális ikerkapcsolat törlése az etag használatával.

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

Kötelező paraméterek

--dt-name --dtn -n

Digital Twins-példány neve vagy állomásneve. Ha meg van adva egy példánynév, a rendszer először lekérdezi a felhasználói előfizetést, hogy a célpéldány lekérje a gazdagépnevet. Ha meg van adva egy gazdagépnév, a rendszer kihagyja az előfizetési lekérdezést, és a megadott értéket használja a rendszer a későbbi interakcióhoz.

--relationship-id -r

Kapcsolatazonosító.

--source --twin-id -t

A kapcsolat forrás ikerazonosítója.

Opcionális paraméterek

--etag -e

Entitáscímke értéke. A parancs sikeres lesz, ha az etag megfelel az erőforrás aktuális etagjének.

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az dt twin relationship delete-all

Törli az összes digitális ikerkapcsolatot egy Digital Twins-példányon belül, beleértve a bejövő kapcsolatokat is.

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

Példák

Törölje az ikerpéldányhoz társított összes digitális ikerkapcsolatot.

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

Törölje az összes digitális ikerkapcsolatot a Digital Twins instace-ban.

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

Kötelező paraméterek

--dt-name --dtn -n

Digital Twins-példány neve vagy állomásneve. Ha meg van adva egy példánynév, a rendszer először lekérdezi a felhasználói előfizetést, hogy a célpéldány lekérje a gazdagépnevet. Ha meg van adva egy gazdagépnév, a rendszer kihagyja az előfizetési lekérdezést, és a megadott értéket használja a rendszer a későbbi interakcióhoz.

Opcionális paraméterek

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--source --twin-id -t

A kapcsolat forrás ikerazonosítója.

--yes -y

Ne kérje a megerősítést.

alapértelmezett érték: False

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az dt twin relationship list

Egy digitális ikerpéldány kapcsolatainak listázása.

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

Példák

Egy digitális ikerpéldány kimenő kapcsolatainak listázása.

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

Egy digitális ikerpéldány kimenő kapcsolatainak listázása és a "tartalmaz" kapcsolat szűrése

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

Egy digitális ikerpéldány bejövő kapcsolatainak listázása.

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

Listázz egy digitális ikerpéldány bejövő kapcsolatait, és szűrd a "tartalmaz" kapcsolatra.

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

Kötelező paraméterek

--dt-name --dtn -n

Digital Twins-példány neve vagy állomásneve. Ha meg van adva egy példánynév, a rendszer először lekérdezi a felhasználói előfizetést, hogy a célpéldány lekérje a gazdagépnevet. Ha meg van adva egy gazdagépnév, a rendszer kihagyja az előfizetési lekérdezést, és a megadott értéket használja a rendszer a későbbi interakcióhoz.

--source --twin-id -t

A kapcsolat forrás ikerazonosítója.

Opcionális paraméterek

--incoming

Lekéri a digitális ikerpéldány összes bejövő kapcsolatát.

elfogadott értékek: false, true

alapértelmezett érték: False

--kind --relationship

Az eredmény szűrése a kapcsolat típusa szerint.

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az dt twin relationship show

Egy digitális ikerkapcsolat részleteinek megjelenítése.

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

Példák

Egy digitális ikerkapcsolat részleteinek megjelenítése.

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

Kötelező paraméterek

--dt-name --dtn -n

Digital Twins-példány neve vagy állomásneve. Ha meg van adva egy példánynév, a rendszer először lekérdezi a felhasználói előfizetést, hogy a célpéldány lekérje a gazdagépnevet. Ha meg van adva egy gazdagépnév, a rendszer kihagyja az előfizetési lekérdezést, és a megadott értéket használja a rendszer a későbbi interakcióhoz.

--relationship-id -r

Kapcsolatazonosító.

--source --twin-id -t

A kapcsolat forrás ikerazonosítója.

Opcionális paraméterek

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az dt twin relationship update

Két digitális ikerpéldány közötti kapcsolat tulajdonságainak frissítése JSON-javítás specifikáción keresztül.

A műveletek csak a hozzáadásra, a csere és az eltávolításra korlátozódnak.

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

Példák

Digitális ikerkapcsolat frissítése JSON-javítás specifikációval.

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

Frissítsen egy digitális ikerkapcsolatot JSON-javítás specifikációval és etag használatával.

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}

Digitális ikerkapcsolat frissítése JSON-javítás specifikációval.

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"]}
]'

Frissítsen egy digitális ikerkapcsolatot egy fájlban definiált JSON-javítás specifikációja segítségével.

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

Kötelező paraméterek

--dt-name --dtn -n

Digital Twins-példány neve vagy állomásneve. Ha meg van adva egy példánynév, a rendszer először lekérdezi a felhasználói előfizetést, hogy a célpéldány lekérje a gazdagépnevet. Ha meg van adva egy gazdagépnév, a rendszer kihagyja az előfizetési lekérdezést, és a megadott értéket használja a rendszer a későbbi interakcióhoz.

--json-patch --patch

A JSON-patch által leírt frissítési specifikáció. A tulajdonságértékek és $model elemek frissítése ugyanabban a kérésben történhet. A műveletek csak a hozzáadásra, a csere és az eltávolításra korlátozódnak. Adja meg a fájl elérési útját vagy a beágyazott JSON-t.

--relationship-id -r

Kapcsolatazonosító.

--source --twin-id -t

A kapcsolat forrás ikerazonosítója.

Opcionális paraméterek

--etag -e

Entitáscímke értéke. A parancs sikeres lesz, ha az etag megfelel az erőforrás aktuális etagjének.

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.