Share via

مجموعة أوامر Azure Digital Twins CLI

  • مقالة

بصرف النظر عن إدارة مثيل Azure Digital Twins في مدخل Microsoft Azure، يحتوي Azure Digital Twins أيضا على مجموعة أوامر ل Azure CLI يمكنك استخدامها للقيام بمعظم الإجراءات الرئيسية مع الخدمة. تتناول هذه المقالة مجموعة أوامر Azure CLI ل Azure Digital twins بما في ذلك استخداماتها وكيفية الحصول عليها ومتطلبات استخدامها.

تتضمن بعض الإجراءات التي يمكنك القيام بها باستخدام مجموعة الأوامر ما يلي:

  • إدارة مثيل Azure Digital Twins
  • إدارة النماذج
  • إدارة التوائم الرقمية
  • إدارة العلاقات المزدوجة
  • تكوين نقاط النهاية
  • إدارة المسارات
  • تكوين الأمان عبر التحكم في الوصول المستند إلى الدور في Azure (Azure RBAC)

تسمى az dtمجموعة الأوامر ، وهي جزء من ملحق Azure IoT ل Azure CLI. يمكنك عرض القائمة الكاملة للأوامر واستخدامها كجزء من الوثائق المرجعية لمجموعة الأوامر az iot: مرجع أوامر az dt.

يستخدم (التوزيع والتحقق من الصحة)

بصرف النظر عن إدارة المثيل الخاص بك بشكل عام، يعد CLI أيضا أداة مفيدة للتوزيع والتحقق من الصحة.

  • يمكن استخدام أوامر مستوى التحكم لجعل نشر مثيل جديد متكررًا أو آليًا.
  • يمكن استخدام أوامر مستوى البيانات للتحقق بسرعة من القيم في المثيل الخاص بك، والتحقق من اكتمال العمليات كما هو متوقع.

الحصول على مجموعة الأوامر

تعد أوامر Azure Digital Twins جزءا من ملحق Azure IoT ل Azure CLI (azure-iot)، لذا اتبع هذه الخطوات للتأكد من أن لديك أحدث azure-iot ملحق مع az dt الأوامر.

متطلبات إصدار CLI

إذا كنت تستخدم Azure CLI مع PowerShell، فيجب أن يكون إصدار Azure CLI 2.3.1 أو أعلى كشرط لحزمة الملحق.

يمكنك التحقق من إصدار Azure CLI باستخدام أمر CLI هذا:

az --version

للحصول على إرشادات حول كيفية تثبيت Azure CLI أو تحديثه إلى إصدار أحدث، راجع تثبيت Azure CLI.

الحصول على الملحق

سيطالبك Azure CLI تلقائيا بتثبيت الملحق على أول استخدام لأمر يتطلبه.

وإلا، يمكنك استخدام الأمر التالي لتثبيت الملحق بنفسك في أي وقت (أو تحديثه إذا تبين أن لديك بالفعل إصدارا قديما). يمكن تشغيل الأمر إما في Azure Cloud Shell أو Azure CLI محلي.

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

استخدام أحرف خاصة في قذائف مختلفة

تستخدم بعض az dt الأوامر أحرفا خاصة قد يجب تجنبها لتحليلها بشكل مناسب في بيئات shell معينة. استخدم التلميحات الواردة في هذا القسم لمساعدتك على معرفة وقت القيام بذلك في shell الذي تختاره.

Bash

استخدم تلميحات الأحرف الخاصة هذه لبيئات Bash.

الاستعلامات

في العديد من الاستعلامات المزدوجة $ ، يتم استخدام الحرف للإشارة $dtId إلى خاصية التوأم. عند استخدام الأمر az dt twin query للاستعلام في بيئة Cloud Shell Bash، قم بالتخلص من $ الحرف بسلة مائلة عكسية (\).

فيما يلي مثال على الاستعلام عن توأم باستخدام أمر CLI في بيئة Cloud Shell Bash:

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

PowerShell

استخدم تلميحات الأحرف الخاصة هذه لبيئات PowerShell.

JSON المضمن

تسمح لك بعض الأوامر، مثل az dt twin create، بإدخال معلومات مزدوجة في شكل JSON مضمن. عند إدخال JSON المضمن في بيئة PowerShell، قم بالهروب من أحرف الاقتباس المزدوجة (") داخل JSON مع خط مائل عكسي (\).

فيما يلي مثال على إنشاء توأم باستخدام أمر CLI في PowerShell:

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

تلميح

تدعم العديد من الأوامر التي تدعم JSON المضمنة أيضا الإدخال كمسار ملف، والذي يمكن أن يساعدك على تجنب متطلبات النص الخاصة ب shell.

الاستعلامات

في العديد من الاستعلامات المزدوجة $ ، يتم استخدام الحرف للإشارة $dtId إلى خاصية التوأم. عند استخدام الأمر az dt twin query للاستعلام في بيئة PowerShell، قم بإلغاء $ الحرف بحرف backtick.

فيما يلي مثال على الاستعلام عن توأم باستخدام أمر CLI في PowerShell:

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

⁧⁩Windows CMD⁧⁩

استخدم تلميحات الأحرف الخاصة هذه ل Windows CMD المحلي.

JSON المضمن

تسمح لك بعض الأوامر، مثل az dt twin create، بإدخال معلومات مزدوجة في شكل JSON مضمن. عند إدخال JSON المضمن في نافذة Windows CMD محلية، قم بإحاطة قيمة المعلمة بعلامات اقتباس مزدوجة (") بدلا من علامات الاقتباس المفردة (')، وإلغاء أحرف الاقتباس المزدوجة داخل JSON مع خط مائل عكسي (\).

فيما يلي مثال على إنشاء توأم باستخدام أمر CLI في 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}"

تلميح

تدعم العديد من الأوامر التي تدعم JSON المضمنة أيضا الإدخال كمسار ملف، والذي يمكن أن يساعدك على تجنب متطلبات النص الخاصة ب shell.

الخطوات التالية

استكشف CLI ومجموعة الأوامر الكاملة الخاصة به من خلال المستندات المرجعية: