Skapa en IoT-hubb med hjälp av Azure CLI
Den här artikeln visar hur du skapar en IoT-hubb med hjälp av Azure CLI.
Förutsättningar
Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.
Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.
När du uppmanas att göra det installerar du Azure CLI-tillägget vid första användning. Mer information om tillägg finns i Använda tillägg med Azure CLI.
Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.
När du skapar en IoT-hubb måste du skapa den i en resursgrupp. Använd en befintlig resursgrupp eller kör följande kommando för att skapa en resursgrupp:
az group create --name {your resource group name} --location westus
Tips
I föregående exempel skapas en resursgrupp i USA, västra. Du kan visa en lista över tillgängliga platser genom att köra det här kommandot:
az account list-locations -o table
Skapa en IoT Hub
Använd Azure CLI för att skapa en resursgrupp och lägg sedan till en IoT-hubb.
Kör följande kommando för att skapa en IoT-hubb i din resursgrupp med ett globalt unikt namn för IoT-hubben:
az iot hub create --name {your iot hub name} \
--resource-group {your resource group name} --sku S1
Viktigt
Eftersom IoT-hubben kan identifieras offentligt som en DNS-slutpunkt bör du undvika att ange känslig eller personligt identifierbar information när du namnger den.
Föregående kommando skapar en IoT-hubb på prisnivån S1 som du debiteras för. Mer information finns i Azure IoT Hub prissättning.
Mer information om Azure IoT Hub kommandon finns i referensartikelnaz iot hub
.
Uppdatera IoT-hubben
Du kan ändra inställningarna för en befintlig IoT-hubb när den har skapats. Här följer några egenskaper som du kan ange för en IoT-hubb:
Prissättning och skala: Migrera till en annan nivå eller ange antalet IoT Hub enheter.
IP-filter: Ange ett intervall med IP-adresser som ska accepteras eller avvisas av IoT-hubben.
Egenskaper: En lista med egenskaper som du kan kopiera och använda någon annanstans, till exempel resurs-ID, resursgrupp, plats och så vidare.
En fullständig lista över alternativ för att uppdatera en IoT-hubb finns på referenssidan az iot hub update commands .
Registrera en ny enhet i IoT-hubben
I det här avsnittet skapar du en enhetsidentitet i identitetsregistret i din IoT-hubb. En enhet kan inte ansluta till en hubb om den inte har en post i identitetsregistret. Mer information finns i Förstå identitetsregistret i din IoT-hubb. Den här enhetsidentiteten är IoT Edge aktiverad.
Kör följande kommando för att skapa en enhetsidentitet. Använd IoT-hubbens namn och skapa ett nytt enhets-ID i stället för {iothub_name}
och {device_id}
. Det här kommandot skapar en enhetsidentitet med standardauktorisering (delad privat nyckel).
az iot hub device-identity create -n {iothub_name} -d {device_id} --ee
Resultatet är en JSON-utskrift som innehåller dina nycklar och annan information.
Det finns också flera alternativ för att registrera en enhet med olika typer av auktorisering. Mer information om alternativen finns i Exempel på referenssidan az iot hub device-identity .
Ta bort en IoT-hubb
Det finns olika kommandon för att ta bort en enskild resurs, till exempel en IoT-hubb.
Om du vill ta bort en IoT-hubb kör du följande kommando:
az iot hub delete --name {your iot hub name} -\
-resource-group {your resource group name}
Nästa steg
Läs mer om de kommandon som är tillgängliga i Microsoft Azure IoT-tillägget för Azure CLI: