Создание и удаление маршрутов и конечных точек с помощью Azure PowerShell

В этой статье показано, как создать маршрут и конечную точку в концентраторе в Центр Интернета вещей Azure а затем удалить маршрут и конечную точку. Узнайте, как использовать Azure PowerShell для создания маршрутов и конечных точек для Центры событий Azure, Служебная шина Azure очередей и разделов, а также для службы хранилища Azure.

Дополнительные сведения о том, как работает маршрутизация в Центр Интернета вещей, см. в статье Использование маршрутизации Центр Интернета вещей сообщений для отправки сообщений с устройства в облако в разные конечные точки. Инструкции по настройке маршрута, который отправляет сообщения в хранилище, а затем тестирует на имитированном устройстве, см. в статье Руководство. Отправка данных устройства в службу хранилища Azure с помощью маршрутизации Центр Интернета вещей сообщений.

Предварительные требования

Процедуры, описанные в этой статье, используют следующие ресурсы:

• Azure PowerShell
• Центр Интернета вещей
• Служба конечной точки в Azure

Azure PowerShell

В этой статье используется Azure PowerShell для работы с Центр Интернета вещей и другими службами Azure. Чтобы использовать Azure PowerShell локально, установите модуль Azure PowerShell на компьютере. Кроме того, чтобы использовать Azure PowerShell в веб-браузере, включите azure Cloud Shell.

центр Интернета вещей

Чтобы создать маршрут Центра Интернета вещей, вам потребуется Центр Интернета вещей, созданный с помощью Центр Интернета вещей Azure. Сообщения устройств и журналы событий порождены в Центре Интернета вещей.

Убедитесь, что при создании маршрута Центра Интернета вещей используется следующий ресурс концентратора:

• Центр Интернета вещей в подписке Azure. Если у вас еще нет центра, выполните действия по созданию центра Интернета вещей с помощью командлета PowerShell New-AzIotHub.

Служба конечных точек

Чтобы создать маршрут Центра Интернета вещей, вам потребуется по крайней мере одна другая служба Azure, используемая в качестве конечной точки для маршрута. Конечная точка получает сообщения устройства и журналы событий. Вы можете выбрать, какую службу Azure вы используете для конечной точки для подключения к маршруту Центра Интернета вещей: Центры событий, очереди или разделы служебной шины или служба хранилища Azure.

Убедитесь, что при создании конечной точки маршрута Центра Интернета вещей используется один из следующих ресурсов:

• Ресурс Центров событий (с контейнером). Если вам нужно создать ресурс Центров событий, см. статью Краткое руководство. Создание концентратора событий с помощью Azure PowerShell.

• Ресурс очереди служебной шины. Если вам нужно создать новую очередь служебной шины, см. статью Использование Azure PowerShell для создания пространства имен и очереди служебной шины.

• Ресурс раздела служебной шины. Если вам нужно создать новый раздел служебной шины, см. справочник по New-AzServiceBusTopic и Служебная шина Azure документации по обмену сообщениями.

• Ресурс службы хранилища Azure. Если вам нужно создать учетную запись хранения в Azure, см. статью Создание учетной записи хранения.

Создание ресурсов и конечных точек

В Центр Интернета вещей можно создать маршрут для отправки сообщений или записи событий. Каждый маршрут имеет источник данных и конечную точку. Источник данных — это место, откуда порождены сообщения или журналы событий. Конечная точка — это место, в котором в конечном итоге будут регистрироваться сообщения или журналы событий. Вы выбираете расположения для источника данных и конечной точки при создании нового маршрута в Центре Интернета вещей. Затем вы используете запросы маршрутизации для фильтрации сообщений или событий перед их переходом в конечную точку.

Вы можете использовать концентратор событий, служебную шину или раздел или учетную запись хранения, чтобы быть конечной точкой для маршрута центра Интернета вещей. Служба, используемая для создания конечной точки, должна сначала существовать в учетной записи Azure.

Примечание

Если вы используете локальную версию Azure PowerShell, войдите в Azure PowerShell перед началом работы.

Центры событий

Команды в следующих процедурах используют следующие ссылки:

• Az.IotHub
• Az.EventHub

