az dt twin

Megjegyzés

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

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

Parancsok

az dt twin component	Egy Digital Twins-példány digitális ikerpéldány-összetevőinek megjelenítése és frissítése.
az dt twin component show	Egy digitális ikerpéldány részleteinek megjelenítése.
az dt twin component update	Digitális ikerpéldány frissítése JSON-javítás specifikáción keresztül.
az dt twin create	Hozzon létre egy digitális ikerpéldányt egy példányon.
az dt twin delete	Digitális ikerpéldány eltávolítása. Az ikerpéldányra hivatkozó összes kapcsolatot már törölni kell.
az dt twin delete-all	Törli az összes digitális ikerpéldányt egy Digital Twins-példányon belül, beleértve az ikerpéldányok összes kapcsolatát is.
az dt twin query	Egy példány digitális ikerpéldányainak lekérdezése. Lehetővé teszi a kapcsolatok bejárását és a tulajdonságértékek szerinti szűrést.
az dt twin relationship	A Digital Twins-példányok digitális ikerkapcsolatainak kezelése és konfigurálása.
az dt twin relationship create	Kapcsolat létrehozása a forrás és a cél digitális ikerpéldányok között.
az dt twin relationship delete	Digitális ikerpéldányok közötti kapcsolat törlése.
az dt twin relationship delete-all	Törli a Digital Twins-példányon belüli összes digitális ikerkapcsolatot, beleértve a bejövő kapcsolatokat is.
az dt twin relationship list	Egy digitális ikerpéldány kapcsolatainak listázása.
az dt twin relationship show	Digitális ikerkapcsolat részleteinek megjelenítése.
az dt twin relationship update	Frissítések két digitális ikerpéldány közötti kapcsolat tulajdonságait JSON-javítás specifikáción keresztül.
az dt twin show	Egy digitális ikerpéldány részleteinek megjelenítése.
az dt twin telemetry	Egy Digital Twins-példány eseményútvonalainak és végpontjainak tesztelése és ellenőrzése.
az dt twin telemetry send	Telemetriát küld egy digitális ikerpéldány nevében. Ha az összetevő elérési útja meg van adva, a kibocsátott telemetriai adatok az összetevő nevében szerepelnek.
az dt twin update	Egy digitális ikerpéldány frissítése JSON-javítás specifikáción keresztül.

az dt twin create

Hozzon létre egy digitális ikerpéldányt egy példányon.

A tulajdonságok lehetnek beágyazott JSON-fájlok vagy fájlelérési utak. Megjegyzés: A --tulajdonságok az összetevőket tartalmazó ikerpéldányokhoz szükségesek.

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

Példák

Digitális ikerpéldány létrehozása meglévő (korábban létrehozott) modellből.

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

Hozzon létre egy digitális ikerpéldányt egy meglévő (korábban létrehozott) modellből if-none-match címkével.

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

Digitális ikerpéldány létrehozása meglévő (korábban létrehozott) modellből. Példányosítás tulajdonságértékekkel.

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

Digitális ikerpéldány létrehozása meglévő (korábban létrehozott) modellekből származó összetevővel. Az összetevő példányosítása minimális tulajdonságokkal.

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

Digitális ikerpéldány létrehozása meglévő (korábban létrehozott) modellekből származó összetevővel. Példányosítás tulajdonságértékekkel.

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

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 a célpéldányhoz a gazdagépnév lekéréséhez. 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 későbbi interakcióhoz.

--dtmi --model-id -m

Digital Twins modellazonosító. Példa: dtmi:com:example:Room;2.

--twin-id -t

A digitális ikerpéldány azonosítója.

Opcionális paraméterek

--if-none-match

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

--properties -p

A digitális ikerpéldányok vagy kapcsolódó összetevők 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. Az összetevőket tartalmazó ikerpéldányok tulajdonságaira van szükség, de legalább minden összetevőhöz meg kell adnia egy üres $metadata objektumot.

--resource-group -g

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

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az dt twin delete

