Wdróż aktualizację oprogramowania do grupy (podgląd)

Azure Device Registry wykorzystuje zadania do wdrażania aktualizacji oprogramowania dla grup urządzeń połączonych z IoT Hub. Zadanie aktualizacji oprogramowania jest kierowane do grupy urządzeń i stosuje aktualizację oprogramowania do zgodnych urządzeń z tej grupy. Natomiast aktualizacja onboardingu jest skierowana do urządzeń, które są wdrażane do przestrzeni nazw. Wdrożenie aktualizacji oprogramowania jako zadania pozwala wdrożyć tę samą aktualizację na wiele urządzeń jednocześnie, dzięki czemu możesz utrzymać aktualność urządzeń podłączonych do IoT Hub bez aktualizowania każdego urządzenia z osobna.

Ten artykuł pokazuje, jak zdefiniować lub zweryfikować grupę docelową, użyć portalu Azure lub Bicep do stworzenia standardowego zadania aktualizacji oprogramowania, uruchomić lub zaplanować zadanie oraz monitorować wyniki. Użyj tego artykułu po zaimportowaniu aktualizacji oprogramowania , którą chcesz zastosować. Aby dowiedzieć się, jak zadania, grupy i aktualizacje oprogramowania współdziałają, zobacz aktualizacje oprogramowania w Azure Device Registry.

Important

Aktualizacje oprogramowania Azure Device Registry są obecnie w fazie podglądu. Obecna wersja zapoznawcza dotyczy urządzeń podłączonych do IoT Hub. Ten podgląd jest udostępniany bez umowy o poziomie usług, a jego możliwości i obsługa w portalu mogą się zmienić, zanim stanie się powszechnie dostępne. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.

Note

Podczas podglądu możesz używać aktualizacji oprogramowania tylko z hubami IoT, które nie mają istniejącego wystąpienia Device Update for IoT Hub. Aby korzystać z aktualizacji oprogramowania, połącz z przestrzenią nazw centrum IoT, które nie ma wystąpienia usługi Device Update for IoT Hub, lub usuń istniejące wystąpienie przed połączeniem centrum. Więcej informacji można znaleźć w sekcji Aktualizacje oprogramowania i Device Update for IoT Hub.

Prerequisites

Urządzenia podłączone do IoT Hub, których właściwości identyfikują urządzenia, które chcesz zaktualizować. Użyj tych właściwości, aby zdefiniować grupę docelową.
Aktualizacja oprogramowania została zaimportowana do przestrzeni nazw. Aby dowiedzieć się więcej, zobacz Importowanie aktualizacji oprogramowania (wersja zapoznawcza).
Aktualizacje oprogramowania są włączone w przestrzeni nazw, w której znajdują się Twoje urządzenia. Aby dowiedzieć się więcej, zobacz: Rozpoczęcie pracy z Azure Device Registry.
uprawnienia płaszczyzny sterowania usługi Azure Resource Manager, takie jak rola Współautor, do tworzenia, odczytu, aktualizacji i usuwania zadań.
Aby wykonać zadania, zarządzana tożsamość przestrzeni nazw musi mieć dostęp do instancji aktualizacji oprogramowania powiązanej z tą przestrzenią nazw. Jeśli włączysz aktualizacje oprogramowania w portalu Azure, te przypisania ról zostaną utworzone automatycznie.

Zdefiniuj lub zweryfikuj grupę docelową

Zadanie aktualizacji oprogramowania celuje w grupę, a nie w każde urządzenie w przestrzeni nazw. Stwórz grupę z filtrem, który wybierze tylko urządzenia połączone z IoT Hub, które powinny otrzymać aktualizację, lub wykorzystaj istniejącą grupę, której członkostwo odpowiada temu zakresowi. Na przykład użyj właściwości urządzenia, takich jak producent, model lub wersja oprogramowania, aby dotrzeć do konkretnej grupy urządzeń. Użyj portalu Azure lub Bicep, aby utworzyć grupę.

