Tworzenie grup urządzeń w usłudze Device Update dla usługi IoT Hub

Usługa Device Update dla usługi IoT Hub umożliwia wdrożenie aktualizacji w grupie urządzeń IoT.

Uwaga

Jeśli chcesz wdrożyć w grupie domyślnej zamiast grupy utworzonej przez użytkownika, możesz przejść bezpośrednio do Jak wdrożyć aktualizację

Wymagania wstępne

dostęp do usługi IoT Hub z włączoną aktualizacją urządzenia dla usługi IoT Hub. Zaleca się użycie warstwy S1 (Standardowa) lub nowszej dla usługi IoT Hub.
Urządzenie IoT (lub symulator) przygotowane do aktualizacji urządzenia w usłudze IoT Hub.
Pomyślnie zaimportowano co najmniej jedną aktualizację dla aprowizowanego urządzenia.
Zainstaluj i uruchom agenta aktualizacji urządzenia na swoim urządzeniu IoT jako moduł lub identyfikator na poziomie urządzenia

Dodawanie tagu do urządzeń

Usługa Device Update dla usługi IoT Hub umożliwia wdrożenie aktualizacji w grupie urządzeń IoT. Aby utworzyć grupę, pierwszym krokiem jest dodanie tagu do docelowego zestawu urządzeń w usłudze IoT Hub. Tagi można pomyślnie dodać tylko do urządzenia po nawiązaniu połączenia z usługą Device Update.

W poniższej dokumentacji opisano sposób dodawania i aktualizowania tagu.

Programowe aktualizowanie bliźniaków urządzeń

Można zaktualizować bliźniaka urządzenia za pomocą odpowiedniego tagu przy użyciu narzędzia RegistryManager po zapisaniu urządzenia do usługi Device Update.

Format tagu aktualizacji urządzenia

     "tags": {
              "ADUGroup": "<CustomTagValue>"
             }

Korzystanie z zadań

Istnieje możliwość zaplanowania zadania na wielu urządzeniach w celu dodania lub zaktualizowania tagu aktualizacji urządzenia. Aby zapoznać się z przykładami, zobacz Schedule jobs on multiple devices (Planowanie zadań na wielu urządzeniach). Możesz zaktualizować bliźniaka urządzenia lub bliźniaka modułu (jeśli agent usługi Device Update jest skonfigurowany jako moduł tożsamości) przy użyciu zadań. Aby uzyskać więcej informacji, zobacz Harmonogramowanie i wykonywanie zadań.

Uwaga

Ta akcja zalicza się do limitu komunikatów IoT Hub. Zaleca się jednorazowo zmieniać tylko do 50 000 tagów bliźniaczych urządzeń lub modułów, w przeciwnym razie może być konieczne zakupienie dodatkowych jednostek IoT Hub, jeśli przekroczysz dzienny limit komunikatów. Szczegółowe informacje można znaleźć w Limity przydziału i ograniczanie przepustowości.

Bezpośrednie aktualizacje bliźniacze

Tagi można również dodać lub zaktualizować bezpośrednio w bliźniaczym urządzeniu lub bliźniaczym module.

Zaloguj się do witryny Azure Portal i przejdź do usługi IoT Hub.
Wybierz pozycję Urządzenia z menu nawigacji i wybierz urządzenie IoT, aby otworzyć jego szczegóły.
Otwórz szczegóły bliźniacze.
- Jeśli agent usługi Device Update jest skonfigurowany jako tożsamość urządzenia, wybierz pozycję Bliźniak urządzenia.
- Jeśli agent usługi Device Update jest skonfigurowany jako tożsamość modułu, wybierz moduł Device Update, a następnie bliźniak tożsamości modułu.
W bliźniaczej reprezentacji urządzenia lub bliźniaczej reprezentacji modułu usuń wszystkie istniejące wartości tagu Device Update, ustawiając je na null.
Dodaj nową wartość tagu Device Update, jak pokazano poniżej. Przykładowy dokument JSON bliźniaczej reprezentacji urządzenia z tagami.

    "tags": {
            "ADUGroup": "<CustomTagValue>"
            }

Ograniczenia

Możesz dodać dowolną wartość do tagu z wyjątkiem wartości "Uncategorized", która jest wartością zarezerwowaną.
Wartość tagu nie może przekraczać 255 znaków.
Wartość tagu może zawierać znaki alfanumeryczne i następujące znaki specjalne ".","-","_","~".
Nazwy tagów i grup są rozróżniane ze względu na wielkość liter.
Urządzenie może mieć tylko jeden tag o nazwie ADUGroup. Wszelkie kolejne dodatki tagu o tej nazwie zastąpią istniejącą wartość nazwy tagu ADUGroup.
Jedno urządzenie może należeć tylko do jednej grupy.

Tworzenie grupy urządzeń przez wybranie istniejącego tagu usługi IoT Hub

Przejdź do portalu Azure.
Wybierz usługę IoT Hub, z którą wcześniej połączyłeś się z wystąpieniem usługi Device Update.
Wybierz opcję Aktualizacje w obszarze Zarządzanie urządzeniami na pasku nawigacyjnym po lewej stronie.
Wybierz zakładkę Grupy i wdrożenia w górnej części strony.
Wybierz Dodaj grupę, aby utworzyć nową grupę.
Wybierz tag usługi IoT Hub i klasę urządzenia z listy, a następnie wybierz pozycję Utwórz grupę.
Po utworzeniu grupy zobaczysz, że wykres zgodności aktualizacji i lista grup zostały zaktualizowane. Wykres zgodności aktualizacji pokazuje liczbę urządzeń w różnych stanach zgodności: mają najnowszą aktualizację, dostępne są nowe aktualizacje, oraz aktualizacje w toku. Dowiedz się więcej o zgodności aktualizacji.
Twoja nowo utworzona grupa powinna być widoczna, podobnie jak wszystkie dostępne aktualizacje dla urządzeń w tej grupie. Jeśli istnieją urządzenia, które nie spełniają wymagań klasy urządzeń grupy, zostaną one wyświetlone w odpowiedniej nieprawidłowej grupie. Najlepszą dostępną aktualizację można wdrożyć w nowej grupie zdefiniowanej przez użytkownika z tego widoku, klikając przycisk "Wdróż" obok grupy. Zobacz Następny krok: Wdrażanie aktualizacji, aby uzyskać więcej informacji.

Wyświetlanie szczegółów urządzenia dla utworzonej grupy

Przejdź do nowo utworzonej grupy i kliknij nazwę grupy.
Lista urządzeń, które są częścią grupy, zostanie wyświetlona wraz z ich właściwościami aktualizacji urządzenia. W tym widoku można również wyświetlić informacje o zgodności aktualizacji dla wszystkich urządzeń, które są członkami grupy. Wykres zgodności aktualizacji przedstawia liczbę urządzeń w różnych stanach zgodności: Na najnowszej aktualizacji, Dostępne nowe aktualizacje i Aktualizacje w toku.
Możesz również kliknąć poszczególne urządzenia w grupie, aby przekierować je do strony szczegółów urządzenia w usłudze IoT Hub.