az dt twin

Note

Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.67.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.	Extension	GA
az dt twin component show	Zobrazení podrobností o komponentě digitálního dvojčete	Extension	GA
az dt twin component update	Aktualizujte komponentu digitálního dvojčete prostřednictvím specifikace oprav JSON.	Extension	GA
az dt twin create	Vytvořte digitální dvojče v instanci.	Extension	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.	Extension	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.	Extension	GA
az dt twin query	Zadejte dotaz na digitální dvojčata instance. Umožňuje procházení relací a filtrování podle hodnot vlastností.	Extension	GA
az dt twin relationship	Umožňuje spravovat a konfigurovat vztahy digitálních dvojčat instance služby Digital Twins.	Extension	GA
az dt twin relationship create	Vytvořte relaci mezi zdrojovými a cílovými digitálními dvojčaty.	Extension	GA
az dt twin relationship delete	Odstraňte relaci digitálního dvojčete v instanci služby Digital Twins.	Extension	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í.	Extension	GA
az dt twin relationship list	Uveďte vztahy digitálního dvojčete.	Extension	GA
az dt twin relationship show	Umožňuje zobrazit podrobnosti vztahu digitálního dvojčete.	Extension	GA
az dt twin relationship update	Aktualizuje vlastnosti relace mezi dvěma digitálními dvojčaty prostřednictvím specifikace opravy JSON.	Extension	GA
az dt twin show	Zobrazí podrobnosti digitálního dvojčete.	Extension	GA
az dt twin telemetry	Otestujte a ověřte trasy a koncové body událostí instance služby Digital Twins.	Extension	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.	Extension	GA
az dt twin update	Aktualizace digitálního dvojčete instance prostřednictvím specifikace oprav JSON	Extension	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 --dtn
                  --dtmi --model-id
                  --twin-id
                  [--acquire-policy-token]
                  [--change-reference]
                  [--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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--if-none-match

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

Vlastnost	Hodnota
Default value:	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í.

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

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

Vlastnost	Hodnota
Default value:	False

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 --dtn
                  --twin-id
                  [--acquire-policy-token]
                  [--change-reference]
                  [--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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

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

Vlastnost	Hodnota
Default value:	False

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 --dtn
                      [--acquire-policy-token]
                      [--change-reference]
                      [--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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

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

Nevyzývejte k potvrzení.

Vlastnost	Hodnota
Default value:	False

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

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

Vlastnost	Hodnota
Default value:	False

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 vlastnost $dtId dvojčete. V prostředích podobných Bash nebo PowerShellu má znak $ funkční význam a musí být řídicí znak jako součást vstupu dotazu. Další informace najdete v dokumentu s koncepty rozhraní příkazového řádku služby Digital Twins https://learn.microsoft.com/en-us/azure/digital-twins/concepts-cli.

az dt twin query --dt-name --dtn
                 --query-command
                 [--acquire-policy-token]
                 [--change-reference]
                 [--cost --show-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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--cost --show-cost

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

Vlastnost	Hodnota
Default value:	False
Přípustné hodnoty:	false, true

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

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

Vlastnost	Hodnota
Default value:	False

az dt twin show

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

az dt twin show --dt-name --dtn
                --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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

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

Vlastnost	Hodnota
Default value:	False

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 --dtn
                  --json-patch --patch
                  --twin-id
                  [--acquire-policy-token]
                  [--change-reference]
                  [--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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

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

Vlastnost	Hodnota
Default value:	False

Váš názor

Byla tato stránka užitečná?