Digitális ikerpéldány eltávolítása. Az ikerpéldányra hivatkozó összes kapcsolatot már törölni kell.

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

Példák

Digitális ikerpéldány eltávolítása azonosító alapján.

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

Digitális ikerpéldány eltávolítása azonosító alapján az etag használatával.

az dt twin delete -n {instance_or_hostname} --twin-id {twin_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 a célpéldányhoz a gazdagépnév lekéréséhez. 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 későbbi interakcióhoz.

--twin-id -t

A digitális ikerpéldány azonosí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 a következővel az configure --defaults group=<name>konfigurálhatja: .

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az dt twin delete-all

Törli az összes digitális ikerpéldányt egy Digital Twins-példányon belül, beleértve az ikerpéldányok összes kapcsolatát is.

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

Példák

Törölje az összes digitális ikerpéldányt. Az ikerpéldányokra hivatkozó kapcsolatok is törlődnek.

az dt twin 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 a célpéldányhoz a gazdagépnév lekéréséhez. 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 későbbi interakcióhoz.

Opcionális paraméterek

--resource-group -g

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

--yes -y

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

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az dt twin query

Lekérdezheti egy példány digitális ikerpéldányait. Lehetővé teszi a kapcsolatok bejárását és a tulajdonságértékek szerinti szűrést.

Sok iker lekérdezésben a $ karakter egy ikerpéldány tulajdonságára hivatkozik $dtId . Bash-szerű rendszerhéjakban vagy PowerShellben a $ karakternek funkcionális jelentése van, és a lekérdezés bemeneteként kell megmenekülnie. További információért tekintse át a Digital Twins CLI alapfogalmait ismertető dokumentumot https://docs.microsoft.com/en-us/azure/digital-twins/concepts-cli .

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

Példák

Lekérdezheti a célpéldány összes digitális ikerpéldányát, és kivetítheti az összes attribútumot. A költség megjelenítése lekérdezési egységekben is.

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

Az összes attribútum lekérdezése modell és projekt alapján.

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

Lekérdezés a "$dtId" bash-kompatibilis szintaxissal való használatával

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

A "$dtId" lekérdezése PowerShell-kompatibilis szintaxissal

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

Kötelező paraméterek

--dt-name --dtn -n

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

--query-command -q

A végrehajtandó felhasználói lekérdezés.

Opcionális paraméterek

--cost --show-cost

Kiszámítja és megjeleníti a lekérdezési díjat.

elfogadott értékek: false, true

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az dt twin show

Egy digitális ikerpéldány részleteinek megjelenítése.

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

Példák

Egy digitális ikerpéldány részleteinek megjelenítése.

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

Kötelező paraméterek

--dt-name --dtn -n

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

--twin-id -t

A digitális ikerpéldány azonosítója.

Opcionális paraméterek

--resource-group -g

Digital Twins-példány erőforráscsoportja. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az dt twin update

Egy digitális ikerpéldány frissítése JSON-javítás specifikáción keresztül.

Frissítések tulajdonságértékek és $model elemek ugyanabban a kérésben fordulhatnak elő. A műveletek hozzáadására, cseréjére és eltávolítására korlátozódnak.

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

Példák

Digitális ikerpéldány frissítése JSON-javítás specifikáción keresztül.

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

Digitális ikerpéldány frissítése JSON-javítás specifikációja és etag használatával.

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

Digitális ikerpéldány frissítése JSON-javítás specifikáción keresztül.

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

Frissítsen egy digitális ikerpéldányt egy fájlban definiált JSON-javítás specifikációja alapján.

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

Kötelező paraméterek

--dt-name --dtn -n

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

--json-patch --patch

A JSON-patch által leírt frissítési specifikáció. Frissítések tulajdonságértékek és $model elemek ugyanabban a kérésben fordulhatnak elő. A műveletek hozzáadására, cseréjére és eltávolítására korlátozódnak. Adja meg a fájl elérési útját vagy a beágyazott JSON-t.

--twin-id -t

A digitális ikerpéldány azonosí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 a használatával az configure --defaults group=<name>konfigurálhatja.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.