Поделиться через

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

  • Статья

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

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

Примечание.

В настоящее время PowerShell не поддерживает типы проверки подлинности управляемых удостоверений для создания конечных точек. Если в сценарии не удается использовать проверку подлинности SAS, используйте один из других средств управления для создания конечных точек.

Кроме того, в настоящее время PowerShell не поддерживает создание конечных точек Cosmos DB.

Необходимые компоненты

Просмотрите предварительные требования для этой статьи на основе типа конечной точки, в которую вы хотите перенаправить сообщения.

Создание конечных точек

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

Служба, используемая для создания конечной точки, должна существовать в учетной записи Azure.

Примечание.

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

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

  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.

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

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

Резервный маршрут по умолчанию в Центр Интернета вещей собирает сообщения.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 с помощью маршрутизации сообщений Центр Интернета вещей. В этом руководстве вы создадите маршрут хранения и протестируете его с помощью устройства в Центре Интернета вещей.