Создание и удаление маршрутов и конечных точек с помощью 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.

Центр IoT

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

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

• Центр интернета вещей Azure. Если у вас нет центра Интернета вещей, можно использовать командлет 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.

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

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

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