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 enhetsuppdateringen för IoT Hub instans.

Krav

Anteckning

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

Webbläsare som stöds:

Verifieringskontroller som stöds av agentkontroll

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

Valideringskontroll Kriterie
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 version av enhetsuppdateringsgränssnittet som ska användas för enhet/molnkommunikation. Den här strängen måste vara en giltig 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 kompatibilitetsegenskapsnamn 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 avgör vilken enhetsgrupp enheten tillhör. Om det anges är taggsträngen begränsad till 255 tecken och får bara 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

Resultatet av agentkontrollen finns på fliken Diagnostik i Enhetsuppdatering.

  1. I Azure-Portal navigerar du till din IoT-hubb.
  2. Välj Uppdateringarnavigeringsmenyn och välj sedan fliken Diagnostik.
  3. Expandera avsnittet Hitta enheter som saknas .

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.

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

Nästa steg

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