Vind en repareer apparaten die ontbreken in Apparaatupdate voor IoT Hub met behulp van agent check

Leer hoe je de agent check-functie kunt gebruiken om apparaten die ontbreken in je Device Update for IoT Hub-instantie te vinden, te diagnosticeren en te repareren.

Prerequisites

Toegang tot een IoT Hub met Device Update voor IoT Hub ingeschakeld.
Een IoT-apparaat (of simulator) dat is voorzien van apparaatupdates en een compatibele Plug en Play (PnP) model-ID rapporteert.

Opmerking

De agent check-functie kan alleen validatiecontroles uitvoeren op apparaten die de Device Update agent hebben geïnstalleerd en een PnP-model-ID rapporteren die overeenkomt met die compatibel met Device Update for IoT Hub.

Azure-portal
Azure CLI

Ondersteunde browsers:

Microsoft Edge
Google Chrome

Een Azure CLI-omgeving:

Gebruik de Bash-omgeving in Azure Cloud Shell.
Of, als je liever lokaal CLI-referentiecommando's uitvoert, installeer dan de Azure CLI
1. Meld u aan bij de Azure CLI met behulp van de opdracht az login .
2. Voer az version uit om de geïnstalleerde versie en de afhankelijke bibliotheken te vinden. Voer az upgrade uit om naar de nieuwste versie te upgraden.
3. Installeer bij het eerste gebruik de Azure CLI-extensie wanneer hierom wordt gevraagd. De commando's in dit artikel gebruiken de azure-iot-extensie . Voer az extension update --name azure-iot uit om zeker te zijn dat je de nieuwste versie van de extensie gebruikt.

Validatiecontroles ondersteund door agent check

De agent check-functie voert momenteel de volgende validatiecontroles uit op alle apparaten die aan bovenstaande vereisten voldoen.

Validatiecontrole	Criteria
PnP model-ID	De PnP-model-ID is een string die door de Device Update-agent wordt gerapporteerd aan de apparaattweeling en die beschrijft welk PnP-model gebruikt moet worden voor apparaat/cloud-communicatie. Deze string moet een geldige digitale tweelingmodelidentificatie (DTMI) zijn die de Device Update-interface ondersteunt.
Interface-ID	De interface-ID is een string die door de Device Update-agent wordt gerapporteerd aan de apparaattweeling en die beschrijft welke Device Update-interfaceversie gebruikt moet worden voor apparaat/cloudcommunicatie. Deze string moet een geldige DTMI zijn die de Device Update-interface ondersteunt.
namen van compatibiliteitseigenschappen	`CompatPropertyNames` is een veld dat de Device Update-agent rapporteert aan de apparaattwin. Het beschrijft welke `deviceProperties` velden gebruikt moeten worden om de compatibiliteit van het apparaat met een bepaalde implementatie te bepalen. De waarde van dit veld moet een reeks door komma's gescheiden namen zijn. De string mag minstens één en niet meer dan vijf namen bevatten. Elke naam moet minder dan 32 tekens zijn.
Compatibiliteitseigenschappen	Compatibiliteitseigenschappen zijn de veld:waarde-paren die door het `compatPropertyNames` veld worden gespecificeerd en door de Device Update-agent aan de apparaattweeling worden gerapporteerd als `deviceProperties`. Voor elke naam die is gedefinieerd in de namen van compatibiliteitseigenschappen, moet een overeenkomstig veld-waarde-paar worden gerapporteerd. De waarde voor elk paar is beperkt tot 64 tekens.
ADU-groep	De ADU Group-tag is een optionele tag die je definieert in de device twin van het apparaat. Het bepaalt tot welke apparaatgroep het apparaat behoort. Indien gespecificeerd, is de tagstring beperkt tot 255 tekens en kan alleen alfanumerieke tekens en de volgende speciale tekens bevatten: "." "-" "_" "~"

Als een apparaat aan een van deze criteria faalt, kan het niet correct verschijnen in Device Update. Het corrigeren van de ongeldige waarde om aan de gespecificeerde criteria te voldoen, zou ervoor moeten zorgen dat het apparaat correct verschijnt in Device Update. Als het apparaat niet verschijnt in Device Update of in de agentcontrole, moet je mogelijk device sync uitvoeren om het probleem op te lossen.

De resultaten van de agentcontrole zijn te vinden in het diagnostiektabblad van Device Update.

Navigeer in Azure Portal naar uw IoT-hub.
Selecteer Updates in het navigatiemenu en selecteer vervolgens het tabblad Diagnostiek .
Vouw de sectie 'Zoek ontbrekende apparaten ' uit.

Gebruik az iot du device health list om de gezondheid van je apparaten te bekijken.

De device health list opdracht heeft de volgende argumenten:

--account: De naam van het Device Update-account.
--instance: De naam van de Device Update-instantie.
--filter: Een apparaatgezondheidsfilter, dat ofwel filtert op apparaatstatus of apparaat-ID. Bijvoorbeeld:
- Om alle gezonde apparaten te vermelden, filter op state eq 'Healthy'
- Om alle ongezonde apparaten op te sommen, filter op state eq 'Unhealthy'
- Om de gezondheidstoestand van een doelapparaat te tonen, filter je op deviceId eq '<device_name>' of deviceId eq '<device_name>' and moduleId eq '<module_name>'

az iot du device health list --account <Device Update account name> --instance <Device Update instance name> --filter "<filter query>"

Start een apparaatsynchronisatieoperatie

Apparaatsynchronisatie zou geactiveerd moeten worden als een apparaat geregistreerd is in de IoT-hub maar niet verschijnt in Device Update of in agentcontroleresultaten.

Er kan slechts één apparaat-synchronisatieoperatie tegelijk actief zijn voor elke Device Update-instantie.

Azure-portal
Azure CLI

Navigeer in Azure Portal naar uw IoT-hub.
Selecteer Updates in het navigatiemenu en selecteer vervolgens het tabblad Diagnostiek .
Vouw de sectie 'Bekijk apparaatgezondheid' uit.
Selecteer Start een apparaat-synchronisatie.

Gebruik az iot du device import om apparaten en modules te importeren naar de Device Update-instantie vanaf een gekoppelde IoT-hub.

az iot du device import --account <Device Update account name> --instance <Device Update instance name>

Volgende stappen

Voor meer informatie over de diagnostische mogelijkheden van Device Update, zie Overzicht van de diagnostische functies van Apparaat-updates

Feedback

Is deze pagina nuttig?

Laatst bijgewerkt om 2026-09-17