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}'
Tip
Mnoho příkazů, které podporují vložený JSON, také podporuje vstup jako cestu k souboru, což vám pomůže vyhnout se požadavkům na text specifický pro prostředí.
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}"
Tip
Mnoho příkazů, které podporují vložený JSON, také podporuje vstup jako cestu k souboru, což vám pomůže vyhnout se požadavkům na text specifický pro prostředí.
Další kroky
Prozkoumejte rozhraní příkazového řádku a jeho úplnou sadu příkazů prostřednictvím referenčních dokumentů: