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

В этой статье показано, как создать маршрут и конечную точку в центре Интернета вещей Azure, а затем удалить маршрут и конечную точку. Узнайте, как использовать Azure PowerShell для создания маршрутов и конечных точек для Azure Event Hubs, очередей и тем Azure Service Bus и Azure Storage.

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

Примечание.

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

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

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

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

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

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

• Центр Интернета вещей. Если у вас нет центра, выполните действия по созданию Центра Интернета вещей.

• Azure PowerShell. Чтобы использовать Azure PowerShell локально, установите модуль Azure PowerShell на компьютере. Кроме того, чтобы использовать Azure PowerShell в веб-браузере, включите Azure Cloud Shell.

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

• (Рекомендуется) Управляемое удостоверение с разрешениями на управление доступом на основе ролей для области имен Event Hubs. Для получения дополнительной информации см. Аутентификация управляемого удостоверения с помощью Microsoft Entra ID для доступа к ресурсам Event Hubs.

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

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

• Центр Интернета вещей. Если у вас нет центра, выполните действия по созданию Центра Интернета вещей.

• Azure PowerShell. Чтобы использовать Azure PowerShell локально, установите модуль Azure PowerShell на компьютере. Кроме того, чтобы использовать Azure PowerShell в веб-браузере, включите Azure Cloud Shell.

• Ресурс очереди служебная шина. Если вам нужно создать новую очередь служебная шина, см. краткое руководство. Создание пространства имен служебная шина и очереди.

• (Рекомендуется) Управляемое удостоверение с разрешениями управления доступом на основе ролей для пространства имен служебная шина или очереди. Дополнительные сведения см. в статье Аутентифицируйте управляемое удостоверение с Microsoft Entra ID для доступа к ресурсам Azure Service Bus

Тема служебной шины

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

• Центр Интернета вещей. Если у вас нет центра, выполните действия по созданию Центра Интернета вещей.

• Azure PowerShell. Чтобы использовать Azure PowerShell локально, установите модуль Azure PowerShell на компьютере. Кроме того, чтобы использовать Azure PowerShell в веб-браузере, включите Azure Cloud Shell.

• Ресурс темы Service Bus. Если вам нужно создать новую тему Service Bus, см. краткое руководство: Создание пространства имен Service Bus с темой и подпиской с помощью шаблона Resource Manager.

• (Рекомендуется) Управляемое удостоверение с разрешениями управления доступом на основе ролей для пространства имен или топика в Service Bus. Для получения дополнительной информации см. статью Аутентифицировать управляемое удостоверение с помощью идентификатора Microsoft Entra для доступа к ресурсам Azure Service Bus

Хранилище Azure

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

• Центр Интернета вещей. Если у вас нет центра, выполните действия по созданию Центра Интернета вещей.

• Azure PowerShell. Чтобы использовать Azure PowerShell локально, установите модуль Azure PowerShell на компьютере. Кроме того, чтобы использовать Azure PowerShell в веб-браузере, включите Azure Cloud Shell.

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

• (Рекомендуется) Управляемое удостоверение с разрешениями на управление доступом на основе ролей для учетной записи хранения. Дополнительные сведения см. в статье Назначение роли Azure для доступа к данным BLOB-объектов.

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

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

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

Примечание.

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

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

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

• Az.IotHub
• Az.EventHub

1. Получите основную строку подключения из Event Hub. Скопируйте строку подключения для использования позже.

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

2. Создайте новую конечную точку узела IoT для Центров событий. Используйте основную строку подключения из предыдущего шага. Значение 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. Получите основную строку подключения из пространства имен службы Service Bus. Скопируйте строку подключения для последующего использования.

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

2. Создайте новую конечную точку Центра Интернета вещей для очереди Service Bus. Используйте основную строку подключения из предыдущего шага и добавьте в конец ;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. Получите основную строку подключения из пространства имен Служебной шины. Скопируйте строку подключения для последующего использования.

   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, вам потребуется ключ доступа для создания строка подключения. Затем строка подключения является частью команды IoT Hub для создания конечной точки.

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

Обновление маршрута IoT-хаба

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

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:

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

Совет

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

Следующие шаги

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

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