Apparaten bulksgewijs in uw Azure IoT Central beheren
U kunt de Azure IoT Central om uw verbonden apparaten op schaal te beheren via taken. Met taken kunt u bulksgewijs updates uitvoeren voor apparaat- en cloudeigenschappen en opdrachten uitvoeren. U kunt CSV-bestanden ook gebruiken om apparaten bulksgewijs te importeren en te exporteren. In dit artikel wordt beschreven hoe u aan de slag gaat met het gebruik van taken in uw eigen toepassing en hoe u de import- en exportfuncties gebruikt.
Een taak maken en uitvoeren
In het volgende voorbeeld ziet u hoe u een taak kunt maken en uitvoeren om de lichte drempelwaarde voor een groep logistieke gatewayapparaten in te stellen. U gebruikt de taakwizard om taken te maken en uit te voeren. U kunt een taak opslaan om later uit te voeren.
Selecteer taken in het linkerdeelvenster.
Selecteer + Nieuwe taak.
Voer op de pagina Uw taak configureren een naam en beschrijving in om de taak te identificeren die u maakt.
Als uw toepassing gebruikmaakt van organisaties,selecteert u de organisatie waar u de taak aan wilt koppelen. Alleen gebruikers in de organisatie kunnen de taak bekijken of wijzigen. De rol van de gebruiker bepaalt de machtigingen die de gebruiker heeft.
Selecteer de doelapparaatgroep op wie u de taak wilt toepassen. Als uw toepassing gebruikmaakt van organisaties, bepaalt de geselecteerde organisatie de beschikbare apparaatgroepen. Onder de selectie Apparaatgroep kunt u zien op hoeveel apparaten uw taakconfiguratie van toepassing is.
Kies Cloud-eigenschap, Eigenschap of Opdracht als het taaktype:
Als u een eigenschaps taak wilt configureren, selecteert u een eigenschap en stelt u de nieuwe waarde in. Als u een opdrachtopdracht wilt configureren, kiest u de opdracht die u wilt uitvoeren. Een eigenschaps taak kan meerdere eigenschappen instellen.
Selecteer Opslaan en afsluiten om de taak toe te voegen aan de lijst met opgeslagen taken op de pagina Taken. U kunt later terugkeren naar een taak vanuit de lijst met opgeslagen taken.
Selecteer Volgende om naar de pagina Bezorgingsopties te gaan. Op de pagina Bezorgingsopties kunt u de bezorgingsopties voor deze taak instellen: Batches en Annuleringsdrempel .
Met batches kunt u taken spreiden voor grote aantallen apparaten. De taak is onderverdeeld in meerdere batches en elke batch bevat een subset van de apparaten. De batches worden in de wachtrij geplaatst en opeenvolgend uitgevoerd.
Met de annuleringsdrempel kunt u een taak automatisch annuleren als het aantal fouten de limiet overschrijdt. De drempelwaarde kan van toepassing zijn op alle apparaten in de taak of op afzonderlijke batches.
Selecteer Volgende om naar de pagina Planning te gaan. Op de pagina Planning kunt u een planning inschakelen om de taak in de toekomst uit te voeren:
Kies een terugkeerpatroonoptie voor de planning. U kunt een taak instellen om uit te voeren:
- Eenmalig
- Dagelijks
- Wekelijks
Stel een begindatum en -tijd in voor een geplande taak. De datum en tijd zijn specifiek voor uw tijdzone en niet voor de lokale tijd van het apparaat.
Als u een terugkerend schema wilt beëindigen, kiest u:
- Op deze dag stelt u een einddatum voor de planning in.
- Nadat u het aantal keren hebt ingesteld dat de taak moet worden uitgevoerd.
Geplande taken worden altijd uitgevoerd op de apparaten in een apparaatgroep, zelfs als het lidmaatschap van de apparaatgroep na een periode verandert.
Selecteer Volgende om naar de pagina Controleren te gaan. Op de pagina Controleren worden de configuratiedetails van de taak weergegeven. Selecteer Planning om de taak te plannen:
De pagina met taakdetails bevat informatie over geplande taken. Wanneer de geplande taak wordt uitgevoerd, ziet u een lijst met de taak-exemplaren. De geplande taakuitvoering maakt ook deel uit van de lijst met taak van de afgelopen 30 dagen.
Op deze pagina kunt u de planning van de taak inplannen of de geplande taak bewerken. U kunt terugkeren naar een geplande taak vanuit de lijst met geplande taken.
In de taakwizard kunt u ervoor kiezen om een taak niet te plannen en deze onmiddellijk uit te voeren. In de volgende schermopname ziet u een taak zonder planning die direct kan worden uitgevoerd. Selecteer Uitvoeren om de taak uit te voeren:
Een taak doormaakt de fasen In behandeling, Wordt uitgevoerd en voltooid. De details van de taakuitvoering bevatten metrische resultaatgegevens, details van de duur en een raster met apparaatlijstgegevens.
Wanneer de taak is voltooid, kunt u Resultatenlogboek selecteren om een CSV-bestand met uw taakdetails te downloaden, inclusief de apparaten en hun statuswaarden. Deze informatie kan nuttig zijn voor het oplossen van problemen.
De taak wordt nu weergegeven in de lijst Afgelopen 30 dagen op de pagina Taken. Op deze pagina worden momenteel taken uitgevoerd en de geschiedenis van eerder uitgevoerde of opgeslagen taken weergegeven.
Notitie
U kunt 30 dagen aan geschiedenis weergeven voor uw eerder uitgevoerd taken.
Taken beheren
Als u een taak wilt stoppen, opent u deze en selecteert u Stoppen. De taakstatus wordt gewijzigd om aan te geven dat de taak is gestopt. In de sectie Samenvatting ziet u welke apparaten zijn voltooid, mislukt of nog in behandeling zijn.
Wanneer een taak de status Gestopt heeft, kunt u Doorgaan selecteren om de taak te hervatten. De taakstatus wordt gewijzigd om aan te geven dat de taak nu weer wordt uitgevoerd. De sectie Samenvatting blijft bijwerken met de meest recente voortgang.
Een taak kopiëren
Als u een bestaande taak wilt kopiëren, selecteert u een uitgevoerde taak. Selecteer Kopiëren op de pagina met taakresultaten of de pagina met taakdetails:
Er wordt een kopie van de taakconfiguratie geopend die u kunt bewerken en Kopiëren wordt toegevoegd aan de taaknaam.
Taakstatus weergeven
Nadat een taak is gemaakt, wordt de kolom Status bijgewerkt met het laatste bericht over de taakstatus. De volgende tabel bevat de mogelijke taakstatuswaarden:
| Statusbericht | Status betekent |
|---|---|
| Voltooid | Deze taak is op alle apparaten gedaan. |
| Mislukt | Deze taak is mislukt en is niet volledig uitgevoerd op apparaten. |
| In behandeling | Deze taak is nog niet gestart op apparaten. |
| Wordt uitgevoerd | Deze taak wordt momenteel uitgevoerd op apparaten. |
| Gestopt | Een gebruiker heeft deze taak handmatig gestopt. |
| Geannuleerd | Deze taak is geannuleerd omdat de drempelwaarde die is ingesteld op de pagina Bezorgingsopties is overschreden. |
Het statusbericht wordt gevolgd door een overzicht van de apparaten in de taak. De volgende tabel bevat de mogelijke apparaatstatuswaarden:
| Statusbericht | Status betekent |
|---|---|
| Geslaagd | Het aantal apparaten dat de taak heeft uitgevoerd. |
| Mislukt | Het aantal apparaten op welke de taak niet kan worden uitgevoerd. |
Als u de status van de taak en alle betrokken apparaten wilt weergeven, opent u de taak. Naast elke apparaatnaam ziet u een van de volgende statusberichten:
| Statusbericht | Status betekent |
|---|---|
| Voltooid | De taak is op dit apparaat gedaan. |
| Mislukt | De taak kan niet worden uitgevoerd op dit apparaat. In het foutbericht wordt meer informatie weergegeven. |
| In behandeling | De taak is nog niet uitgevoerd op dit apparaat. |
Als u een CSV-bestand wilt downloaden dat de taakdetails en de lijst met apparaten en hun statuswaarden bevat, selecteert u Resultatenlogboek.
De apparatenlijst filteren
U kunt de lijst met apparaten filteren op de pagina Taakdetails door het filterpictogram te selecteren. U kunt filteren op het veld Apparaat-id of Status:
Kolommen in de apparatenlijst aanpassen
U kunt kolommen toevoegen aan de lijst met apparaten door het pictogram kolomopties te selecteren:
Gebruik het dialoogvenster Kolomopties om de kolommen in de lijst met apparaten te kiezen. Selecteer de kolommen die u wilt weergeven, selecteer de pijl-rechts en selecteer vervolgens OK. Als u alle beschikbare kolommen wilt selecteren, kiest u Alles selecteren. De geselecteerde kolommen worden weergegeven in de apparatenlijst.
Geselecteerde kolommen blijven bestaan in een gebruikerssessie of tussen gebruikerssessies die toegang hebben tot de toepassing.
Taken opnieuw proberen
U kunt een taak met mislukte apparaten opnieuw uit te proberen. Selecteer Opnieuw proberen bij mislukt:
Voer een taaknaam en -beschrijving in en selecteer taak opnieuw uit te voeren. Er wordt een nieuwe taak verzonden om de actie opnieuw uit te voeren op mislukte apparaten.
Notitie
U kunt niet meer dan vijf taken tegelijk uitvoeren vanuit een Azure IoT Central toepassing.
Wanneer een taak is voltooid en u een apparaat verwijdert dat in de apparaatlijst van de taak staat, wordt de apparaatinvoer weergegeven als verwijderd in de apparaatnaam. De koppeling met details is niet beschikbaar voor het verwijderde apparaat.
Apparaten importeren
Als u een groot aantal apparaten wilt verbinden met uw toepassing, kunt u apparaten bulksgewijs importeren uit een CSV-bestand. U vindt een voorbeeld van een CSV-bestand in de opslagplaats met Azure-voorbeelden. Het CSV-bestand moet de volgende kolomkoppen bevatten:
| Kolom | Beschrijving |
|---|---|
| IOTC_DEVICEID | De apparaat-id is een unieke id die door dit apparaat wordt gebruikt om verbinding te maken. De apparaat-id kan letters, cijfers en het - teken bevatten zonder spaties. De maximale lengte is 128 tekens. |
| IOTC_DEVICENAME | Optioneel. De apparaatnaam is een gebruiksvriendelijke naam die in de hele toepassing wordt weergegeven. Als dit niet is opgegeven, hetzelfde als de apparaat-id. De maximale lengte is 148 tekens. |
Apparaten bulksgewijs registreren in uw toepassing:
Kies Apparaten in het linkerdeelvenster.
Kies in het linkerdeelvenster de apparaatsjabloon waarvoor u de apparaten bulksgewijs wilt maken.
Notitie
Als u nog geen apparaatsjabloon hebt, kunt u apparaten importeren onder Alle apparaten en deze zonder sjabloon registreren. Nadat apparaten zijn geïmporteerd, kunt u ze migreren naar een sjabloon.
Selecteer Importeren.
Selecteer een organisatie waar u de apparaten aan wilt toewijzen. Alle apparaten die u importeert, worden toegewezen aan dezelfde organisatie. Als u apparaten wilt toewijzen aan verschillende organisaties, maakt u meerdere importbestanden, één voor elke organisatie. U kunt ze ook allemaal uploaden naar de hoofdorganisatie en ze vervolgens opnieuw toewijzen aan de juiste organisaties in de gebruikersinterface.
Selecteer het CSV-bestand met de lijst met apparaat-ID's die moeten worden geïmporteerd.
Het importeren van het apparaat wordt gestart zodra het bestand is geüpload. U kunt de importstatus volgen in het deelvenster Apparaatbewerkingen. Dit deelvenster wordt automatisch weergegeven nadat het importeren is gestart of u kunt het openen via het belpictogram in de rechterbovenhoek.
Zodra het importeren is voltooid, wordt een bericht weergegeven in het deelvenster Apparaatbewerkingen.
Als de importbewerking van het apparaat mislukt, wordt er een foutbericht weergegeven in het deelvenster Apparaatbewerkingen. Er wordt een logboekbestand gegenereerd met alle fouten dat u kunt downloaden.
Apparaten exporteren
Als u een echt apparaat wilt verbinden met IoT Central, hebt u de connection string. U kunt apparaatgegevens bulksgewijs exporteren om de informatie op te halen die u nodig hebt om apparaatverbindingsreeksen te maken. Tijdens het exportproces wordt een CSV-bestand gemaakt met de apparaat-id, apparaatnaam en sleutels voor alle geselecteerde apparaten.
Apparaten bulksgewijs exporteren vanuit uw toepassing:
Kies Apparaten in het linkerdeelvenster.
Kies in het linkerdeelvenster de apparaatsjabloon van waaruit u de apparaten wilt exporteren.
Selecteer de apparaten die u wilt exporteren en selecteer vervolgens de actie Exporteren.
Het exportproces wordt gestart. U kunt de status volgen met behulp van het deelvenster Apparaatbewerkingen.
Wanneer de export is voltooid, wordt er een bericht weergegeven met een koppeling om het gegenereerde bestand te downloaden.
Selecteer de koppeling Bestand downloaden om het bestand te downloaden naar een lokale map op de schijf.
Het geëxporteerde CSV-bestand bevat de volgende kolommen: apparaat-id, apparaatnaam, apparaatsleutels en X509-certificaatvingerafdrukken:
- IOTC_DEVICEID
- IOTC_DEVICENAME
- IOTC_SASKEY_PRIMARY
- IOTC_SASKEY_SECONDARY
- IOTC_X509THUMBPRINT_PRIMARY
- IOTC_X509THUMBPRINT_SECONDARY
Zie Apparaatconnectiviteit in Azure IoT Central voor meer informatie over het verbinden van echte IoT Central met uw Azure IoT Central.
Volgende stappen
Nu u hebt geleerd hoe u apparaten bulksgewijs kunt beheren in uw Azure IoT Central-toepassing, is een voorgestelde volgende stap het bewerken van een apparaatsjabloon.