إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
بصرف النظر عن إدارة مثيل Azure Digital Twins في مدخل Microsoft Azure، يحتوي Azure Digital Twins أيضا على مجموعة أوامر ل Azure CLI يمكنك استخدامها للقيام بمعظم الإجراءات الرئيسية مع الخدمة. تتناول هذه المقالة مجموعة أوامر Azure CLI لتوائم Azure الرقمية بما في ذلك استخداماتها وكيفية الحصول عليها ومتطلبات استخدامها.
تتضمن بعض الإجراءات التي يمكنك القيام بها باستخدام مجموعة الأوامر ما يلي:
- إدارة مثيل 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.
الاستعلامات
في العديد من الاستعلامات المزدوجة $ ، يتم استخدام الحرف للإشارة $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'"
ويندوز 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 ومجموعة كاملة من الأوامر الخاصة به من خلال المستندات المرجعية: