Apparaatupdate maken voor IoT Hub-resources

Als u aan de slag wilt met Device Update, maakt u een Device Update-account en -exemplaar en stelt u vervolgens toegangsbeheerrollen in.

Een Apparaatupdate-account is een resource in uw Azure-abonnement. Een Device Update-exemplaar is een logische container binnen een account dat is gekoppeld aan een specifieke IoT-hub. Een exemplaar bevat updates en implementaties die zijn gekoppeld aan de IoT-hub. U kunt meerdere exemplaren binnen een account maken. Zie Device Update-resources voor meer informatie.

Vereisten

Azure-portal

Een IoT-hub. U moet een S1-laag (Standard) of hoger gebruiken.

Azure-CLI

• Een IoT-hub. U moet een S1-laag (Standard) of hoger gebruiken.

• Een Azure CLI-omgeving:

  • Gebruik de Bash-omgeving in Azure Cloud Shell.

    

  • Als u liever CLI-referentieopdrachten lokaal uitvoert, installeert u de Azure CLI

    • Meld u aan bij de Azure CLI met behulp van de opdracht az login .

    • 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.

    • Installeer bij het eerste gebruik de Azure CLI-extensie wanneer hierom wordt gevraagd. De opdrachten in dit artikel gebruiken de azure-iot-extensie . Voer deze opdracht uit az extension update --name azure-iot om ervoor te zorgen dat u de nieuwste versie van de extensie gebruikt.

Een account en exemplaar maken

Azure-portal

1. Selecteer een resource maken in Azure Portal en zoek naar 'Device Update for IoT Hub'

2. Selecteer Apparaatupdate>maken voor IoT Hub

   

3. Geef op het tabblad Basisinformatie de volgende informatie op voor uw Device Update-account en -exemplaar:

   • Abonnement: het Azure-abonnement dat moet worden gekoppeld aan uw Device Update-account.
   • Resourcegroep: een bestaande of nieuwe resourcegroep.
   • Naam: Een naam voor uw account.
   • Locatie: de Azure-regio waar uw account zich bevindt. Zie de pagina Azure Products-by-region voor informatie over welke regio's ondersteuning bieden voor Device Update voor IoT Hub.
   • Schakel het selectievakje in om de beheerdersrol Apparaatupdate aan uzelf toe te wijzen. U kunt ook de stappen in de sectie Toegangsbeheerrollen configureren gebruiken om een combinatie van rollen te bieden aan gebruikers en toepassingen voor het juiste toegangsniveau. U moet machtigingen voor eigenaar of gebruikerstoegang hebben Beheer istrator in uw abonnement om rollen te beheren.
   • Exemplaarnaam: een naam voor uw exemplaar.
   • IoT Hub-naam: selecteer de IoT Hub die u wilt koppelen aan uw device update-exemplaar
   • Schakel het selectievakje in om de Service-principal van Azure Device Update in de IoT Hub toegang te verlenen tot de Device Update-service om de Device Update Service in te stellen en te gebruiken. U moet over de juiste machtigingen beschikken om toegang toe te voegen.

   Notitie

   Als u tijdens het maken van resources geen toegang kunt verlenen tot de service-principal van Azure Device Update, raadpleegt u het toegangsbeheer voor gebruikers en de service-principal van Azure Device Update configureren. Als deze toegang niet is ingesteld, kunt u geen implementatie-, apparaatbeheer- en diagnostische bewerkingen uitvoeren. Meer informatie over de toegang tot de service-principal van Azure Device Update.

   

4. Selecteer Volgende: Diagnostische gegevens. Als u diagnostische gegevens van Microsoft inschakelt, verleent Microsoft toestemming om diagnostische logboekbestanden van uw apparaten te verzamelen, op te slaan en te analyseren wanneer er een updatefout optreedt. Als u externe logboekverzameling wilt inschakelen voor diagnostische gegevens, moet u uw Device Update-exemplaar koppelen aan uw Azure Blob Storage-account. Als u het Azure Storage-account selecteert, worden de opslagdetails automatisch bijgewerkt.

   

5. Ga naar het tabblad Netwerken om door te gaan met het maken van een Device Update-account en -exemplaar. Kies de eindpunten die apparaten kunnen gebruiken om verbinding te maken met uw Device Update-exemplaar. Accepteer de standaardinstelling, Openbare toegang, voor dit voorbeeld.

   

6. Selecteer Volgende: controleren en maken. Selecteer Maken na validatie.

   

7. U ziet dat uw implementatie wordt uitgevoerd. De implementatiestatus wordt over enkele minuten gewijzigd in 'voltooid'. Wanneer dit het geval is, selecteert u Ga naar resource

Azure-CLI

Gebruik de opdracht az iot du account create om een nieuw Device Update-account te maken.

Vervang de volgende tijdelijke aanduidingen door uw eigen gegevens:

• <>resource_group: een bestaande resourcegroep in uw abonnement.

• <>account_name: een naam voor uw Device Update-account.

• <regio>: de Azure-regio waar uw account zich bevindt. Zie de pagina Azure Products-by-region voor informatie over welke regio's ondersteuning bieden voor Device Update voor IoT Hub. Als er geen regio is opgegeven, wordt de locatie van de resourcegroep gebruikt.

  Notitie

  Uw Device Update-account hoeft zich niet in dezelfde regio te bevinden als uw IoT-hubs, maar voor betere prestaties is het raadzaam om ze geografisch dichtbij te houden.

az iot du account create --resource-group <resource_group> --account <account_name> --location <region>

Gebruik de opdracht az iot du instance create om een Device Update-exemplaar te maken.

Een exemplaar van Device Update is gekoppeld aan één IoT-hub. Selecteer de IoT-hub die wordt gebruikt met Device Update. Wanneer u een IoT-hub koppelt aan een Device Update-exemplaar, wordt automatisch een nieuw beleid voor gedeelde toegang gemaakt, zodat Device Update machtigingen krijgt om te werken met IoT Hub (register schrijven en serviceverbinding). Dit beleid zorgt ervoor dat de toegang alleen beperkt is tot Device Update.

Vervang de volgende tijdelijke aanduidingen door uw eigen gegevens:

• <>account_name: de naam van het Device Update-account waaraan dit exemplaar wordt gekoppeld.
• <>instance_name: een naam voor dit exemplaar.
• <>iothub_id: de resource-id voor de IoT-hub die aan dit exemplaar wordt gekoppeld. U kunt uw IoT Hub-resource-id ophalen met behulp van de opdracht az iot hub show en query's uitvoeren op de id-waarde: az iot hub show -n <iothub_name> --query id.

az iot du instance create --account <account_name> --instance <instance_name> --iothub-ids <iothub_id>

Tip

Als onderdeel van het proces voor het maken van het exemplaar kunt u ook diagnostische logboekregistratie configureren. Zie Diagnostische logboeken van apparaten op afstand verzamelen voor meer informatie.

Volgende stappen

Zodra u uw Device Update-resources hebt gemaakt, configureert u het toegangsbeheer voor gebruikers en de Service-principal van Azure Device Update.

Of meer informatie over Device Update-accounts en -exemplaren of rollen voor apparaatupdate-toegangsbeheer.