Sada příkazů rozhraní příkazového řádku Azure Digital Twins

Kromě správy instance Služby Azure Digital Twins v Azure Portal má Služba Azure Digital Twins také sadu příkazů pro Azure CLI, kterou můžete použít k provádění většiny důležitých akcí se službou. Tento článek popisuje sadu příkazů Azure CLI pro Azure Digital Twins, včetně jejího použití, postupu jejího získání a požadavků na její použití.

Mezi akce, které můžete provést pomocí sady příkazů, patří:

• Správa instance Služby Azure Digital Twins
• Správa modelů
• Správa digitálních dvojčat
• Správa relací dvojčat
• Konfigurace koncových bodů
• Správa tras
• Konfigurace zabezpečení prostřednictvím řízení přístupu na základě role v Azure (Azure RBAC)

Sada příkazů se nazývá az dta je součástí rozšíření Azure IoT pro Azure CLI. Úplný seznam příkazů a jejich použití si můžete prohlédnout v referenční dokumentaci k sadě az iot příkazů: az dt command reference.

Použití (nasazení a ověření)

Kromě obecné správy instance je rozhraní příkazového řádku také užitečným nástrojem pro nasazení a ověření.

• Příkazy řídicí roviny lze použít k tomu, aby bylo nasazení nové instance opakovatelné nebo automatizované.
• Příkazy roviny dat můžete použít k rychlé kontrole hodnot ve vaší instanci a k ověření, že se operace dokončily podle očekávání.

Získání sady příkazů

Příkazy Azure Digital Twins jsou součástí rozšíření Azure IoT pro Azure CLI (azure-iot), proto postupujte podle těchto kroků a ujistěte se, že máte nejnovější azure-iot rozšíření s az dt příkazy.

Požadavky na verzi rozhraní příkazového řádku

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

Verzi Azure CLI můžete zkontrolovat pomocí tohoto příkazu rozhraní příkazového řádku:

az --version

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

Získání 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 nainstalovat rozšíření sami pomocí následujícího příkazu (nebo ho aktualizovat, pokud se ukáže, že už máte starší verzi). Příkaz je možné spustit v Azure Cloud Shell nebo v místním Azure CLI.

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

Použití speciálních znaků v různých prostředích

Některé az dt příkazy používají speciální znaky, které může být nutné pro správnou analýzu v určitých prostředích. Tipy v této části vám pomůžou zjistit, kdy to udělat v prostředí podle vašeho výběru.

Bash

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

Dotazy

V mnoha dotazech dvojčat se $ znak používá k odkazování na $dtId vlastnost dvojčete. Při dotazování v prostředí Cloud Shell Bash pomocí příkazu dotazu az dt twin u řídicího znaku $ použijte zpětné lomítko (\).

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

Tyto speciální tipy pro znaky použijte pro prostředí PowerShellu.

Vložený JSON

Některé příkazy, jako je například az dt twin create, umožňují zadat informace o dvojčatech ve formě vloženého kódu JSON. Při zadávání vloženého kódu JSON v prostředí PowerShellu uvozujte do kódu JSON znak dvojité uvozovky (") zpětným lomítkem (\).

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

Dotazy

V mnoha dotazech dvojčat se $ znak používá k odkazování na $dtId vlastnost dvojčete. Při dotazování v prostředí PowerShellu pomocí příkazu dotazu az dt twin uváděte $ znak pomocí znaku backtick.

Tady je příklad dotazování dvojčete pomocí příkazu rozhraní příkazového řádku 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 speciální tipy pro znaky pro místní cmd Systému Windows.

Vložený JSON

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

Tady je příklad vytvoření dvojčete pomocí příkazu rozhraní příkazového řádku v místní sadě 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}"

Další kroky

Prozkoumejte rozhraní příkazového řádku a jeho úplnou sadu příkazů prostřednictvím referenčních dokumentů:

• az dt command reference