Zarządzanie grupami urządzeń dla usługi Azure Device Update dla usługi IoT Hub

Usługa Azure Device Update dla usługi IoT Hub umożliwia wdrażanie aktualizacji w grupach urządzeń IoT zdefiniowanych przez użytkownika. Każde urządzenie zarządzane w usłudze Device Update jest członkiem grupy urządzeń, ale definiowanie grup urządzeń jest opcjonalne. Alternatywnie można wdrożyć w domyślnej grupie urządzeń, którą udostępnia usługa Device Update.

W przypadku tworzenia i przypisywania wartości tagów aktualizacji urządzenia zdefiniowanych przez użytkownika do urządzeń usługa Device Update automatycznie tworzy grupy na podstawie przypisanych tagów i właściwości zgodności urządzeń. Dla każdej grupy urządzeń usługa Device Update może utworzyć wiele podgrup, które mają różne klasy urządzeń. Usługa Device Update umieszcza urządzenia, które nie mają tagów w default grupie urządzeń.

W tym artykule opisano, jak używać portalu Azure lub interfejsu wiersza polecenia platformy Azure (Azure CLI) do tworzenia tagów i grup urządzeń Device Update zdefiniowanych przez użytkownika oraz zarządzania nimi. Aby wdrożyć aktualizacje w grupach urządzeń zdefiniowanych przez użytkownika lub domyślnych, zobacz Wdrażanie aktualizacji urządzenia.

Wymagania wstępne

Zanim zaczniesz, zwróć uwagę na następujące wymagania wstępne:

• Urządzenia muszą zostać pomyślnie włączone do Device Update przed przydziałem grup.
• Urządzenia muszą zgłaszać wspierany identyfikator modelu Plug and Play. Listę obsługiwanych identyfikatorów modeli można znaleźć w dokumencie Device Update models.
• W scenariuszach IoT Edge agent Device Update działa jako moduł i musi zgłaszać identyfikator modelu za pośrednictwem odpowiedniej tożsamości.

Dodawanie tagów do urządzeń

Aby przypisać grupę urządzeń Device Update, dodaj ADUGroup tag do docelowego zestawu urządzeń podłączonych do Device Update w IoT Hub. Dodaj tag do bliźniaka urządzenia, jeśli agent usługi Device Update został aprowizowany z użyciem tożsamości urządzenia, lub do odpowiedniego bliźniaka modułu, jeśli agent usługi Device Update został aprowizowany z użyciem tożsamości modułu.

Tag Device Update ADUGroup używa formatu klucz-wartość, jak pokazano w poniższym przykładzie bliźniaczej reprezentacji urządzenia lub modułu:

"etag": "",
"deviceId": "",
"deviceEtag": "",
"version": <version>,
"tags": {
   "ADUGroup": "<CustomTagValue>"
}

Aby uzyskać więcej informacji i przykłady składni bliźniaczej reprezentacji JSON, zobacz Opis bliźniaczych reprezentacji urządzeń i korzystanie z nich lub Opis bliźniaczych reprezentacji modułów i korzystanie z nich.

Tag ADUGroup ma następujące właściwości i ograniczenia:

• Urządzenie może mieć tylko jeden ADUGroup tag i należeć do tylko jednej grupy aktualizacji urządzeń jednocześnie. Dodanie innego tagu o nazwie ADUGroup zastępuje istniejącą ADUGroup wartość.
• Można użyć dowolnej wartości dla tagu z wyjątkiem wartości Uncategorized zarezerwowanych i $default.
• Wartość tagu nie może przekraczać 200 znaków.
• Wartość tagu może zawierać znaki alfanumeryczne i następujące znaki specjalne: . - _ ~.
• W nazwie tagu ADUGroup i wartościach nazwy grupy jest uwzględniana wielkość liter.

W poniższych sekcjach opisano kilka sposobów dodawania i aktualizowania tagu.

Dodawanie tagów przy użyciu zestawów SDK

