إدارة IoT Central من Azure CLI أو PowerShell

  • مقالة
  • قراءة خلال 6 دقائق

بدلا من إنشاء تطبيقات IoT Central وإدارتها على موقع إدارة تطبيقات Azure IoT Central على الويب، يمكنك استخدام Azure CLI أو Azure PowerShell لإدارة تطبيقاتك.

إذا كنت تفضل استخدام لغة مثل JavaScript أو Python أو C# أو Ruby أو Go، فشاهد مستودع نماذج Azure IoT Central ARM SDK لعينات التعليمات البرمجية التي توضح لك كيفية إنشاء تطبيقات Azure IoT Central وتحديثها وإدراجها وحذفها.

المتطلبات الأساسية

تحذير

ستحتاج إلى وصول المساهم إلى اشتراك Azure لإنشاء تطبيق IoT Central. بينما قد تكون هناك مستويات وصول بديلة لإنشاء تطبيق، فإن وجود وصول مستوى المساهم إلى الاشتراك هو المسار الموصى به.

أنشئ تطبيق

استخدم الأمر az iot central app create لإنشاء تطبيق IoT Central في اشتراك Azure الخاص بك. على سبيل المثال:

# Create a resource group for the IoT Central application
az group create --location "East US" \
    --name "MyIoTCentralResourceGroup"

# Create an IoT Central application
az iot central app create \
  --resource-group "MyIoTCentralResourceGroup" \
  --name "myiotcentralapp" --subdomain "mysubdomain" \
  --sku ST1 --template "iotc-pnp-preview" \
  --display-name "My Custom Display Name"

تنشئ هذه الأوامر أولا مجموعة موارد في منطقة شرق الولايات المتحدة للتطبيق. يصف الجدول التالي المعلمات المستخدمة مع الأمر az iot central app create :

المعلمة الوصف
resource-group مجموعة الموارد التي تحتوي على التطبيق. يجب أن تكون مجموعة الموارد هذه موجودة بالفعل في اشتراكك.
الموقع بشكل افتراضي، يستخدم هذا الأمر الموقع من مجموعة الموارد. حاليا، يمكنك إنشاء تطبيق IoT Central في شرق أستراليا وكندا الوسطىووسط الولايات المتحدةوشرق الولايات المتحدةوشرق الولايات المتحدة 2وشرق اليابانوشمال أوروباوجنوب وسط الولايات المتحدةوجنوب شرق آسياوجنوب المملكة المتحدة وغربأوروباوغرب الولايات المتحدة.
الاسم اسم التطبيق في مدخل Microsoft Azure. تجنب الأحرف الخاصة - بدلا من ذلك، استخدم الأحرف الصغيرة (a-z) والأرقام (0-9) والشرطات (-).
فرعي المجال الفرعي في عنوان URL للتطبيق. في المثال، عنوان URL للتطبيق هو https://mysubdomain.azureiotcentral.com.
SKU حاليا، يمكنك استخدام إما ST1 أو ST2. راجع أسعار Azure IoT Central.
القالب قالب التطبيق المراد استخدامه. لمزيد من المعلومات، راجع الجدول التالي.
اسم العرض اسم التطبيق كما هو معروض في واجهة المستخدم.

قوالب التطبيق