Portal Azure
Bicep

Aby utworzyć grupę w witrynie Azure Portal:

W nawigacji w przestrzeni nazw otwórz Operacje>Grupy (podgląd), a następnie rozpocznij tworzenie grup z paska poleceń.
Na stronie Podstawy wpisz opisową nazwę oraz, opcjonalnie, opis , który identyfikuje zamierzoną grupę urządzeń.
Na stronie Definition, w sekcji Define filter conditions, wprowadź zapytanie, które wybiera urządzenia podłączone do IoT Hub, które chcesz zaktualizować.

Filtry grupowe są niezmienne po utworzeniu. Aby użyć różnych kryteriów członkostwa, stwórz inną grupę z innym zapytaniem.
Na stronie Przegląd sprawdź Podstawy, Definicja i Filtr zapytania, a następnie wybierz Utwórz.

Grupa to Microsoft.DeviceRegistry/namespaces/groups zasób. Wartość properties.query wybiera zarejestrowane urządzenia połączone z IoT Hub, które stają się członkami grupy, na podstawie właściwości urządzeń takich jak manufacturer, model lub softwareRevision. Po utworzeniu grupy nie możesz zmienić jej zapytania. Aby użyć różnych kryteriów członkostwa, stwórz inną grupę z innym zapytaniem.

Stwórz plik Bicep z następującą zawartością. Zamień wartości zastępcze, takie jak <NAMESPACE_NAME> i <GROUP_NAME>, na własne.

param namespaceName string = '<NAMESPACE_NAME>'
param groupName string = 'contoso-tractors'
param groupDescription string = 'Devices to receive the software update'
param groupQuery string = 'WHERE manufacturer = \'contoso\' AND model = \'tractor\''

resource namespace 'Microsoft.DeviceRegistry/namespaces@2026-11-02-preview' existing = {
  name: namespaceName
}

resource group 'Microsoft.DeviceRegistry/namespaces/groups@2026-11-02-preview' = {
  parent: namespace
  name: groupName
  location: namespace.location
  properties: {
    description: groupDescription
    query: groupQuery
  }
}

Członkostwo w grupie jest obliczane i buforowane podczas tworzenia lub odświeżania grupy. Zanim skorzystasz z grupy do pracy związanej z aktualizacją oprogramowania:

Odśwież członkostwo grupy, jeśli właściwości urządzenia mogły się zmienić. W portalu Azure Odśwież jest dostępne z paska poleceń szczegółów grupy.
Poczekaj, aż status grupy będzie gotowy.
W widoku szczegółów grup zweryfikuj filtr rozwiązanych zapytań oraz liczbę członków. Lista członków wyświetla podgląd maksymalnie 10 urządzeń, więc traktuj ją jako wyrywkową kontrolę, a nie pełną listę, i potwierdź, że liczba członków odpowiada liczbie urządzeń, które zamierzasz zaktualizować.

Stwórz zadanie aktualizacji oprogramowania

Zadanie aktualizacji oprogramowania jest kierowane do grupy urządzeń i stosuje importowaną aktualizację oprogramowania do kompatybilnych urządzeń w tej grupie. Użyj portalu Azure lub Bicep, aby utworzyć job.

Portal Azure
Bicep

W portalu Azure przejdź do usługi Azure Device Registry i wybierz przestrzeń nazw, która zawiera urządzenia, które chcesz zaktualizować.
W przestrzeni nazw wybierz Operations>Jobs. Ekran Zadania zawiera listę zdefiniowanych zadań wraz ze statusem, typem zadania i grupą docelową. Na tym ekranie możesz także zobaczyć grupy i aktualizacje oprogramowania w przestrzeni nazw.
Wybierz Create , aby utworzyć nowe zadanie.
Na stronie Podstawy podaj nazwę i opis zadania.
Dla typu zadania wybierz aktualizację oprogramowania.

