Hitta och åtgärda enheter som saknas från Device Update för IoT Hub med hjälp av agent check

Lär dig hur du använder agentkontrollfunktionen för att hitta, diagnostisera och åtgärda enheter som saknas i din Device Update for IoT Hub-instans.

Förutsättningar

Note

Agentkontrollfunktionen kan endast utföra valideringskontroller på enheter som har Device Update-agenten installerad och rapporterar ett PnP-modell-ID som matchar de som är kompatibla med Device Update for IoT Hub.

Webbläsare som stöds:

Valideringskontroller stöds av agentkontroll

Agentkontrollfunktionen utför för närvarande följande valideringskontroller på alla enheter som uppfyller ovanstående förutsättningar.

Kontroll av validering Criteria
PnP modell-ID PnP-modell-ID är en sträng som rapporteras av Device Update-agenten till enhetstvillingen och som beskriver vilken PnP-modell som ska användas för kommunikation mellan enhet och moln. Denna sträng måste vara en giltig digital tvillingmodellidentifierare (DTMI) som stöder Device Update-gränssnittet.
Gränssnitts-ID Gränssnitts-ID:t är en sträng som rapporteras av Device Update-agenten till enhetstvillingen och som beskriver vilken Device Update-gränssnittsversion som ska användas för kommunikation mellan enhet och moln. Denna sträng måste vara en giltig DTMI som stödjer Device Update-gränssnittet.
Kompatibilitetsegenskapsnamn CompatPropertyNames är ett fält som Device Update-agenten rapporterar till enhetstvillingen. Den beskriver vilka deviceProperties fält som ska användas för att avgöra enhetens kompatibilitet med en given installation. Detta fälts värde måste vara en sträng av kommaavgränsade namn. Strängen måste innehålla minst ett och högst fem namn. Varje namn måste vara färre än 32 tecken.
Kompatibilitetsegenskapsvärden Kompatibilitetsegenskapsvärden är fält:värde-paren som specificeras av compatPropertyNames fältet och rapporteras av Device Update-agenten till enhetstvillingen som deviceProperties. Varje namn som definieras i namnen på kompatibilitetsegenskaper måste ha ett motsvarande par av typen fält:värde angivet. Värdet för varje par är begränsat till 64 tecken.
ADU-gruppen ADU Group-taggen är en valfri tagg som du definierar i enhetens enhetstvilling. Den avgör vilken enhetsgrupp enheten tillhör. Om det anges är taggsträngen begränsad till 255 tecken och kan endast innehålla alfanumeriska tecken och följande specialtecken: "." "-" "_" "~"

Om en enhet misslyckas med något av dessa kriterier kan den inte visas korrekt i Enhetsuppdatering. Att korrigera det ogiltiga värdet för att uppfylla de specificerade kriterierna bör göra att enheten korrekt visas i Device Update. Om enheten inte visas i Device Update eller i agentkontrollen kan du behöva köra enhetssynkronisering för att lösa problemet.

Visa resultat för agentkontroller

Resultaten från agentkontrollen finns i diagnostikfliken i Device Update.

  1. Gå till din IoT-hubb i Azure-portalen.
  2. Välj Uppdateringar i navigationsmenyn och välj sedan fliken Diagnostik .
  3. Utöka avsnittet Hitta saknade enheter .

Initiera en enhetssynkroniseringsoperation

Enhetssynkronisering bör triggas om en enhet har registrerats i IoT-hubben men inte visas i Device Update eller i agentkontrollresultat.

Endast en enhetssynkroniseringsoperation kan vara aktiv åt gången för varje enhetsuppdateringsinstans.

  1. Gå till din IoT-hubb i Azure-portalen.
  2. Välj Uppdateringar i navigationsmenyn och välj sedan fliken Diagnostik .
  3. Utöka avsnittet Visa enhetens hälsa.
  4. Välj Starta en enhetssynkronisering.

Nästa steg

För att lära dig mer om Device Updates diagnostikfunktioner, se Översikten över diagnostiska funktioner för enhetsuppdateringar

  • Uppdaterades senast