Share via

az dt twin

  • Referens

Kommentar

Den här referensen är en del av azure-iot-tillägget för Azure CLI (version 2.37.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az dt twin-kommando . Läs mer om tillägg.

Hantera och konfigurera digitala tvillingar för en Digital Twins-instans.

Kommandon

Name Description Typ Status
az dt twin component

Visa och uppdatera komponenterna för digitala tvillingar i en Digital Twins-instans.

 Anknytning Allmän tillgänglighet
az dt twin component show

Visa information om en digital tvillingkomponent.

 Anknytning Allmän tillgänglighet
az dt twin component update

Uppdatera en digital tvillingkomponent via JSON-korrigeringsspecifikationen.

 Anknytning Allmän tillgänglighet
az dt twin create

Skapa en digital tvilling på en instans.

 Anknytning Allmän tillgänglighet
az dt twin delete

Ta bort en digital tvilling. Alla relationer som refererar till den här tvillingen måste redan tas bort.

 Anknytning Allmän tillgänglighet
az dt twin delete-all

Tar bort alla digitala tvillingar i en Digital Twins-instans, inklusive alla relationer för dessa tvillingar.

 Anknytning Allmän tillgänglighet
az dt twin query

Fråga digitala tvillingar för en instans. Tillåter bläddring av relationer och filtrering efter egenskapsvärden.

 Anknytning Allmän tillgänglighet
az dt twin relationship

Hantera och konfigurera digitala tvillingrelationer för en Digital Twins-instans.

 Anknytning Allmän tillgänglighet
az dt twin relationship create

Skapa en relation mellan digitala käll- och måltvillingar.

 Anknytning Allmän tillgänglighet
az dt twin relationship delete

Ta bort en digital tvillingrelation på en Digital Twins-instans.

 Anknytning Allmän tillgänglighet
az dt twin relationship delete-all

Tar bort alla digitala tvillingrelationer i en Digital Twins-instans, inklusive inkommande relationer.

 Anknytning Allmän tillgänglighet
az dt twin relationship list

Visa en lista över relationerna för en digital tvilling.

 Anknytning Allmän tillgänglighet
az dt twin relationship show

Visa information om en digital tvillingrelation.

 Anknytning Allmän tillgänglighet
az dt twin relationship update

Uppdateringar egenskaperna för en relation mellan två digitala tvillingar via JSON-korrigeringsspecifikationen.

 Anknytning Allmän tillgänglighet
az dt twin show

Visa information om en digital tvilling.

 Anknytning Allmän tillgänglighet
az dt twin telemetry

Testa och verifiera händelsevägar och slutpunkter för en Digital Twins-instans.

 Anknytning Allmän tillgänglighet
az dt twin telemetry send

Skickar telemetri för en digital tvillings räkning. Om komponentsökvägen anges är den utsända telemetrin för komponentens räkning.

 Anknytning Allmän tillgänglighet
az dt twin update

Uppdatera en digital instanstvilling via JSON-korrigeringsspecifikationen.

 Anknytning Allmän tillgänglighet

az dt twin create

Skapa en digital tvilling på en instans.

--properties kan vara infogad JSON eller filsökväg. Obs! --egenskaper krävs för tvillingar som innehåller komponenter.

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

Exempel

Skapa en digital tvilling från en befintlig (tidigare skapad) modell.

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

Skapa en digital tvilling från en befintlig (tidigare skapad) modell med taggen if-none-match.

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

Skapa en digital tvilling från en befintlig (tidigare skapad) modell. Instansiera med egenskapsvärden.

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

Skapa en digital tvilling med komponent från befintliga (tidigare skapade) modeller. Instansiera komponent med minsta egenskaper.

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

Skapa en digital tvilling med komponent från befintliga (tidigare skapade) modeller. Instansiera med egenskapsvärden.

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

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--dtmi --model-id -m

Digital Twins modell-ID. Exempel: dtmi:com:example:Room;2.

--twin-id -t

Det digitala tvilling-ID:t.

Valfria parametrar

--if-none-match

Anger att åtgärden create ska misslyckas om det finns en befintlig tvilling med samma ID.

standardvärde: False
--properties -p

Inledande egenskapsvärden för instansiering av en digital tvilling eller relaterade komponenter. Ange filsökväg eller infogad JSON. Egenskaper krävs för tvillingar som innehåller komponenter. Du måste minst ange ett tomt $metadata objekt för varje komponent.

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt twin delete

Ta bort en digital tvilling. Alla relationer som refererar till den här tvillingen måste redan tas bort.

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

Exempel

Ta bort en digital tvilling med ID.

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

Ta bort en digital tvilling med ID med hjälp av etag.

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

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--twin-id -t

Det digitala tvilling-ID:t.

Valfria parametrar

--etag -e

Entitetstaggvärde. Kommandot lyckas om etag matchar resursens aktuella etag.

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt twin delete-all

Tar bort alla digitala tvillingar i en Digital Twins-instans, inklusive alla relationer för dessa tvillingar.

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

Exempel

Ta bort alla digitala tvillingar. Alla relationer som refererar till tvillingarna tas också bort.

az dt twin delete-all -n {instance_or_hostname}

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

Valfria parametrar

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--yes -y

Fråga inte efter bekräftelse.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt twin query

Fråga digitala tvillingar för en instans. Tillåter bläddring av relationer och filtrering efter egenskapsvärden.

I många tvillingfrågor $ används tecknet för att referera till egenskapen för $dtId en tvilling. I bash-liknande gränssnitt eller powershell $ har tecknet funktionell betydelse och måste vara undantagen som en del av frågeindata. Mer information finns i dokumentet https://docs.microsoft.com/en-us/azure/digital-twins/concepts-cli om Koncept för Digital Twins CLI.

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

Exempel

Fråga alla digitala tvillingar i målinstansen och projicera alla attribut. Visa även kostnaden i frågeenheter.

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

Fråga efter modell och projekt alla attribut.

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

Fråga som använder "$dtId" med bash-kompatibel syntax

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

Fråga som använder "$dtId" med powershell-kompatibel syntax

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

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--query-command -q

Användarfråga som ska köras.

Valfria parametrar

--cost --show-cost

Beräknar och visar frågeavgiften.

accepterade värden: false, true
standardvärde: False
--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt twin show

Visa information om en digital tvilling.

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

Exempel

Visa information om en digital tvilling.

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

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--twin-id -t

Det digitala tvilling-ID:t.

Valfria parametrar

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt twin update

Uppdatera en digital instanstvilling via JSON-korrigeringsspecifikationen.

Uppdateringar till egenskapsvärden och $model element kan inträffa i samma begäran. Åtgärderna är begränsade till att lägga till, ersätta och ta bort.

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

Exempel

Uppdatera en digital tvilling via JSON-korrigeringsspecifikationen.

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

Uppdatera en digital tvilling via JSON-korrigeringsspecifikationen och använda etag.

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

Uppdatera en digital tvilling via JSON-korrigeringsspecifikationen.

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

Uppdatera en digital tvilling via JSON-korrigeringsspecifikationen som definierats i en fil.

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

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--json-patch --patch

En uppdateringsspecifikation som beskrivs av JSON-patch. Uppdateringar till egenskapsvärden och $model element kan inträffa i samma begäran. Åtgärderna är begränsade till att lägga till, ersätta och ta bort. Ange filsökväg eller infogad JSON.

--twin-id -t

Det digitala tvilling-ID:t.

Valfria parametrar

--etag -e

Entitetstaggvärde. Kommandot lyckas om etag matchar resursens aktuella etag.

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.