Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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-instans och för att länka ihop de två tjänsterna.
Om du inte har något Azure-konto skapar du ett kostnadsfritt konto innan du börjar.
Viktigt!
Både IoT-hubben och etableringstjänsten som du skapar i den här snabbstarten kan identifieras offentligt som DNS-slutpunkter. Se till att undvika känslig information om du bestämmer dig för att ändra namnen som används för dessa resurser.
Förutsättningar
Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Kom igång med Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör på Windows eller macOS, överväg att köra Azure CLI i en Docker-container. För mer information, se Hur man kör 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. För att slutföra autentiseringsprocessen, följ stegen som visas i din terminal. Andra inloggningsalternativ finns i Autentisera till Azure med Azure CLI.
När du blir uppmanad, installera Azure CLI-tillägget vid första användning. Mer information om tillägg finns i Använda och hantera tillägg med Azure CLI.
Kör az version för att ta reda på 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 behållare i vilken Azure-resurser distribueras och hanteras.
I följande exempel skapas en resursgrupp med namnet my-sample-resource-group på platsen westus .
az group create --name my-sample-resource-group --location westus
Tips/Råd
I exemplet skapas resursgruppen i området Väst-USA. Du kan visa en lista över tillgängliga platser genom att köra kommandot az account list-locations -o table.
Skapa en IoT-hubb
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 westus . Ett IoT-hubbnamn måste vara globalt unikt i Azure, så lägg antingen till ett unikt prefix eller suffix i exempelnamnet eller välj ett nytt namn helt och hållet. Kontrollera att namnet följer rätt namngivningskonventioner för en IoT-hubb: det ska vara 3–50 tecken långt och får endast innehålla alfanumeriska tecken eller bindestreck i versaler eller gemener (-).
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus
Skapa en enhetsetableringstjänstinstans
Skapa en Device Provisioning Service-instans med kommandot az iot dps create .
I följande exempel skapas en instans av tjänsten Device Provisioning Service med namnet my-sample-dps i området westus. Du måste också välja ett globalt unikt namn för din egen instans. Kontrollera att den följer lämpliga namngivningskonventioner för en IoT Hub Device Provisioning-tjänst: den ska vara 3–64 tecken lång och får endast innehålla alfanumeriska versaler eller bindestreck (-).
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus
Tips/Råd
Exemplet skapar konfigurationstjänsten på platsen Västra USA. Du kan visa en lista över 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 "Device Provisioning Service". I kommandon kan platser anges antingen i ett ord- eller flerordsformat. till exempel: westus, USA, västra, USA, VÄSTRA osv. Värdet är inte skiftlägeskänsligt. Om du använder flerordsformat för att ange plats omger du värdet inom citattecken. till exempel --location "West US".
För återhämtning och tillförlitlighet rekommenderar vi att du distribuerar till en av de regioner som stöder Tillgänglighetszoner.
Hämta anslutningssträngen för IoT-hubben
Du behöver IoT-hubbens anslutningssträng för att länka den till Enhetsetableringstjänsten. Använd kommandot az iot hub connection-string show för att hämta anslutningssträngen och använda dess utdata för att ange en variabel som används senare 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 i hubbens iothubowner-princip (parametern --policy-name kan användas för att ange en annan princip). Byt ut my-sample-hub för det unika IoT Hub-namnet som du valde tidigare. Kommandot använder Azure CLI fråge och utdata alternativen för att extrahera anslutningssträngen från kommandoutdata.
hubConnectionString=$(az iot hub connection-string show --name my-sample-hub --key primary --query connectionString -o tsv)
Du kan använda echo kommandot för att se anslutningssträngen.
echo $hubConnectionString
Anmärkning
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 det står Bash i listrutan till vänster i gränssnittet.
Länka IoT-hubben och provisioneringstjänsten
Länka IoT-hubben och provisionstjä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 westus och en Device Provisioning-tjänst med namnet my-sample-dps. Byt ut dessa namn mot de unika IoT-hubben och enhetsetableringstjänstens namn 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.
Verifiera försörjningstjänsten
Hämta detaljer om provisioningtjänsten med kommandot az iot dps show.
I följande exempel hämtas detaljer om en driftstjänst med namnet my-sample-dps. Byt ut det här namnet mot ditt eget enhetsetableringstjänstnamn.
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 arbeta med efterföljande snabbstarter eller självstudier ska du inte rensa resurserna som skapades i den här snabbstarten. Om du inte planerar att 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å de resurser som ingår i följande kommandon med namnen på dina egna resurser.
Om du vill ta bort etableringstjänsten kör du kommandot az iot dps delete :
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
Om du vill ta bort IoT-hubben kör du kommandot az iot hub delete :
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
Om du vill ta bort en resursgrupp och alla dess resurser kör du kommandot az group delete :
az group delete --name my-sample-resource-group
Nästa steg
I den här snabbstarten distribuerade du en IoT-hubb och en enhetsetableringstjänstinstans och länkade de två resurserna. Om du vill lära dig hur du använder den här konfigurationen för att etablera en enhet fortsätter du till snabbstarten för att skapa en enhet.