Créer et supprimer des itinéraires et des points de terminaison à l’aide de Azure PowerShell

Cet article vous montre comment créer un itinéraire et un point de terminaison dans votre hub IoT, puis supprimer votre itinéraire et votre point de terminaison. Découvrez comment utiliser Azure PowerShell pour créer des itinéraires et des points de terminaison pour Azure Event Hubs, des files d’attente et des rubriques Azure Service Bus, et stockage Azure.

Pour en savoir plus sur le fonctionnement du routage dans IoT Hub, consultez Utiliser le routage des messages IoT Hub pour envoyer des messages appareil-à-cloud à différents points de terminaison. Pour vous guider dans la configuration d’un itinéraire qui envoie des messages au stockage et le test sur un appareil simulé, consultez Tutoriel : Envoyer des données d’appareil à stockage Azure à l’aide du routage des messages IoT Hub.

Prérequis

Les procédures décrites dans l’article utilisent les ressources suivantes :

• Azure PowerShell
• Un hub IoT
• Un service de point de terminaison dans Azure

Azure PowerShell

Cet article utilise Azure PowerShell pour travailler avec IoT Hub et d'autres services Azure. Pour utiliser Azure PowerShell localement, installez le module Azure PowerShell sur votre ordinateur. Vous pouvez également utiliser Azure PowerShell dans un navigateur en activant Azure Cloud Shell.

hub IOT

Pour créer une route IoT Hub, vous avez besoin d’un hub IoT que vous avez créé en utilisant Azure IoT Hub. Les messages d’appareil et les journaux des événements proviennent de votre hub IoT.

Veillez à disposer de la ressource hub suivante à utiliser lorsque vous créez votre route IoT Hub :

• Un IoT Hub Azure. Si vous n’avez pas de IoT Hub, vous pouvez utiliser la cmdlet New-AzIoTHub afin d’en créer un ou bien suivre les étapes décrites dans Créer un hub IoT.

Service de point de terminaison

Pour créer une route IoT Hub, vous avez besoin d’au moins un autre service Azure à utiliser comme point de terminaison de la route. Le point de terminaison reçoit les messages d’appareil et les journaux des événements. Vous pouvez choisir le service Azure à utiliser comme point de terminaison afin de vous connecter à votre route IoT Hub : Event Hubs, files d’attente ou rubriques Service Bus, ou Stockage Azure.

Veillez à avoir une des ressources suivantes à utiliser lorsque vous créez un point de terminaison pour votre route IoT Hub :

• Une ressource Event Hubs (avec conteneur). Si vous devez créer une nouvelle ressource Event Hubs, consultez Démarrage rapide : Créer un hub d’événements avec Azure PowerShell.

• Une ressource de file d’attente Service Bus. Consultez Utiliser Azure PowerShell pour créer une file d’attente Service Bus si vous devez créer un espace de noms et une file d’attente Service Bus.

• Ressource de rubrique Service Bus. Si vous devez créer une nouvelle rubrique Service Bus, consultez la référence New-AzServiceBusTopic et la documentation Messagerie Azure Service Bus.

• Une ressource de stockage Azure. Si vous devez créer un compte de stockage dans Azure, consultez Créer un compte de stockage.

Créer des ressources et des points de terminaison

Dans IoT Hub, vous pouvez créer un itinéraire pour envoyer des messages ou capturer des événements. Chaque itinéraire a une source de données et un point de terminaison. La source de données est l’origine des messages ou des journaux des événements. Le point de terminaison est l’endroit où se terminent les messages ou les journaux d’événements. Vous choisissez des emplacements pour la source de données et le point de terminaison lorsque vous créez un itinéraire dans votre hub IoT. Ensuite, vous utilisez les requêtes de routage pour filtrer les messages ou les événements avant qu’ils accèdent au point de terminaison.

Vous pouvez utiliser un concentrateur d’événements, une file d’attente ou un sujet de Service Bus, ou un compte de stockage comme point de terminaison pour votre route de concentrateur IoT. Le service que vous utilisez pour créer votre point de terminaison doit d’abord exister dans votre compte Azure.

Notes

Si vous utilisez une version locale de Azure PowerShell, connectez-vous à Azure PowerShell avant de commencer.