W podglądzie dostępne typy zadań to aktualizacja oprogramowania oraz aktualizacja wdrożenia. Zadanie aktualizacji oprogramowania dotyczy grupy urządzeń, a zadanie aktualizacji wdrażania dotyczy urządzeń wdrażanych do przestrzeni nazw. Ten artykuł dotyczy zadania związanego z aktualizacją oprogramowania.
Wybierz grupę, do której chcesz kierować. Użyj selektora grup, aby wyszukać i wybrać grupę. Picker pokazuje przybliżoną liczbę urządzeń w każdej grupie.

Aby uzyskać informacje o tym, jak odświeża się członkostwo w grupie, zobacz Koncepcje grup (podgląd).
Zapisz wybór grupy. Portal pokazuje próbkę urządzeń w grupie oraz liczbę urządzeń.
Zdefiniuj akcję do wykonania, wybierając jedną z aktualizacji oprogramowania zaimportowanych do przestrzeni nazw. Każda aktualizacja oprogramowania zawiera sprawdzenie kompatybilności, które określa, czy dotyczy danego urządzenia. Portal przeprowadza sprawdzenie zgodności dla wybranej grupy, aby sprawdzić, czy aktualizacja oprogramowania jest kompatybilna.
Wybierz Dalej, aby zobaczyć podsumowanie zadania. Podsumowanie pokazuje liczbę członków grupy oraz szacunkową liczbę kompatybilnych członków, którzy prawdopodobnie zostaną pomyślnie zaktualizowani przez zadanie.
Wybierz Utwórz. Status zadania pokazuje Tworzenie , a po chwili zmienia się na Gotowe .

Zadanie aktualizacji oprogramowania to zasób Microsoft.DeviceRegistry/namespaces/jobs z ustawieniem properties.jobType na SoftwareUpdate. Właściwość target.resourceId odwołuje się do grupy, do której zadanie stosuje aktualizację, i musi być identyfikatorem zasobu Microsoft.DeviceRegistry/namespaces/groups w tej samej przestrzeni nazw. definition.update.updateId Właściwość identyfikuje aktualizację oprogramowania do zastosowania według dostawcy, nazwy i wersji. Obecnie obsługuje definition.schedulingType tylko wartość Continuous.

Po utworzeniu zadania jego właściwości — w tym target i definition— są niezmienne. Aby zmienić grupę docelową lub zaktualizować definicję, usuń zadanie i utwórz nowe.

Stwórz plik Bicep z następującą zawartością. Zamień wartości zastępcze, takie jak <NAMESPACE_NAME>, <GROUP_NAME> oraz wartości identyfikatorów aktualizacji, własnymi wartościami.

param namespaceName string = '<NAMESPACE_NAME>'
param jobName string = '<JOB_NAME>'
param groupName string = '<GROUP_NAME>'
param updateProvider string = '<UPDATE_PROVIDER>'
param updateName string = '<UPDATE_NAME>'
param updateVersion string = '<UPDATE_VERSION>'

resource namespace 'Microsoft.DeviceRegistry/namespaces@2026-11-02-preview' existing = {
  name: namespaceName
}

resource group 'Microsoft.DeviceRegistry/namespaces/groups@2026-11-02-preview' existing = {
  parent: namespace
  name: groupName
}

resource softwareUpdateJob 'Microsoft.DeviceRegistry/namespaces/jobs@2026-11-02-preview' = {
  parent: namespace
  name: jobName
  location: namespace.location
  properties: {
    description: 'Software update job'
    jobType: 'SoftwareUpdate'
    target: {
      resourceId: group.id
    }
    definition: {
      schedulingType: 'Continuous'
      update: {
        updateId: {
          provider: updateProvider
          name: updateName
          version: updateVersion
        }
      }
    }
  }
}

Wykonaj lub zaplanuj zadanie

Gdy zadanie jest gotowe, możesz je uruchomić od razu lub zaplanować na późniejsze uruchomienie.

Portal Azure
Bicep

