Share via

Azure Digital Twins CLI-parancskészlet

  • Cikk

Az Azure Digital Twins-példány Azure Portal való kezelésén kívül az Azure Digital Twins rendelkezik egy parancskészlettel az Azure CLI-hez, amellyel a szolgáltatással végzett legtöbb fő művelet elvégezhető. Ez a cikk az Azure Digital Twins Azure CLI-parancskészletét ismerteti, beleértve annak használatát, beszerzésének módját és használatának követelményeit.

A parancskészlettel elvégezhető műveletek közé tartoznak a következők:

  • Azure Digital Twins-példány kezelése
  • Modellek kezelése
  • Digitális ikerpéldányok kezelése
  • Ikerkapcsolatok kezelése
  • Végpontok konfigurálása
  • Útvonalak kezelése
  • Biztonság konfigurálása azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC)

A parancskészlet neve az dt, és az Azure CLI Azure IoT-bővítményének része. A parancsok teljes listáját és azok használatát a parancskészlet referenciadokumentációjának részeként tekintheti meg: az az iotdt command reference.

Felhasználás (üzembe helyezés és ellenőrzés)

A példány általános felügyeletétől eltekintve a CLI az üzembe helyezéshez és az ellenőrzéshez is hasznos eszköz.

  • A vezérlősík parancsaival megismételhetővé vagy automatizálhatóvá teheti egy új példány üzembe helyezését.
  • Az adatsík parancsaival gyorsan ellenőrizheti a példány értékeit, és ellenőrizheti, hogy a műveletek a várt módon fejeződtek-e be.

A parancskészlet lekérése

Az Azure Digital Twins-parancsok az Azure CLI (azure-iot) Azure IoT-bővítményének részei, ezért kövesse ezeket a lépéseket, és győződjön meg arról, hogy a legújabb azure-iot bővítményt használja a az dt parancsokkal.

A CLI verziókövetelményei

Ha az Azure CLI-t a PowerShell-lel használja, az Azure CLI-verziónak a bővítménycsomag követelményeként a 2.3.1-es vagy újabb verziónak kell lennie.

Az Azure CLI verzióját az alábbi CLI-paranccsal ellenőrizheti:

az --version

Az Azure CLI újabb verzióra való telepítésével vagy frissítésével kapcsolatos utasításokért lásd : Az Azure CLI telepítése.

A bővítmény lekérése

Az Azure CLI automatikusan kérni fogja, hogy telepítse a bővítményt az azt igénylő parancs első használatakor.

Ellenkező esetben a következő paranccsal bármikor telepítheti a bővítményt (vagy frissítheti, ha kiderül, hogy már rendelkezik régebbi verzióval). A parancs az Azure Cloud Shell vagy egy helyi Azure CLI-ben futtatható.

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

Speciális karakterek használata különböző rendszerhéjakban

Egyes az dt parancsok speciális karaktereket használnak, amelyek bizonyos rendszerhéj-környezetekben való megfelelő elemzéshez feloldhatók. Az ebben a szakaszban található tippek segítségével megtudhatja, mikor kell ezt megtennie a választott rendszerhéjban.

Bash

Használja ezeket a speciális karaktertippeket Bash-környezetekhez.

Lekérdezések

Sok iker lekérdezésben a $ karakter egy ikerpéldány tulajdonságára hivatkozik $dtId . Ha az az dt twin query parancsot használja a Cloud Shell Bash-környezetben való lekérdezéshez, a karaktert fordított perjellel (\) kell feloldani$.

Íme egy példa egy cli-paranccsal rendelkező ikerpéldány lekérdezésére a Cloud Shell Bash-környezetben:

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

PowerShell

Ezeket a speciális karaktertippeket PowerShell-környezetekhez használhatja.

Beágyazott JSON

Egyes parancsok, például az az dt twin create, lehetővé teszik az ikeradatok megadását beágyazott JSON formájában. Amikor beágyazott JSON-t ad meg a PowerShell-környezetben, feloldja a dupla idézőjel karaktereket (") a JSON-ban fordított perjellel (\).

Íme egy példa ikerpéldány létrehozására egy CLI-paranccsal a PowerShellben:

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

Tipp

A beágyazott JSON-t támogató parancsok közül sok fájlelérési útként is támogatja a bemenetet, ami segíthet elkerülni a felületspecifikus szövegkövetelményeket.

Lekérdezések

Sok iker lekérdezésben a $ karakter egy ikerpéldány tulajdonságára hivatkozik $dtId . Ha az az dt twin query parancsot használja a PowerShell-környezetben való lekérdezéshez, lépjen ki a $ karakterből egy backtick karakterrel.

Íme egy példa egy ikerpéldány lekérdezésére egy CLI-paranccsal a PowerShellben:

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

Windows CMD

Használja ezeket a speciális karaktertippeket a helyi Windows CMD-hez.

Beágyazott JSON

Egyes parancsok, például az az dt twin create, lehetővé teszik az ikeradatok megadását beágyazott JSON formájában. Amikor beágyazott JSON-t ad meg egy helyi Windows CMD-ablakban, a paraméter értékét idézőjelek () helyett dupla idézőjelekkel ("') foglalja, és a JSON-ban fordított perjellel (\) feloldja a dupla idézőjel karaktereit.

Íme egy példa egy ikerpéldány létrehozására cli-paranccsal a helyi Windows CMD-ben:

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

Tipp

A beágyazott JSON-t támogató parancsok közül sok fájlelérési útként is támogatja a bemenetet, ami segíthet elkerülni a felületspecifikus szövegkövetelményeket.

Következő lépések

A parancssori felület és a hozzá tartozó parancsok teljes készletének megismerése a referenciadokumentumokon keresztül: