Znajdź i napraw urządzenia brakujące w Device Update dla IoT Hub za pomocą agent check

Dowiedz się, jak korzystać z funkcji sprawdzania agentów, aby znaleźć, zdiagnozować i naprawić urządzenia brakujące w Twojej instancji Device Update dla IoT Hub.

Wymagania wstępne

Note

Funkcja sprawdzania agentów może sprawdzać walidację tylko na urządzeniach, które mają zainstalowanego agenta Device Update i raportują identyfikator modelu PnP zgodny z tymi kompatybilnymi z Device Update dla IoT Hub.

Obsługiwane przeglądarki:

Weryfikacje weryfikacji wspierane przez kontrolę agentową

Funkcja sprawdzania agentów obecnie wykonuje następujące kontrole walidacyjne na wszystkich urządzeniach spełniających powyższe wymagania.

Sprawdzanie poprawności Criteria
ID modelu PnP ID modelu PnP to ciąg znaków przekazywany przez agenta Device Update do bliźniaka urządzenia, który opisuje, jaki model PnP powinien być używany do komunikacji urządzenia z chmurą. Ten ciąg musi być ważnym identyfikatorem modelu cyfrowego bliźniaka (DTMI), który obsługuje interfejs Device Update.
Identyfikator interfejsu ID interfejsu to ciąg znaków przekazywany przez agenta Device Update do bliźniaka urządzenia, który opisuje, jaką wersję interfejsu Device Update należy używać do komunikacji urządzenia z chmurą. Ten ciąg musi być poprawnym DTMI obsługującym interfejs Device Update.
Nazwy właściwości zgodności CompatPropertyNames to pole, które agent Device Update raportuje bliźniakowi urządzenia. Opisuje, jakich deviceProperties pól użyć do określenia kompatybilności urządzenia z danym wdrożeniem. Wartość tego pola musi być ciągiem nazw oddzielonych przecinkami. Ciąg musi zawierać co najmniej jedną nazwę i nie więcej niż pięć nazw. Każde imię musi mieć mniej niż 32 znaki.
Wartości właściwości zgodności Wartości właściwości zgodności to pary pola:wartość określone przez compatPropertyNames pole i raportowane przez agenta Device Update do bliźniaczego urządzenia jako deviceProperties. Każda nazwa zdefiniowana na liście nazw właściwości zgodności musi mieć odpowiadającą jej zaraportowaną parę pole–wartość. Wartość każdej pary jest ograniczona do 64 znaków.
Grupa ADU Tag „ADU Group” jest opcjonalnym tagiem definiowanym w bliźniaku urządzenia. To on decyduje, do jakiej grupy urządzeń należy dane urządzenie. Jeśli jest to wskazane, ciąg tagów jest ograniczony do 255 znaków i może zawierać jedynie znaki alfanumeryczne oraz następujące znaki specjalne: "." "-" "_" "~"

Jeśli urządzenie nie spełni któregoś z tych kryteriów, może nie pojawić się poprawnie w Aktualizacji urządzenia. Skorygowanie nieprawidłowej wartości tak, aby spełniała określone kryteria, powinno spowodować, że urządzenie będzie prawidłowo wyświetlane w Device Update. Jeśli urządzenie nie pojawia się w Device Update ani podczas sprawdzania agenta, może być konieczne uruchomienie synchronizacji urządzenia, aby rozwiązać ten problem.

Zobacz wyniki kontroli agentów

Wyniki kontroli agenta można znaleźć na karcie Diagnostyka w sekcji Aktualizacja urządzenia.

  1. W portalu Azure przejdź do swojego centrum IoT.
  2. Wybierz Aktualizacje z menu nawigacyjnego, a następnie zakładkę Diagnostyka .
  3. Rozwiń sekcję Znajdź zaginione urządzenia .

Rozpocznij operację synchronizacji urządzeń

Synchronizacja urządzeń powinna być wywołana, jeśli urządzenie zostało zarejestrowane w hubie IoT, ale nie pojawia się w Device Update ani w wynikach kontroli agentów.

Dla każdej instancji Device Update może być aktywna tylko jedna operacja synchronizacji urządzeń.

  1. W portalu Azure przejdź do swojego centrum IoT.
  2. Wybierz Aktualizacje z menu nawigacyjnego, a następnie zakładkę Diagnostyka .
  3. Rozwiń sekcję Wyświetl stan urządzenia.
  4. Wybierz Start synchronizacji urządzeń.

Następne kroki

Aby dowiedzieć się więcej o możliwościach diagnostycznych Device Update, zobacz przegląd funkcji diagnostycznych Device Update

  • Last updated on