az dt twin

Reference

Poznámka:

Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.46.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az dt twin . Přečtěte si další informace o rozšířeních.

Správa a konfigurace digitálních dvojčat instance služby Digital Twins

Příkazy

Name	Description	Typ	Stav
az dt twin component	Zobrazí a aktualizuje komponenty digitálního dvojčete instance služby Digital Twins.	Rozšíření	GA
az dt twin component show	Zobrazení podrobností o komponentě digitálního dvojčete	Rozšíření	GA
az dt twin component update	Aktualizujte komponentu digitálního dvojčete prostřednictvím specifikace oprav JSON.	Rozšíření	GA
az dt twin create	Vytvořte digitální dvojče v instanci.	Rozšíření	GA
az dt twin delete	Odeberte digitální dvojče. Všechny relace odkazující na toto dvojče již musí být odstraněny.	Rozšíření	GA
az dt twin delete-all	Odstraní všechna digitální dvojčata v instanci služby Digital Twins, včetně všech relací pro tato dvojčata.	Rozšíření	GA
az dt twin query	Zadejte dotaz na digitální dvojčata instance. Umožňuje procházení relací a filtrování podle hodnot vlastností.	Rozšíření	GA
az dt twin relationship	Umožňuje spravovat a konfigurovat vztahy digitálních dvojčat instance služby Digital Twins.	Rozšíření	GA
az dt twin relationship create	Vytvořte relaci mezi zdrojovými a cílovými digitálními dvojčaty.	Rozšíření	GA
az dt twin relationship delete	Odstraňte relaci digitálního dvojčete v instanci služby Digital Twins.	Rozšíření	GA
az dt twin relationship delete-all	Odstraní všechny relace digitálních dvojčat v instanci služby Digital Twins, včetně příchozích relací.	Rozšíření	GA
az dt twin relationship list	Uveďte vztahy digitálního dvojčete.	Rozšíření	GA
az dt twin relationship show	Umožňuje zobrazit podrobnosti vztahu digitálního dvojčete.	Rozšíření	GA
az dt twin relationship update	Aktualizuje vlastnosti relace mezi dvěma digitálními dvojčaty prostřednictvím specifikace opravy JSON.	Rozšíření	GA
az dt twin show	Zobrazí podrobnosti digitálního dvojčete.	Rozšíření	GA
az dt twin telemetry	Otestujte a ověřte trasy a koncové body událostí instance služby Digital Twins.	Rozšíření	GA
az dt twin telemetry send	Odesílá telemetrii jménem digitálního dvojčete. Pokud je zadanou cestou ke komponentě generovaná telemetrie, je za komponentu.	Rozšíření	GA
az dt twin update	Aktualizace digitálního dvojčete instance prostřednictvím specifikace oprav JSON	Rozšíření	GA

az dt twin create

Vytvořte digitální dvojče v instanci.

--properties může být vložený JSON nebo cesta k souboru. Poznámka: --properties jsou vyžadovány pro dvojčata, která obsahují součásti.

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

Příklady

Vytvoření digitálního dvojčete z existujícího (předchozího vytvořeného) modelu

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

Vytvořte digitální dvojče z existujícího (předchozího vytvořeného) modelu se značkou if-none-match.

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

Vytvoření digitálního dvojčete z existujícího (předchozího vytvořeného) modelu Vytvořte instanci s hodnotami vlastností.

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

Vytvořte digitální dvojče s komponentou z existujících (předchozích vytvořených) modelů. Vytvořte instanci komponenty s minimálními vlastnostmi.

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

Vytvořte digitální dvojče s komponentou z existujících (předchozích vytvořených) modelů. Vytvořte instanci s hodnotami vlastností.

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

Povinné parametry

--dt-name --dtn -n

Název instance služby Digital Twins nebo název hostitele Pokud je zadaný název instance, uživatelské předplatné se nejprve dotazuje na cílovou instanci, aby načetl název hostitele. Pokud je zadaný název hostitele, dotaz předplatného se přeskočí a zadaná hodnota se použije k následné interakci.

--dtmi --model-id -m

ID modelu Digital Twins. Příklad: dtmi:com:example:Room;2.

--twin-id -t

ID digitálního dvojčete.

Volitelné parametry

--if-none-match

Označuje, že operace vytvoření by měla selhat, pokud existuje existující dvojče se stejným ID.

výchozí hodnota: False

--properties -p

Počáteční hodnoty vlastností pro vytvoření instance digitálního dvojčete nebo souvisejících komponent Zadejte cestu k souboru nebo vložený JSON. Vlastnosti jsou vyžadovány pro dvojčata, která obsahují součásti, a to minimálně je nutné zadat prázdný $metadata objekt pro každou komponentu.

