مشاركة عبر

إنشاء المسارات ونقاط النهاية وحذفها باستخدام Azure PowerShell

  • مقالة

توضح لك هذه المقالة كيفية إنشاء مسار ونقطة نهاية في مركزك في Azure IoT Hub ثم حذف المسار ونقطة النهاية. تعرف على كيفية استخدام Azure PowerShell لإنشاء المسارات ونقاط النهاية لمراكز أحداث Azure وقوائم الانتظار والمواضيع ناقل خدمة Azure وتخزين Azure.

لمعرفة المزيد حول كيفية عمل التوجيه في IoT Hub، راجع استخدام توجيه رسائل IoT Hub لإرسال رسائل من جهاز إلى سحابة إلى نقاط نهاية مختلفة. للتنقل عبر إعداد مسار يرسل رسائل إلى التخزين ثم الاختبار على جهاز محاكاة، راجع البرنامج التعليمي: إرسال بيانات الجهاز إلى Azure Storage باستخدام توجيه رسائل IoT Hub.

إشعار

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

أيضا، لا يدعم PowerShell حاليا إنشاء نقاط نهاية Cosmos DB.

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

راجع المتطلبات الأساسية لهذه المقالة استنادا إلى نوع نقطة النهاية التي تريد توجيه الرسائل إليها.

إنشاء نقاط النهاية

في IoT Hub، يمكنك إنشاء مسار لإرسال الرسائل أو التقاط الأحداث. يحتوي كل مسار على مصدر بيانات ونقطة نهاية. مصدر البيانات هو المكان الذي تنشأ فيه الرسائل أو سجلات الأحداث. نقطة النهاية هي المكان الذي تنتهي فيه الرسائل أو سجلات الأحداث. يمكنك اختيار مواقع لمصدر البيانات ونقطة النهاية عند إنشاء مسار جديد في مركز IoT. بعد ذلك، يمكنك استخدام استعلامات التوجيه لتصفية الرسائل أو الأحداث قبل الانتقال إلى نقطة النهاية.

يجب أن تكون الخدمة التي تستخدمها لإنشاء نقطة النهاية موجودة أولا في حساب Azure الخاص بك.

إشعار

إذا كنت تستخدم إصدارا محليا من Azure PowerShell، فسجل الدخول إلى Azure PowerShell قبل البدء.

تستخدم الأوامر في الإجراءات التالية هذه المراجع:

  1. احصل على سلسلة الاتصال الأساسي من مركز الأحداث. انسخ سلسلة الاتصال لاستخدامها لاحقا.

    Get-AzEventHubKey -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule

  2. إنشاء نقطة نهاية مركز IoT جديدة إلى مراكز الأحداث. استخدم سلسلة الاتصال الأساسي من الخطوة السابقة. يجب أن تكون EventHubقيمة EndpointType . بالنسبة لجميع المعلمات الأخرى، استخدم القيم للسيناريو الخاص بك.

    Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType EventHub -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "Endpoint=<my connection string>"

    للاطلاع على جميع خيارات نقطة نهاية التوجيه، راجع Add-AzIotHubRoutingEndpoint.

إنشاء مسار IoT Hub

باستخدام نقطة النهاية الجديدة في مركز IoT الخاص بك، يمكنك إنشاء مسار جديد.

يجمع المسار الاحتياطي الافتراضي في IoT Hub الرسائل من DeviceMessages. اختر خيارا مختلفا للمسار المخصص، مثل DeviceConnectionStateEvents. لمزيد من المعلومات حول خيارات المصدر، راجع Add-AzIotHubRoute. Enabled المعلمة هي مفتاح، لذلك لا تحتاج إلى استخدام قيمة مع المعلمة .

Add-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute -Source DeviceLifecycleEvents -EndpointName MyEndpoint -Enabled

يعرض PowerShell تأكيدا يبدو مشابها لهذا المثال:

RouteName     : MyIotHub 
DataSource    : DeviceLifecycleEvents
EndpointNames : MyEndpoint
Condition     : true
IsEnabled     : True

تحديث مسار IoT Hub

لإجراء تغييرات على مسار موجود، استخدم الأمر التالي. على سبيل المثال، حاول تغيير اسم المسار باستخدام الأمر .

Set-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute

Get-AzIotHubRoute استخدم الأمر لتأكيد التغيير في مسارك:

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

حذف نقطة نهاية

لحذف نقطة نهاية:

Remove-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -PassThru

حذف مسار IoT Hub

لحذف مسار IoT Hub:

Remove-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute -PassThru

تلميح

لا يؤدي حذف مسار إلى حذف أي نقاط نهاية في حساب Azure الخاص بك. يجب حذف نقطة نهاية بشكل منفصل عن حذف مسار.

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

في هذه المقالة الإرشادية، تعلمت كيفية إنشاء مسار ونقطة نهاية لمراكز الأحداث وقوائم انتظار وموضوعات ناقل الخدمة ومساحة تخزين Azure.

لمعرفة المزيد حول توجيه الرسائل، راجع البرنامج التعليمي: إرسال بيانات الجهاز إلى Azure Storage باستخدام توجيه رسائل IoT Hub. في البرنامج التعليمي، يمكنك إنشاء مسار تخزين واختباره باستخدام جهاز في مركز IoT الخاص بك.