Snabbstart: Konfigurera IoT Hub Device Provisioning Service med Azure CLI
Azure CLI används för att skapa och hantera Azure-resurser från kommandoraden eller i skript. Den här snabbstarten beskriver hur du använder Azure CLI för att skapa en IoT-hubb och en IoT Hub Device Provisioning Service och för att länka ihop de två tjänsterna.
Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.
Viktigt
Både IoT-hubben och etableringstjänsten som du skapar i den här snabbstarten kan upptäckas offentligt som DNS-slutpunkter. Undvik känslig information om du vill ändra de namn som används för dessa resurser.
Förutsättningar
Använd bash-miljön i Azure Cloud Shell.
Om du vill kan du i stället installera Azure CLI för att köra CLI-referenskommandon.
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. Fler inloggningsalternativ finns i Logga in med Azure CLI.
När du uppmanas till det installerar du Azure CLI-tillägg 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.
Skapa en resursgrupp
Skapa en resursgrupp med kommandot az group create. En Azure-resursgrupp är en logisk container där Azure-resurser distribueras och hanteras.
I följande exempel skapas en resursgrupp med namnet my-sample-resource-group på platsen usavästra.
az group create --name my-sample-resource-group --location westus
Tips
I exemplet skapas en resursgrupp på platsen USA, västra. Du kan visa en lista över tillgängliga platser genom att köra kommandot az account list-locations -o table.
Skapa en IoT Hub
Skapa en IoT-hubb med kommandot az iot hub create.
I följande exempel skapas en IoT-hubb med namnet my-sample-hub på platsen usavästra. Ett IoT-hubbnamn måste vara globalt unikt i Azure, så du kanske vill lägga till ett unikt prefix eller suffix i exempelnamnet eller välja ett nytt namn helt och hållet. Kontrollera att namnet följer lämpliga namngivningskonventioner för en IoT-hubb: det ska vara mellan 3 och 50 tecken långt och får endast innehålla alfanumeriska versaler eller gemener eller bindestreck (-).
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus
Skapa en enhetsetableringstjänst
Skapa en device provisioning-tjänst med kommandot az iot dps create.
I följande exempel skapas en etableringstjänst med namnet my-sample-dps på platsen westus. Du måste också välja ett globalt unikt namn för din egen etableringstjänst. Se till att den följer lämpliga namngivningskonventioner för en IoT Hub Device Provisioning Service: den ska vara 3–64 tecken lång och får bara innehålla alfanumeriska versaler eller gemener eller bindestreck (-).
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus
Tips
I exemplet skapas en etableringstjänst på platsen USA, västra. Du kan se en lista med tillgängliga platser genom att köra kommandot az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table, eller genom att gå till sidan Azure-status och söka efter ”enhetsetableringstjänst”. I kommandon kan platser anges antingen i ett eller flera ord. exempel: USA, västra; USA, västra; USA, västra osv. Värdet är inte ärendekänsligt. Om du använder flera ord för att ange platsen skriver du värdet inom citattecken; till exempel --location "West US".
Hämta anslutningssträngen för IoT-hubben
Du behöver IoT-hubbens anslutningssträng för att kunna länka den till enhetsetableringstjänsten. Använd kommandot az iot hub show-connection-string för att hämta anslutningssträngen. Använd sedan dess utdata för att ställa in en variabel som ska användas när du länkar de två resurserna.
I följande exempel anges variabeln hubConnectionString till värdet för anslutningssträngen för den primära nyckeln för hubbens iothubowner-princip (parametern kan användas för att ange en --policy-name annan princip). Byta ut my-sample-hub mot det unika IoT-hubbnamn som du valde tidigare. Kommandot använder Azure CLI-frågan och utdataalternativ till att extrahera anslutningssträngen från kommandots utdata.
hubConnectionString=$(az iot hub show-connection-string --name my-sample-hub --key primary --query connectionString -o tsv)
Du kan använda kommandot echo om du vill se anslutningssträngen.
echo $hubConnectionString
Anteckning
Dessa två kommandon är giltiga för en värd som körs under Bash.
Om du använder ett lokalt Windows-/CMD-gränssnitt eller en PowerShell-värd ändrar du kommandona så att de använder rätt syntax för den miljön.
Om du använder Azure Cloud Shell kontrollerar du att miljö listrutan till vänster i gränssnittsfönstret säger Bash.
Länka IoT-hubben och etableringstjänsten
Länka IoT-hubben och etableringstjänsten med kommandot az iot dps linked-hub create.
I följande exempel länkas en IoT-hubb med namnet my-sample-hub på platsen usa, västra och en enhetsetableringstjänst med namnet my-sample-dps. Byta ut dessa namn mot de unika namnen på IoT-hubben och enhetsetableringstjänsten som du valde tidigare. Kommandot använder anslutningssträngen för din IoT-hubb som lagrades i variabeln hubConnectionString i föregående steg.
az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus
Det kan ta några minuter att slutföra kommandot.
Kontrollera etableringstjänsten
Hämta information om etableringstjänsten med kommandot az iot dps show.
I följande exempel hämtas information om en etableringstjänst med namnet my-sample-dps. Byta ut det här namnet mot ditt eget namn på enhetsetableringstjänsten.
az iot dps show --name my-sample-dps
Den länkade IoT-hubben visas i samlingen properties.iotHubs.
Rensa resurser
De andra snabbstarterna i den här samlingen bygger på den här snabbstarten. Om du planerar att fortsätta att arbeta med efterföljande snabbstarter eller med självstudierna ska du inte rensa resurserna som skapas i denna snabbstart. Om du inte tänker fortsätta kan du använda följande kommandon för att ta bort etableringstjänsten, IoT-hubben eller resursgruppen och alla dess resurser. Ersätt namnen på resurserna som skrivits nedan med namnen på dina egna resurser.
Ta bort etableringstjänsten genom att köra kommandot az iot dps delete:
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
Ta bort IoT-hubben genom att köra kommandot az iot hub delete:
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
Ta bort en resursgrupp och alla dess resurser genom att köra kommandot az group delete:
az group delete --name my-sample-resource-group
Nästa steg
I den här snabbstarten har du distribuerat en IoT-hubb och en instans av enhetsetableringstjänsten och länkat de två resurserna. Om du vill lära dig hur du använder den här konfigurationen för att etablera en simulerad enhet fortsätter du till snabbstarten för att skapa en simulerad enhet.