Quickstart: IoT Hub Device Provisioning Service instellen met de Azure CLI
De Azure CLI wordt gebruikt voor het maken en beheren van Azure-resources vanaf de opdrachtregel of in scripts. Deze quickstart gaat gedetailleerd in op hoe de Azure CLI kan worden gebruikt om een IoT Hub en een IoT Hub Device Provisioning Service te maken, en deze twee services aan elkaar te koppelen.
Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
Belangrijk
Zowel de IoT hub als de inrichtingsservice die u in deze quickstart gaat maken, kan openbaar worden gedetecteerd als DNS-eindpunt. Voorkom dat u gevoelige informatie wijzigt als u de namen wijzigt die voor deze resources worden gebruikt.
Vereisten
Gebruik de bash-omgeving in Azure Cloud shell.
Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren.
Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht AZ login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij de Azure CLI voor aanvullende aanmeldingsopties.
Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.
Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.
Een resourcegroep maken
Een resourcegroep maken met de opdracht az group create. Een Azure-resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd.
In het volgende voorbeeld wordt een resourcegroep met de naam my-sample-resource-group gemaakt op de locatie westus.
az group create --name my-sample-resource-group --location westus
Tip
In het voorbeeld wordt de resourcegroep gemaakt op de locatie VS - west. U kunt een lijst met beschikbare locaties weergeven met de opdracht az account list-locations -o table.
Een IoT Hub maken
Maak een IoT Hub met de opdracht az iot hub create.
In het volgende voorbeeld wordt een IoT-hub met de naam my-sample-hub op de locatie westus gemaakt. De naam van een IoT-hub moet globaal uniek zijn in Azure. Daarom kan het handig zijn om een uniek voor- of achtervoegsel toe te voegen aan de voorbeeldnaam. U kunt natuurlijk ook een nieuwe naam kiezen. Zorg ervoor dat u de naamconventies voor een IoT-hub volgt, te weten: 3 tot 50 tekens lang en mag alleen bestaan uit hoofdletters, kleine letters, alfanumerieke tekens en afbreekstreepjes ('-').
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus
Een Device Provisioning Service maken
Maak een DPS met de opdracht az iot dps create.
In het volgende voorbeeld wordt een inrichtingsservice met de naam my-sample-dps op de locatie westus gemaakt. U moet ook een globaal unieke naam voor uw eigen inrichtingsservice kiezen. Zorg ervoor dat u de naamconventies voor de DPS van een IoT-hub volgt, te weten: 3 tot 64 tekens lang en mag alleen bestaan uit hoofdletters, kleine letters, alfanumerieke tekens en afbreekstreepjes ('-').
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus
Tip
In het voorbeeld wordt de inrichtingsservice gemaakt op de locatie VS - west. U kunt een lijst met beschikbare locaties weergeven door de opdracht az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table uit te voeren of door naar de pagina Status van Azure te gaan en te zoeken naar 'device provisioning service'. In opdrachten kunnen locaties worden opgegeven in één woord of in meerdere woorden, bijvoorbeeld: uswest, VS - west, US WEST enzovoort. De waarde is niet hoofdlettergevoelig. Als u meerdere woorden gebruikt om een locatie op te geven, voeg dan de waarde toe tussen aanhalingstekens; bijvoorbeeld: --location "West US".
De verbindingsreeks voor de IoT-hub ophalen
U hebt de verbindingsreeks voor uw IoT-hub nodig om deze aan de Device Provisioning Service te koppelen. Gebruik de opdracht az iot hub show-connection-string om de verbindingsreeks op te halen en om met de uitvoer ervan een variabele in te stellen die u gaat gebruiken om de twee resources aan elkaar te koppelen.
In het volgende voorbeeld wordt de variabele hubConnectionString ingesteld op de waarde van de verbindingsreeks voor de primaire sleutel van het hubbeleid iothubowner (de parameter --policy-name kan worden gebruikt om een ander beleid op te geven). Vervang my-sample-hub door de unieke naam van de IoT-hub die u eerder hebt gekozen. De opdracht maakt gebruik van de query- en uitvoeropties van de Azure CLI om de verbindingsreeks op te halen uit de uitvoer van de opdracht.
hubConnectionString=$(az iot hub show-connection-string --name my-sample-hub --key primary --query connectionString -o tsv)
U kunt de opdracht echo gebruiken om de verbindingsreeks weer te geven.
echo $hubConnectionString
Notitie
Deze twee opdrachten zijn geldig voor een host die wordt uitgevoerd onder Bash.
Als u van een lokale Windows-/CMD-shell of een PowerShell-host gebruikmaakt, moet u de opdrachten wijzigen zodat de juiste syntaxis voor deze omgeving wordt gebruikt.
Als u Azure Cloud Shell gebruikt, controleert u of de vervolgkeuzelijst Omgeving aan de linkerkant van het shellvenster staat ingesteld op Bash.
De IoT-hub en de inrichtingsservice aan elkaar koppelen
U kunt de IoT-hub en uw inrichtingsservice aan elkaar koppelen met de opdracht az iot dps linked-hub create.
In het volgende voorbeeld wordt een IoT-hub met de naam my-sample-hub op de locatie westus gekoppeld aan een Device Provisioning Service met de naam my-sample-dps. Vervang deze namen door de unieke namen van de IoT-hub-en DPS die u eerder hebt gekozen. De opdracht gebruikt de verbindingsreeks voor uw IoT-hub die in de vorige stap is opgeslagen in de variabele hubConnectionString.
az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus
Het volledig uitvoeren van de opdracht kan even duren.
De inrichtingsservice controleren
De details ophalen uit uw inrichtingsservice met de opdracht az iot dps show.
In het volgende voorbeeld worden de details van een inrichtingsservice met de naam my-sample-dps opgehaald. Vervang deze naam door de naam van uw eigen Device Provisioning Service.
az iot dps show --name my-sample-dps
De gekoppelde IoT-hub wordt weergegeven in de verzameling properties.iotHubs.
Resources opschonen
Andere Quick Starts in deze verzameling zijn op deze Quick Start gebaseerd. Als u van plan bent om door te gaan met andere Quick Starts of met de zelfstudies, verwijdert u de resources die u in deze Quick Start hebt gemaakt niet. Als u niet van plan bent om door te gaan, kunt u de volgende opdrachten gebruiken om de inrichtingsservice, de IoT-hub of de resourcegroep en alle bijbehorende resources te verwijderen. Vervang de namen van de resources die hieronder zijn geschreven door de namen van uw eigen resources.
Voer de opdracht az iot dps delete uit om de inrichtingsservice te verwijderen:
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
Voer de opdracht az iot hub delete uit om de IoT-hub te verwijderen:
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
Voer de opdracht az group delete uit om de resourcegroep en alle bijbehorende resources te verwijderen:
az group delete --name my-sample-resource-group
Volgende stappen
In deze quickstart hebt u een IoT-hub en een Device Provisioning Service-exemplaar geïmplementeerd en de twee resources gekoppeld. Als u wilt weten hoe u deze instellingen gebruikt voor het inrichten van een gesimuleerd apparaat, gaat u verder met de rest van de quickstart voor het maken van een gesimuleerd apparaat.