Na ekranie Jobs wybierz zadanie, które chcesz uruchomić.
Wybierz jedną z następujących opcji:
- Uruchom teraz: Zadanie uruchamia się natychmiast.
- Zaplanuj na później: Wybierz termin w ciągu najbliższych siedmiu dni. Zadanie uruchamia się w momencie, który wybierzesz.

Po uruchomieniu lub zaplanowaniu zadania portal przechodzi do zakładki Runs.

Bicep deklaruje zasoby, więc nie może bezpośrednio wywołać akcji, takiej jak uruchomienie czy planowanie zadania. Zamiast tego użyj akcji zadaniaschedule, którą możesz wywołać za pomocą Azure CLI. Aby uruchomić zadanie od razu, pomiń scheduledTime. Aby zaplanować zlecenie, podaj wartość scheduledTime .

az rest --method post \
  --uri "https://management.azure.com/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.DeviceRegistry/namespaces/<NAMESPACE_NAME>/jobs/<JOB_NAME>/schedule?api-version=2026-11-02-preview" \
  --body '{
    "scheduledTime": "2026-11-15T14:30:00Z",
    "timeout": "PT1H"
  }'

scheduledTime: UTC data i godzina wykonania zadania. Pomiń tę właściwość, aby natychmiast uruchomić zadanie.
timeout: Czas trwania zgodnie z ISO 8601, który ogranicza, jak długo może trwać uruchomienie, na przykład PT1H, czyli jedna godzina. Ta właściwość jest opcjonalna.

Po uruchomieniu lub zaplanowaniu zadania użyj portalu Azure lub interfejsów API uruchomień zadań, aby monitorować jego uruchomienie.

Monitoruj wykonanie zadania

Zakładka Runs pokazuje zadania, w tym uruchomione, ukończone i zaplanowane uruchomienia.

Portal Azure
Bicep

Wybierz kartę Uruchomienia, aby zobaczyć uruchomienia i ich stan.
Wybierz zakończony przebieg, aby zobaczyć jego statystyki. Szczegóły uruchomienia pokazują liczbę zaktualizowanych urządzeń oraz szczegóły tych urządzeń.
Sprawdź konkretne urządzenie. Aby potwierdzić, czy dane urządzenie zostało zaktualizowane, użyj pola wyszukiwania w szczegółach uruchomienia, aby znaleźć urządzenie.

Przebiegi zadań są zasobami tylko do odczytu, więc monitorujesz je, wysyłając zapytanie do typu zasobu Microsoft.DeviceRegistry/namespaces/jobs/runs, zamiast deklarować je w Bicep. Użyj Azure CLI, aby wyświetlić przebiegi zadania i sprawdzić ich status:

az rest --method get \
  --uri "https://management.azure.com/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.DeviceRegistry/namespaces/<NAMESPACE_NAME>/jobs/<JOB_NAME>/runs?api-version=2026-11-02-preview"

Każde uruchomienie zawiera wartość status, taką jak Scheduled, Running lub Ended, oraz podsumowanie results z liczbą urządzeń, które zakończyły się powodzeniem, zakończyły się niepowodzeniem, są w trakcie, oczekują i zostały anulowane.

Aby sprawdzić konkretne urządzenie, pobierz wyniki uruchomienia i przefiltruj według statusu:

az rest --method post \
  --uri "https://management.azure.com/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.DeviceRegistry/namespaces/<NAMESPACE_NAME>/jobs/<JOB_NAME>/runs/<RUN_NAME>/listResults?api-version=2026-11-02-preview" \
  --body '{
    "filter": "status eq '\''Failed'\''"
  }'

Każdy wpis w wynikach identyfikuje urządzenie docelowe oraz jego status dla danego urządzenia. Pomiń właściwość filter w ciele żądania, aby zwrócić wszystkie wyniki wszystkich urządzeń dla przebiegu.

Opinia

Czy ta strona była pomocna?

Ostatnia aktualizacja o 2026-10-05