Создание концентратора событий

Чтобы создать ресурс Центров событий с правилом авторизации, выполните следующие действия.

1. Создайте новое пространство имен Центров событий. Для NamespaceNameиспользуйте уникальное значение.

   New-AzEventHubNamespace -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Location MyLocation
   

2. Создайте новую сущность Центров событий. Для Nameиспользуйте уникальное значение. Для NamespaceNameиспользуйте имя пространства имен, созданного на предыдущем шаге.

   New-AzEventHub -Name MyEventHub -NamespaceName MyNamespace -ResourceGroupName MyResourceGroup
   

3. Создайте новое правило авторизации. Для Nameиспользуйте имя сущности для EventHubName. Для имени правила авторизации используйте уникальное значение.

   New-AzEventHubAuthorizationRule -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule -Rights @('Manage', 'Send', 'Listen')
   

   Дополнительные сведения о доступе см. в статье Авторизация доступа к Центры событий Azure.

Создание конечной точки Центров событий

1. Получите основную строку подключения из концентратора событий. Скопируйте строку подключения для последующего использования.

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

2. Создайте конечную точку Центра Интернета вещей для Центров событий. Используйте основную строку подключения из предыдущего шага. Значение для EndpointType должно быть EventHubравно . Для всех остальных параметров используйте значения для сценария.

   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.

Очередь служебной шины

Команды в следующих процедурах используют следующие ссылки:

• Az.IotHub
• Az.ServiceBus

Создание пространства имен и очереди служебной шины

Чтобы создать ресурс очереди служебной шины , выполните приведенные далее действия.

1. Создайте пространство имен служебной шины. Для Nameиспользуйте уникальное значение.

   New-AzServiceBusNamespace -ResourceGroupName MyResourceGroup -Name MyNamespace -Location MyRegion
   

2. Создайте новую очередь служебной шины. Для NamespaceNameиспользуйте имя пространства имен, созданного на предыдущем шаге. Для имени очереди используйте уникальное значение.

   New-AzServiceBusQueue -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Name MyQueue
   

Создание конечной точки очереди служебной шины

Чтобы создать новую конечную точку очереди служебной шины, выполните приведенные далее действия.

1. Получите основную строку подключения из пространства имен служебной шины. Скопируйте строку подключения для последующего использования.

   Get-AzServiceBusKey -ResourceGroupName MyResourceGroup -Namespace MyNamespace -Name RootManageSharedAccessKey
   

2. Создайте новую конечную точку Центра Интернета вещей в очереди служебной шины. Используйте основную строку подключения из предыдущего шага с ;EntityPath=MyServiceBusQueue добавлением в конец. Значение для EndpointType должно быть ServiceBusQueueравно . Для всех остальных параметров используйте значения для сценария. Для EndpointNameиспользуйте уникальное значение.

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

   Список всех вариантов конечной точки маршрутизации см. в разделе Add-AzIotHubRoutingEndpoint.

Раздел служебной шины

Команды в следующих процедурах используют следующие ссылки:

• Az.IotHub
• Az.ServiceBus

С помощью разделов служебной шины пользователи могут подписаться на один или несколько разделов. Чтобы создать раздел, необходимо также создать пространство имен и подписку служебной шины.

Создание пространства имен, раздела и подписки служебной шины

1. Создайте пространство имен служебной шины. Для Name пространства имен используйте уникальное значение.

   New-AzServiceBusNamespace -ResourceGroupName MyResourceGroup -Name MyNamespace -Location MyRegion
   

2. Создайте раздел служебной шины. Для имени раздела используйте уникальное значение.

   New-AzServiceBusTopic -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Name MyTopic
   

3. Создайте новую подписку на свой раздел. Для TopicNameиспользуйте имя раздела, созданного на предыдущем шаге. Для имени подписки используйте уникальное значение.

   New-AzServiceBusSubscription -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -TopicName MyTopic -Name MySubscription
   

Создание конечной точки раздела служебной шины

1. Получите основную строку подключения из пространства имен служебной шины. Скопируйте строку подключения, чтобы использовать ее позже.

   Get-AzServiceBusKey -ResourceGroupName MyResourceGroup -Namespace MyNamespace -Name RootManageSharedAccessKey
   

