Créez un IoT Hub à l’aide de la cmdlet New-AzIotHub

Vous pouvez utiliser les cmdlets Azure PowerShell pour créer et gérer des IoT Hubs Azure. Ce didacticiel vous montre comment créer un IoT Hub à l’aide de PowerShell.

Notes

Nous vous recommandons d’utiliser le module Azure Az PowerShell pour interagir avec Azure. Pour commencer, consultez Installer Azure PowerShell. Pour savoir comment migrer vers le module Az PowerShell, consultez Migrer Azure PowerShell depuis AzureRM vers Az.

Vous pouvez également utiliser Azure Cloud Shell, si vous préférez ne pas installer de modules supplémentaires sur votre ordinateur. La section suivante vous permet de démarrer avec Azure Cloud Shell.

Azure Cloud Shell

Azure héberge Azure Cloud Shell, un environnement d’interpréteur de commandes interactif que vous pouvez utiliser dans votre navigateur. Vous pouvez utiliser Bash ou PowerShell avec Cloud Shell pour utiliser les services Azure. Vous pouvez utiliser les commandes préinstallées Cloud Shell pour exécuter le code de cet article sans avoir à installer quoi que ce soit dans votre environnement local.

Pour démarrer Azure Cloud Shell :

Option Exemple/Lien
Sélectionnez Essayer dans le coin supérieur droite d’un bloc de codes ou de commandes. La sélection de Essayer ne copie pas automatiquement le code ni la commande dans Cloud Shell. Screenshot that shows an example of Try It for Azure Cloud Shell.
Accédez à https://shell.azure.com ou sélectionnez le bouton Lancer Cloud Shell pour ouvrir Cloud Shell dans votre navigateur. Button to launch Azure Cloud Shell.
Sélectionnez le bouton Cloud Shell dans la barre de menus en haut à droite du portail Azure. Screenshot that shows the Cloud Shell button in the Azure portal

Pour utiliser Azure Cloud Shell :

  1. Démarrez Cloud Shell.

  2. Sélectionnez le bouton Copier sur un bloc de codes (ou un bloc de commandes) pour copier le code ou la commande.

  3. Collez le code ou la commande dans la session Cloud Shell en sélectionnant Ctrl+Maj+V sur Windows et Linux ou en sélectionnant Cmd+Maj+V sur macOS.

  4. Sélectionnez Entrée pour exécuter le code ou la commande.

Prérequis

Vous avez besoin d’un groupe de ressources pour déployer un IoT Hub. Vous pouvez utiliser un groupe de ressources existant ou en créer un.

Pour créer un nouveau groupe de ressources pour votre hub IoT, utilisez la commande New-AzResourceGroup. Cet exemple crée un groupe de ressources appelé MyIoTRG1 dans la région USA Est :

New-AzResourceGroup -Name MyIoTRG1 -Location "East US"

Connectez-vous à un abonnement Azure

Si vous utilisez Cloud Shell, vous êtes déjà connecté à votre abonnement, ce qui vous permet d’ignorer cette section. Par contre, si vous exécutez PowerShell localement, entrez la commande suivante pour vous connecter à votre abonnement Azure :

# Log into Azure account.
Login-AzAccount

Créer un hub IoT

Créez un IoT hub à l’aide de votre groupe de ressources. Utilisez la commande New-AzIotHub . Cet exemple crée un hub S1 appelé MyTestIoTHub dans la région USA Est :

New-AzIotHub `
    -ResourceGroupName MyIoTRG1 `
    -Name MyTestIoTHub `
    -SkuName S1 -Units 1 `
    -Location "East US"

Le nom du hub IoT doit être globalement unique.

Important

Comme le hub IoT sera publiquement détectable en tant que point de terminaison DNS, veillez à éviter d’entrer des informations sensibles ou personnellement identifiables quand vous le nommez.

Pour lister tous les hubs IoT de votre abonnement, utilisez la commande Get-AzIotHub.

Cet exemple montre le hub IoT Standard S1 que vous avez créé à l’étape précédente.

Get-AzIotHub

Pour supprimer le hub IoT, utilisez la commande Remove-AzIotHub.

Remove-AzIotHub `
    -ResourceGroupName MyIoTRG1 `
    -Name MyTestIoTHub

Mettre à jour le hub IoT

Vous pouvez modifier les paramètres d’un hub IoT existant après sa création. Voici des propriétés que vous pouvez définir pour un hub IoT :

Tarification et mise à l’échelle : migrer vers un autre niveau ou définir le nombre d’unités IoT Hub.

Filtre IP : Spécifiez une plage d’adresses IP qui seront acceptées ou rejetées par le hub IoT.

Propriétés : liste des propriétés que vous pouvez copier et utiliser ailleurs, comme l’ID de ressource, le groupe de ressources, l’emplacement, etc.

Explorez les commandes Set-AzIotHub pour obtenir une liste complète des options de mise à jour.

Étapes suivantes

Maintenant que vous avez déployé un hub IoT en utilisant une cmdlet PowerShell, explorez d’autres articles :

Développer pour IoT Hub :

Explorer les fonctionnalités d’IoT Hub :