معرف القالب الاسم الصناعة الوصف
iotc-pnp-preview التطبيق المخصص غير متوفر تُنشئ تطبيقًا فارغًا لتتم تعبئته بقوالب الأجهزة والأجهزة الخاصة بك.
iotc-condition التحليلات داخل المتجر - مراقبة الحالة Retail إنشاء تطبيق للاتصال ومراقبة بيئة المتجر.
iotc-consumption مراقبة استهلاك المياه الحكومة تُنشئ تطبيقًا لمراقبة تدفق المياه والتحكم فيه.
iotc-distribution مركز التوزيع الرقمي Retail ينشئ تطبيقًا لتحسين كفاءة مخرجات المستودعات عن طريق رقمنة الأصول والإجراءات الرئيسية.
iotc-inventory إدارة المخزون الذكية Retail ينشئ تطبيقًا لأتمتة الاستلام وحركة المنتج وعد الدورة والتتبع.
iotc-logistics اللوجستيات المتصلة Retail تُنشئ تطبيقًا لتتبع شحناتك في الوقت الفعلي عبر الهواء والماء والأرض مع مراقبة الموقع والحالة.
iotc-meter تحليلات المقاييس الذكية الطاقة ينشئ تطبيقًا لمراقبة استهلاك الطاقة وحالة الشبكة وتحديد الاتجاهات لتحسين دعم العملاء وإدارة العدادات الذكية.
iotc-mfc مركز الوفاء المصغر Retail يُنشئ تطبيقًا للاتصال الرقمي وإدارة مركز الوفاء المؤتمت بالكامل.
iotc-patient المراقبة المستمرة للمريض الصحة ينشئ تطبيقًا لتوسيع نطاق رعاية المرضى وتقليل عمليات إعادة القبول وإدارة الأمراض.
iotc-power مراقبة الطاقة الشمسية الطاقة ينشئ تطبيقًا لمراقبة حالة الألواح الشمسية واتجاهات توليد الطاقة.
iotc-quality مراقبة جودة المياه الحكومة ينشئ تطبيقًا لمراقبة جودة المياه رقميًا.
iotc-store التحليلات داخل المتجر - التدقيق‏ Retail يُنشئ تطبيقًا لمراقبة وإدارة تدفق السداد داخل متجرك.
iotc-waste إدارة النفايات المتصلة الحكومة ينشئ تطبيقًا لمراقبة حاويات النفايات وإرسال المشغلين الميدانيين.

إذا قمت بإنشاء قالب التطبيق الخاص بك، يمكنك استخدامه لإنشاء تطبيق جديد. عند مطالبتك بقالب تطبيق، أدخل معرف التطبيق الموضح في رابط URL القابل للمشاركة للتطبيق الذي تم تصديره ضمن قسم تصدير قالب التطبيق من تطبيقك.

عرض التطبيقات

استخدم الأمر az iot central app list لسرد تطبيقات IoT Central وعرض بيانات التعريف.

تعديل تطبيق

استخدم الأمر az iot central app update لتحديث بيانات التعريف لتطبيق IoT Central. على سبيل المثال، لتغيير اسم العرض للتطبيق الخاص بك:

az iot central app update --name myiotcentralapp \
  --resource-group MyIoTCentralResourceGroup \
  --set displayName="My new display name"

حذف تطبيق

استخدم الأمر az iot central app delete لحذف تطبيق IoT Central. على سبيل المثال:

az iot central app delete --name myiotcentralapp \
  --resource-group MyIoTCentralResourceGroup

تكوين هوية مدارة

يمكن لتطبيق IoT Central استخدام هوية مدارة معينة من قبل النظام لتأمين الاتصال بوجهة تصدير البيانات.

لتمكين الهوية المدارة، استخدم إما مدخل Azure - تكوين هوية مدارة أو واجهة برمجة تطبيقات REST:

Screenshot showing managed identity in Azure portal.

بعد تمكين الهوية المدارة، يمكنك استخدام CLI لتكوين تعيينات الدور.

استخدم الأمر az role assignment create لإنشاء تعيين دور. على سبيل المثال، تقوم الأوامر التالية أولا باسترداد المعرف الأساسي للهوية المدارة. يعين Azure Event Hubs Data Sender الأمر الثاني الدور للمعرف الأساسي في نطاق MyIoTCentralResourceGroup مجموعة الموارد:

spID=$(az resource list -n myiotcentralapp --query [*].identity.principalId --out tsv)
az role assignment create --assignee $spID --role "Azure Event Hubs Data Sender" \
  --scope /subscriptions/<your subscription id>/resourceGroups/MyIoTCentralResourceGroup

لمعرفة المزيد حول تعيينات الأدوار، راجع:

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

الآن بعد أن تعلمت كيفية إدارة تطبيقات Azure IoT Central من Azure CLI أو PowerShell، إليك الخطوة التالية المقترحة:

إدارة طلبك