Po zarejestrowaniu urządzenia w usłudze Device Update możesz zaktualizować bliźniaka urządzenia lub modułu, używając odpowiedniego tagu za pomocą narzędzia RegistryManager. Aby uzyskać więcej informacji, zobacz następujące artykuły:

• Wprowadzenie do bliźniaczych reprezentacji urządzeń przy użyciu platformy .NET
• Opis tagów i formatu właściwości

Dodawanie tagów przy użyciu zadań

Można zaplanować zadania w celu dodania lub zaktualizowania tagów usługi Device Update dla wielu urządzeń. Aby zapoznać się z przykładami operacji zadań, zobacz Planowanie zadań na wielu urządzeniach. Za pomocą zadań można aktualizować bliźniaki urządzenia lub bliźniaki modułu, w zależności od tego, czy agent usługi Device Update został aprowizowany z użyciem tożsamości urządzenia albo modułu. Aby uzyskać więcej informacji, zobacz Planowanie i uruchamianie zadań.

Dodawanie tagów przez aktualizację cyfrowych bliźniaków

Możesz również dodać lub zaktualizować znacznik ADUGroup bezpośrednio w bliźniaku urządzenia lub modułu.

az iot hub module-twin update \
    --hub-name <IoT hub name> \
    --device-id <device name> \
    --module-id <module name> \
    --tags '{"ADUGroup": "<custom_tag_value"}'

Wyświetlanie grup urządzeń

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>

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

az iot du device group show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <value of the ADUGroup tag for this group>
    --best-updates
    --update-compliance

Usuwanie urządzenia z grupy urządzeń

Aby usunąć urządzenie z grupy urządzeń, zmień wartość tagu ADUGroup na null w reprezentacji bliźniaczej i wybierz pozycję Zapisz.

    "tags": {
            "ADUGroup": "null"
            }

Ta akcja powoduje usunięcie tagu grupy z bliźniaczej reprezentacji urządzenia i usunięcie urządzenia z grupy urządzeń.

Usuwanie grupy urządzeń

Usługa Device Update automatycznie tworzy grupy urządzeń i zachowuje grupy urządzeń, klasy urządzeń i wdrożenia dla rekordów historycznych lub innych potrzeb użytkowników, a nie automatycznie je czyści. Grupy urządzeń można usuwać za pośrednictwem portalu Azure, wybierając i usuwając je pojedynczo, albo wywołując dla danej grupy polecenie interfejsu wiersza polecenia platformy Azure az iot du device group delete.

Aby można je było usunąć, grupa musi spełniać następujące wymagania:

• Nie może być grupą default .
• Nie może mieć żadnych urządzeń członkowskich. Oznacza to, że żadne urządzenie skonfigurowane w wystąpieniu usługi Device Update nie może mieć tagu ADUGroup o wartości odpowiadającej nazwie grupy.
• Nie może mieć skojarzonych aktywnych ani anulowanych wdrożeń.

Jeśli urządzenie zostanie ponownie przypisane do usuniętej nazwy grupy, usługa Device Update automatycznie ponownie utworzy grupę, ale nie ma skojarzonej historii urządzenia ani wdrożenia.

Troubleshooting

Jeśli oznaczysz urządzenie, ale nie widzisz grupy, spróbuj wykonać następujące kroki rozwiązywania problemów:

• Sprawdź, czy tag jest poprawnie skonfigurowany.
• Sprawdź, czy urządzenie zawiera prawidłowy identyfikator modelu Plug and Play oraz prawidłowy znacznik ADUGroup.
• Potwierdź, że trasy wiadomości IoT Hub są poprawnie skonfigurowane. Więcej informacji można znaleźć w artykule Trasowanie wiadomości.
• Upewnij się, że IoT Hub jest poprawnie powiązany z instancją Device Update.
• Uruchom diagnostykę usługi Device Update i kontrolę agenta.
• Jeśli trzeba, uruchom synchronizację urządzeń.

Więcej informacji można znaleźć w Plug and Play in Azure Device Updateoraz Device Update for Azure IoT Hub Agent check.

Powiązana zawartość

• Grupy urządzeń
• Zgodność usługi Device Update
• Wdrażanie aktualizacji