2. Создайте новую конечную точку Центра Интернета вещей в разделе Служебной шины. Используйте основную строку подключения из предыдущего шага с ;EntityPath=MyServiceBusTopic добавлением в конец. Значение для EndpointType должно быть ServiceBusTopicравно . Для всех остальных параметров используйте значения для сценария. Для EndpointNameиспользуйте уникальное значение.

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

   Список всех параметров конечной точки маршрутизации см. в разделе Add-AzIotHubRoutingEndpoint.

Хранилище Azure

Команды в следующих процедурах используют следующие ссылки:

• Az.IotHub
• Az.Storage

Чтобы создать конечную точку и маршрут службы хранилища Azure, вам потребуется учетная запись хранения и контейнер.

Создание учетной записи хранения Azure и контейнера

1. Создайте учетную запись хранения Azure. Значение учетной Name записи хранения может содержать только строчные буквы и цифры. Дополнительные SkuName сведения см. в разделе SkuName.

   New-AzStorageAccount -ResourceGroupName MyResourceGroup -Name mystorageaccount -Location westus -SkuName Standard_GRS
   

2. Создайте контейнер в учетной записи хранения. Необходимо создать контекст для учетной записи хранения в переменной, а затем добавить переменную в Context параметр . Дополнительные сведения о вариантах создания контейнера см. в статье Управление контейнерами BLOB-объектов с помощью PowerShell. Для Nameиспользуйте уникальное значение для имени контейнера.

   $ctx = New-AzStorageContext -StorageAccountName mystorageaccount -UseConnectedAccount `
   New-AzStorageContainer -Name ContainerName -Context $ctx
   

Создание конечной точки службы хранилища Azure

Чтобы создать конечную точку для службы хранилища Azure, вам потребуется ключ доступа для создания строки подключения. Затем строка подключения является частью команды Центр Интернета вещей для создания конечной точки.

1. Получите ключ доступа из учетной записи хранения и скопируйте его.

   Get-AzStorageAccountKey -ResourceGroupName MyResourceGroup -Name mystorageaccount
   

2. Создайте основную строку подключения для учетной записи хранения на основе следующего шаблона. Замените mystorageaccount (в двух местах) именем учетной записи хранения. Замените mykey своим ключом из предыдущего шага.

   "DefaultEndpointsProtocol=https;BlobEndpoint=https://mystorageaccount.blob.core.windows.net;AccountName=mystorageaccount;AccountKey=mykey"
   

   Эта строка подключения необходима на шаге для создания конечной точки.

3. Создайте конечную точку службы хранилища Azure с помощью созданной строки подключения. EndpointType должен иметь значение azurestorage. Для всех остальных параметров используйте значения для сценария. Для EndpointNameиспользуйте уникальное значение.

   Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType azurestorage -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "my connection string"
   

4. Когда появится запрос на ввод имени контейнера, введите имя контейнера и нажмите клавишу ВВОД, чтобы создать конечную точку.

Создание маршрута Центр Интернета вещей

С помощью новой конечной точки в Центре Интернета вещей можно создать новый маршрут.

Резервный маршрут по умолчанию в Центр Интернета вещей собирает сообщения из 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

Обновление маршрута Центр Интернета вещей

Чтобы внести изменения в существующий маршрут, используйте следующую команду. Например, попробуйте изменить имя маршрута с помощью команды .

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

Удаление маршрута Центр Интернета вещей

Чтобы удалить маршрут Центр Интернета вещей, выполните приведенные далее действия.

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

Совет

Удаление маршрута не приводит к удалению конечных точек в учетной записи Azure. Конечную точку необходимо удалить отдельно от удаления маршрута.

Дальнейшие действия

В этой статье вы узнали, как создать маршрут и конечную точку для Центров событий, очередей и разделов служебной шины и службы хранилища Azure.

Дополнительные сведения о маршрутизации сообщений см. в статье Руководство. Отправка данных устройств в службу хранилища Azure с помощью маршрутизации сообщений Центр Интернета вещей. В этом руководстве вы создадите маршрут хранилища и протестируете его на устройстве в Центре Интернета вещей.