az dt twin

Referencia

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

Name	Description	Típus	Állapot
az dt twin component	A Digital Twins-példány digitális ikerösszetevőinek megjelenítése és frissítése.	Mellék	FE
az dt twin component show	Digitális ikerösszetevő részleteinek megjelenítése.	Mellék	FE
az dt twin component update	Digitális ikerösszetevő frissítése JSON-javítás specifikációval.	Mellék	FE
az dt twin create	Hozzon létre egy digitális ikerpéldányt egy példányon.	Mellék	FE
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.	Mellék	FE
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.	Mellék	FE
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.	Mellék	FE
az dt twin relationship	A Digital Twins-példányok digitális ikerkapcsolatainak kezelése és konfigurálása.	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.	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 show	Egy digitális ikerpéldány részleteinek megjelenítése.	Mellék	FE
az dt twin telemetry	Egy Digital Twins-példány eseményútvonalainak és végpontjainak tesztelése és ellenőrzése.	Mellék	FE
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 telemetria az összetevő nevében történik.	Mellék	FE
az dt twin update	Egy példány digitális ikerpéldányának frissítése JSON-javítás specifikációval.	Mellék	FE

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: --tulajdonságok szükségesek az összetevőket tartalmazó ikerpéldányokhoz.

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

Példák

Hozzon létre egy digitális ikerpéldányt egy 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

Hozzon létre egy digitális ikerpéldányt egy 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"}'

Hozzon létre egy digitális ikerpéldányt meglévő (korábban létrehozott) modellek összetevőjé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": {},
    }
}'

Hozzon létre egy digitális ikerpéldányt meglévő (korábban létrehozott) modellek összetevőjé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, 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.

--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 egy azonos azonosítóval rendelkező meglévő ikerpéldány létezik.

alapértelmezett érték: False

--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, legalább egy üres $metadata objektumot kell megadnia az egyes összetevőkhöz.

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

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

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

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

Sok iker lekérdezésben a $ karakter egy ikerpéldány tulajdonságára hivatkozik $dtId . A bash-szerű rendszerhéjakban vagy a PowerShellben a $ karakter funkcionális jelentéssel rendelkezik, és a lekérdezési bemenet részeként kell megmenekülnie. További információké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 a lekérdezési egységekben is.

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

Lekérdezés modell szerint, és az összes attribútum kivetítése.

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

A "$dtId" lekérdezés bash-kompatibilis szintaxissal

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

--query-command -q

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

alapértelmezett érték: False

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

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

Egy példány digitális ikerpéldányának frissítése JSON-javítás specifikációval.

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.

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

Példák

Frissítsen egy digitális ikerpéldányt 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}'

Frissítsen egy digitális ikerpéldányt JSON-javítás specifikációval é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}'

Frissítsen egy digitális ikerpéldányt 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

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

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

Megosztás a következőn keresztül:

az dt twin

Parancsok

az dt twin create

Példák

Kötelező paraméterek

Opcionális paraméterek

az dt twin delete

Példák

Kötelező paraméterek

Opcionális paraméterek

az dt twin delete-all

Példák

Kötelező paraméterek

Opcionális paraméterek

az dt twin query

Példák

Kötelező paraméterek

Opcionális paraméterek

az dt twin show

Példák

Kötelező paraméterek

Opcionális paraméterek

az dt twin update

Példák

Kötelező paraméterek

Opcionális paraméterek

További források