Sdílet prostřednictvím

Sada příkazů Azure Digital Twins CLI

Kromě správy instance Azure Digital Twins v Azure portálu má Azure Digital Twins také sadu příkazů pro Azure CLI, kterou můžete použít k provádění většiny hlavních akcí souvisejících s touto službou. Tento článek pojednává o sadě příkazů Azure CLI pro Azure Digital Twins, včetně jejich využití, způsobu získání a požadavků na jejich používání.

Některé z akcí, které můžete provést pomocí sady příkazů, zahrnují:

  • Správa instance Azure Digital Twins
  • Správa modelů
  • Správa digitálních dvojčat
  • Řízení vztahů dvojčat
  • Konfigurace koncových bodů
  • Správa tras
  • Konfigurace zabezpečení prostřednictvím řízení přístupu založeného na rolích Azure (Azure RBAC)

Sada příkazů se nazývá az dt a je součástí rozšíření Azure IoT pro Azure CLI. Kompletní seznam příkazů a jejich použití si můžete prohlédnout v referenční dokumentaci pro sadu příkazů az iot: odkaz na příkazy az dt.

Použití (nasadit a ověřit)

Kromě obecné správy vaší instance je CLI také užitečným nástrojem pro nasazení a ověřování.

  • Příkazy řídicí roviny mohou být použity k tomu, aby nasazení nové instance bylo opakovatelné nebo automatizované.
  • Příkazy datového plánu lze použít k rychlému ověření hodnot ve vaší instanci a k potvrzení, že operace byly dokončeny, jak bylo očekáváno.

Získejte sadu příkazů

Azure Digital Twins příkazy jsou součástí Azure IoT rozšíření pro Azure CLI (azure-iot). Postupujte podle následujících kroků, abyste se ujistili, že máte nejnovější azure-iot rozšíření s az dt příkazy.

Požadavky na verzi CLI

Pokud používáte Azure CLI s PowerShellem, měla by být verze Azure CLI 2.3.1 nebo vyšší jako požadavek balíčku rozšíření.

Verzi svého Azure CLI můžete zkontrolovat tímto příkazem CLI:

az --version

Pokyny k instalaci nebo aktualizaci Azure CLI na novější verzi najdete v tématu Postup instalace Azure CLI.

Získejte rozšíření

Azure CLI vás automaticky vyzve k instalaci rozšíření při prvním použití příkazu, který ho vyžaduje.

V opačném případě můžete kdykoli použít následující příkaz k instalaci rozšíření sami (nebo k jeho aktualizaci, pokud zjistíte, že již máte starší verzi). Příkaz lze spustit buď v Azure Cloud Shell, nebo v lokálním Azure CLI.

az extension add --upgrade --name azure-iot

Používejte speciální znaky v různých shellech

Některé az dt příkazy používají speciální znaky, které mohou být ve správných prostředích shellu escapovány pro správné parsování. Tipy v této části vám pomůžou zjistit, kdy ve zvoleném prostředí utéct speciální znaky.

Udeřit

Použijte tyto tipy pro speciální znaky v prostředích Bash.

Dotazy

V mnoha dotazech na dvojčata se používá znak $ k odkazování na vlastnost $dtId dvojčete. Při použití příkazu az dt twin query pro dotazování v prostředí Cloud Shell Bash, unikněte znak $ pomocí zpětného lomítka (\).

Tady je příklad dotazování dvojčete pomocí příkazu rozhraní příkazového řádku v prostředí Cloud Shell Bash:

az dt twin query --dt-name <instance-hostname-or-name> --query-command "SELECT * FROM DigitalTwins T Where T.\$dtId = 'room0'"

PowerShell

Použijte tyto tipy pro speciální znaky v prostředích PowerShell.

Vložený JSON

Některé příkazy, jako například az dt twin create, vám umožňují zadat informace o dvojčeti ve formě inline JSON. Při zadávání inline JSONu v prostředí PowerShellu ošetřete uvozovky ve formátu JSON pomocí zpětného lomítka.

Tady je příklad vytvoření dvojčete pomocí příkazu rozhraní příkazového řádku v PowerShellu:

az dt twin create --dt-name <instance-hostname-or-name> --dtmi "dtmi:contosocom:DigitalTwins:Thermostat;1" --twin-id thermostat67 --properties '{\"Temperature\": 0.0}'

Návod

Mnoho příkazů, které podporují vložený JSON, také podporuje vstup jako cestu k souboru, což vám může pomoct vyhnout se požadavkům na text specifický pro prostředí.

Dotazy

V mnoha dotazech na dvojčata se používá znak $ k odkazování na vlastnost $dtId dvojčete. Při použití příkazu az dt twin query k dotazování v prostředí PowerShell, použijte opačné apostrof pro escapování znaku $.

Zde je příklad dotazu na dvojče pomocí příkazu CLI v PowerShellu:

az dt twin query --dt-name <instance-hostname-or-name> --query-command "SELECT * FROM DigitalTwins T Where T.`$dtId = 'room0'"

Windows CMD

Použijte tyto tipy pro speciální znaky pro místní Windows CMD.

Vložený JSON

Některé příkazy, jako například az dt twin create, vám umožňují zadat informace o dvojčeti ve formě inline JSON. Při zadávání inline JSON v místním okně Windows CMD uzavřete hodnotu parametru do dvojitých uvozovek (") místo jednoduchých uvozovek (') a znak dvojité uvozovky uvnitř JSON escapujte zpětným lomítkem (\).

Tady je příklad vytvoření dvojčete pomocí příkazu rozhraní příkazového řádku v místním systému Windows CMD:

az dt twin create --dt-name <instance-hostname-or-name> --dtmi "dtmi:contosocom:DigitalTwins:Thermostat;1" --twin-id thermostat67 --properties "{\"Temperature\": 0.0}"

Návod

Mnoho příkazů, které podporují vložený JSON, také podporuje vstup jako cestu k souboru, což vám může pomoct vyhnout se požadavkům na text specifický pro prostředí.

Další kroky

Prozkoumejte CLI a jeho kompletní sadu příkazů prostřednictvím referenční dokumentace.

  • Last updated on