Hubs d'événements

Les commandes des procédures suivantes utilisent ces références :

• Az.IotHub
• Az.EventHub

Créer un hub d’événements

Pour créer une ressource Event Hubs avec une règle d’autorisation :

1. Créez un espace de noms Event Hubs. Pour NamespaceName, utilisez une valeur unique.

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

2. Créez votre nouvelle entité Event Hubs. Pour Name, utilisez une valeur unique. Pour NamespaceName, utilisez le nom de l’espace de noms que vous avez créé à l’étape précédente.

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

3. Créez une nouvelle règle d'autorisation. Pour Name, utilisez le nom de votre entité pour EventHubName. Pour le nom de votre règle d’autorisation, utilisez une valeur unique.

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

   Pour plus d’informations sur l’accès, consultez Autoriser l’accès à Azure Event Hubs.

Créer un point de terminaison Event Hubs

1. Obtenez la chaîne de connexion principale à partir de votre Event Hub. Copiez la chaîne de connexion à utiliser plus tard.

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

2. Créez un nouveau point de terminaison IoT Hub pour Event Hubs. Utilisez votre chaîne de connexion principale de l’étape précédente. La valeur de EndpointType doit être EventHub. Pour tous les autres paramètres, utilisez les valeurs de votre scénario.

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

   Pour afficher toutes les options de point de terminaison de routage, consultez Add-AzIotHubRoutingEndpoint.

File d’attente Service Bus

Les commandes des procédures suivantes utilisent ces références :

• Az.IotHub
• Az.ServiceBus

Créer un espace de noms et une file d’attente Service Bus

Pour créer une nouvelle ressource de file d’attente Service Bus :

1. Créez un espace de noms Service Bus. Pour Name, utilisez une valeur unique.

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

2. Créez une nouvelle file d’attente Service Bus. Pour NamespaceName, utilisez le nom de l’espace de noms que vous avez créé à l’étape précédente. Pour le nom de votre file d’attente, utilisez une valeur unique.

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

Créer un point de terminaison de file d’attente Service Bus

Pour créer un point de terminaison de file d’attente Service Bus :

1. Récupérez la chaîne de connexion principale depuis votre espace de noms Service Bus. Copiez la chaîne de connexion à utiliser plus tard.

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

2. Créez un nouveau point de terminaison IoT Hub dans votre file d’attente Service Bus. Utilisez votre chaîne de connexion principale de l’étape précédente en ajoutant ;EntityPath=MyServiceBusQueue à la fin. La valeur de EndpointType doit être ServiceBusQueue. Pour tous les autres paramètres, utilisez les valeurs de votre scénario. Pour EndpointName, utilisez une valeur unique.

   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"
   

   Pour obtenir la liste de toutes les options de point de terminaison de routage, consultez Add-AzIotHubRoutingEndpoint.

Rubrique Service Bus

Les commandes des procédures suivantes utilisent ces références :

• Az.IotHub
• Az.ServiceBus

Avec les rubriques Service Bus, les utilisateurs peuvent s'abonner à une ou plusieurs rubriques. Pour créer une rubrique, vous créez également un espace de noms et un abonnement Service Bus.

Créer un espace de noms Service Bus, une rubrique et un abonnement

1. Créez un espace de noms Service Bus. Pour votre espace de noms Name, utilisez une valeur unique.

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

2. Créer une nouvelle rubrique Service Bus. Pour le nom de la rubrique, utilisez une valeur unique.

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

3. Créez un abonnement à votre rubrique. Pour TopicName, utilisez le nom du sujet que vous avez créé à l’étape précédente. Pour le nom de votre abonnement, utilisez une valeur unique.

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

Créer un point de terminaison de rubrique Service Bus

1. Récupérez la chaîne de connexion principale depuis votre espace de noms Service Bus. Copiez la chaîne de connexion à utiliser plus tard.

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

2. Créez un nouveau point de terminaison IoT Hub dans votre rubrique Service Bus. Utilisez votre chaîne de connexion principale de l’étape précédente en ajoutant ;EntityPath=MyServiceBusTopic à la fin. La valeur de EndpointType doit être ServiceBusTopic. Pour tous les autres paramètres, utilisez les valeurs de votre scénario. Pour EndpointName, utilisez une valeur unique.

   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"
   

   Pour obtenir la liste de toutes les options de point de terminaison de routage, consultez Add-AzIotHubRoutingEndpoint.