--resource-group -g

Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az dt twin delete

Odeberte digitální dvojče. Všechny relace odkazující na toto dvojče již musí být odstraněny.

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

Příklady

Odeberte digitální dvojče podle ID.

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

Odeberte digitální dvojče id pomocí značky etag.

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

Povinné parametry

--dt-name --dtn -n

--twin-id -t

ID digitálního dvojčete.

Volitelné parametry

--etag -e

Hodnota značky entity Příkaz bude úspěšný, pokud se značka etag shoduje s aktuální značkou prostředku.

--resource-group -g

Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az dt twin delete-all

Odstraní všechna digitální dvojčata v instanci služby Digital Twins, včetně všech relací pro tato dvojčata.

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

Příklady

Odstraňte všechna digitální dvojčata. Odstraní se také všechny relace odkazující na dvojčata.

az dt twin delete-all -n {instance_or_hostname}

Povinné parametry

--dt-name --dtn -n

Volitelné parametry

--resource-group -g

Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--yes -y

Nezotvádejte výzvu k potvrzení.

výchozí hodnota: False

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az dt twin query

Zadejte dotaz na digitální dvojčata instance. Umožňuje procházení relací a filtrování podle hodnot vlastností.

V mnoha dotazech $ dvojčete se znak používá k odkazování na $dtId vlastnost dvojčete. V prostředích podobných Bash nebo PowerShellu $ má znak funkční význam a musí být řídicím znakem jako součást vstupu dotazu. Další informace najdete v dokumentu https://docs.microsoft.com/en-us/azure/digital-twins/concepts-cli konceptů rozhraní příkazového řádku služby Digital Twins.

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

Příklady

Dotazování všech digitálních dvojčat v cílové instanci a projektu všechny atributy Zobrazí se také náklady v jednotkách dotazů.

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

Dotazování podle modelu a projektu všech atributů

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

Dotaz s využitím $dtId s kompatibilní syntaxí Bash

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

Dotaz s využitím $dtId se syntaxí kompatibilní s PowerShellem

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

Povinné parametry

--dt-name --dtn -n

--query-command -q

Uživatelský dotaz, který se má spustit.

Volitelné parametry

--cost --show-cost

Vypočítá a zobrazí poplatky za dotaz.

přijímané hodnoty: false, true

výchozí hodnota: False

--resource-group -g

Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az dt twin show

Zobrazí podrobnosti digitálního dvojčete.

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

Příklady

Zobrazí podrobnosti digitálního dvojčete.

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

Povinné parametry

--dt-name --dtn -n

--twin-id -t

ID digitálního dvojčete.

Volitelné parametry

--resource-group -g

Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az dt twin update

Aktualizace digitálního dvojčete instance prostřednictvím specifikace oprav JSON

Aktualizace hodnot vlastností a $model elementů můžou nastat ve stejném požadavku. Operace jsou omezené na přidání, nahrazení a odebrání.

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

Příklady

Aktualizace digitálního dvojčete prostřednictvím specifikace oprav JSON

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

Aktualizace digitálního dvojčete prostřednictvím specifikace opravy JSON a použití značky etag

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

Aktualizace digitálního dvojčete prostřednictvím specifikace oprav JSON

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

Aktualizace digitálního dvojčete prostřednictvím specifikace opravy JSON definované v souboru

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

Povinné parametry

--dt-name --dtn -n

--json-patch --patch

Specifikace aktualizace popsaná ve formátu JSON-patch. Aktualizace hodnot vlastností a $model elementů můžou nastat ve stejném požadavku. Operace jsou omezené na přidání, nahrazení a odebrání. Zadejte cestu k souboru nebo vložený JSON.

--twin-id -t

ID digitálního dvojčete.

Volitelné parametry

--etag -e

Hodnota značky entity Příkaz bude úspěšný, pokud se značka etag shoduje s aktuální značkou prostředku.

--resource-group -g

Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Sdílet prostřednictvím

az dt twin

Příkazy

az dt twin create

Příklady

Povinné parametry

Volitelné parametry

az dt twin delete

Příklady

Povinné parametry

Volitelné parametry

az dt twin delete-all

Příklady

Povinné parametry

Volitelné parametry

az dt twin query

Příklady

Povinné parametry

Volitelné parametry

az dt twin show

Příklady

Povinné parametry

Volitelné parametry

az dt twin update

Příklady

Povinné parametry

Volitelné parametry

Další materiály