Hitta och åtgärda enheter som saknas i Enhetsuppdatering för IoT Hub med hjälp av agentkontroll

Lär dig hur du använder funktionen agentkontroll för att hitta, diagnostisera och åtgärda enheter som saknas i din enhetsuppdatering för IoT Hub-instansen.

Förutsättningar

• Åtkomst till en IoT Hub med Enhetsuppdatering för IoT Hub aktiverat.
• En IoT-enhet (eller simulator) som etablerats för Enhetsuppdatering och rapporterar ett kompatibelt Plug and Play-modell-ID (PnP).

Kommentar

Funktionen för agentkontroll kan bara utföra valideringskontroller på enheter som har enhetsuppdateringsagenten installerad och rapporterar ett PnP-modell-ID som matchar dem som är kompatibla med Enhetsuppdatering för IoT Hub.

Azure-portalen

Webbläsare som stöds:

• Microsoft Edge
• Google Chrome

Azure CLI

En Azure CLI-miljö:

• Använd Bash-miljön i Azure Cloud Shell.

  

• Eller om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI

  1. Logga in på Azure CLI med kommandot az login .
  2. Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.
  3. När du uppmanas till det installerar du Azure CLI-tillägg vid första användningen. Kommandona i den här artikeln använder azure-iot-tillägget . Kör az extension update --name azure-iot för att se till att du använder den senaste versionen av tillägget.

Valideringskontroller som stöds av agentkontroll

Funktionen agentkontroll utför för närvarande följande verifieringskontroller på alla enheter som uppfyller ovanstående förutsättningar.

Valideringskontroll	Villkor
PnP-modell-ID	PnP-modell-ID:t är en sträng som rapporteras av enhetsuppdateringsagenten till enhetstvillingen som beskriver vilken PnP-modell som ska användas för enhet/molnkommunikation. Den här strängen måste vara en giltig DTMI-modellidentifierare (Digital Twin Model Identifier) som stöder gränssnittet För enhetsuppdatering.
Gränssnitts-ID	Gränssnitts-ID:t är en sträng som rapporteras av enhetsuppdateringsagenten till enhetstvillingen som beskriver vilken enhetsuppdateringsgränssnittsversion som ska användas för enhet/molnkommunikation. Den här strängen måste vara ett giltigt DTMI som stöder enhetsuppdateringsgränssnittet.
Namn på kompatibilitetsegenskap	CompatPropertyNames är ett fält som rapporteras av enhetsuppdateringsagenten till enhetstvillingen som beskriver vilka deviceProperties fält som ska användas för att fastställa enhetens kompatibilitet med en viss distribution. Det här fältets värde måste vara en sträng med kommaavgränsade namn. Strängen får innehålla minst ett och högst fem namn. Varje namn måste vara <32 tecken.
Egenskapsvärden för kompatibilitet	Egenskapsvärden för kompatibilitet är fält:värdepar som anges av compatPropertyNames fältet och rapporteras av enhetsuppdateringsagenten till enhetstvillingen som deviceProperties. Varje namn som definieras i egenskapsnamn för kompatibilitet måste ha ett motsvarande fält:värdepar rapporterat. Värdet för varje par är begränsat till 64 tecken.
ADU-grupp	Taggen ADU-grupp är en valfri tagg som definieras i enhetens enhetstvilling och som avgör vilken enhetsgrupp enheten tillhör. Om det anges är taggsträngen begränsad till 255 tecken och får endast innehålla alfanumeriska tecken och följande specialtecken: "." "-" "_" "~"

Om en enhet misslyckas med något av dessa kriterier kanske den inte visas korrekt i Enhetsuppdatering. Om du korrigerar det ogiltiga värdet så att det uppfyller de angivna kriterierna bör enheten visas korrekt i Enhetsuppdatering. Om enheten inte visas i Enhetsuppdatering eller i agentkontroll kan du behöva köra enhetssynkronisering för att lösa problemet.

Visa agentkontrollresultat

Azure-portalen

Resultatet av agentkontrollen finns på fliken Diagnostik i Enhetsuppdatering.

1. I Azure Portal, navigerar du till din IoT-hubb.
2. Välj Uppdateringar på navigeringsmenyn och välj sedan fliken Diagnostik.
3. Expandera avsnittet Hitta saknade enheter .

Azure CLI

Använd az iot du device health list för att visa hälsotillståndet för dina enheter.

Kommandot device health list tar följande argument:

• --account: Namnet på enhetsuppdateringskontot.
• --instance: Namnet på enhetsuppdateringsinstansen.
• --filter: Ett hälsofilter för enheten, antingen filtrering efter enhetstillstånd eller enhets-ID. Till exempel:
  • Om du vill visa en lista över alla felfria enheter filtrerar du efter state eq 'Healthy'
  • Om du vill visa en lista över alla enheter som inte är felfria filtrerar du efter state eq 'Unhealthy'
  • Om du vill visa hälsotillståndet för en målenhet filtrerar du efter deviceId eq '<device_name>' eller 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>"

Initiera en enhetssynkroniseringsåtgärd

Enhetssynkronisering ska utlösas om en enhet har registrerats i IoT Hub men inte visas i Enhetsuppdatering eller i agentkontrollresultat.

Endast en enhetssynkroniseringsåtgärd kan vara aktiv i taget för varje enhetsuppdateringsinstans.

Azure-portalen

1. I Azure Portal, navigerar du till din IoT-hubb.
2. Välj Uppdateringar på navigeringsmenyn och välj sedan fliken Diagnostik.
3. Expandera avsnittet Visa enhetens hälsotillstånd.
4. Välj Starta en enhetssynkronisering.

Azure CLI

Använd az iot du device import för att importera enheter och moduler till enhetsuppdateringsinstansen från en länkad IoT-hubb.

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

Nästa steg

Mer information om diagnostikfunktionerna för enhetsuppdatering finns i Översikt över diagnostikfunktioner för enhetsuppdatering