Stockage Azure

Les commandes des procédures suivantes utilisent ces références :

• Az.IotHub
• Az.Storage

Pour créer un point de terminaison et un itinéraire Stockage Azure, vous avez besoin d’un compte et d’un conteneur Stockage.

Créer un compte de stockage Azure et un conteneur

1. Créez un compte de stockage Azure. La valeur de Name pour votre compte de stockage ne peut contenir que des lettres minuscules et des chiffres. Pour les options SkuName, consultez SkuName.

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

2. Créez un nouveau conteneur dans votre compte de stockage. Vous devez créer un contexte pour votre compte de stockage dans une variable, puis ajouter la variable au paramètre Context. Pour en savoir plus sur vos options lors de la création d’un conteneur, consultez Gérer les conteneurs d’objets blob à l’aide de PowerShell. Pour Name, utilisez une valeur unique pour le nom de votre conteneur.

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

Créer un point de terminaison Stockage Azure

Pour créer un point de terminaison dans Stockage Azure, vous avez besoin de votre clé d’accès pour construire une chaîne de connexion. La chaîne de connexion fait alors partie de la commande IoT Hub pour créer un point de terminaison.

1. Récupérez votre clé d’accès à partir de votre compte de stockage et copiez-la.

   Get-AzStorageAccountKey -ResourceGroupName MyResourceGroup -Name mystorageaccount
   

2. Construisez une chaîne de connexion primaire pour votre compte de stockage en vous basant sur le modèle suivant. Remplacez mystorageaccount (à deux endroits) par le nom de votre compte de stockage. Remplacez mykey par la clé obtenue à l’étape précédente.

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

   Cette chaîne de connexion est requise dans l’étape de création du point de terminaison.

3. Créez votre point de terminaison Stockage Azure avec la chaîne de connexion que vous avez construite. EndpointType doit avoir la valeur azurestorage. Pour tous les autres paramètres, utilisez les valeurs de votre scénario. Pour EndpointName, utilisez une valeur unique.

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

4. Lorsque vous êtes invité à entrer le nom de votre conteneur, entrez le nom de votre conteneur, puis sélectionnez Entrée pour créer le point de terminaison.

Créer un itinéraire IoT Hub

Avec votre nouveau point de terminaison dans votre hub IoT, vous pouvez créer un itinéraire.

La route de repli par défaut dans IoT Hub collecte les messages de DeviceMessages. Choisissez une autre option pour votre itinéraire personnalisé, par exemple DeviceConnectionStateEvents. Pour plus d’informations sur les options de la source, consultez Add-AzIotHubRoute. Le paramètre Enabled étant un commutateur, vous n’avez pas besoin d’utiliser une valeur avec le paramètre .

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

PowerShell affiche une confirmation qui ressemble à cet exemple :

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

Mettre à jour un itinéraire IoT

Pour apporter des modifications à un itinéraire existant, utilisez la commande suivante. Par exemple, essayez de modifier le nom de votre itinéraire à l’aide de la commande .

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

Utilisez la commande Get-AzIotHubRoute pour confirmer la modification de votre itinéraire :

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

Supprimer un point de terminaison

Pour supprimer un point de terminaison :

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

Supprimer un itinéraire IoT

Pour supprimer un itinéraire IoT Hub :

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

Conseil

La suppression d’un itinéraire ne supprime pas les points de terminaison de votre compte Azure. Vous devez supprimer un point de terminaison séparément de la suppression d’un itinéraire.

Étapes suivantes

Dans cet article pratique, vous avez appris à créer un itinéraire et un point de terminaison pour votre instance Event Hubs, votre file d’attente ou vos rubriques Service Bus, et le Stockage Azure.

Pour en savoir plus sur le routage des messages, consultez Tutoriel : Envoyer des données d’appareil au Stockage Azure en utilisant le routage des messages IoT Hub. Dans le tutoriel, vous allez créer un itinéraire de stockage et le tester avec un appareil dans votre hub IoT.