Bereitstellen Sie ein Software-Update für eine Gruppe (Vorschau)

So erstellen Sie eine Gruppe im Azure-Portal:

1. Öffnen Sie in der Namensraum-Navigation Operations>Groups (Vorschau) und starten Sie dann die Gruppenerstellung über die Befehlsleiste.

2. Auf der Seite Grundlagen geben Sie einen beschreibenden Namen und optional eine Beschreibung ein, die die beabsichtigte Gerätekohorte identifiziert.

3. Auf der Definitionsseite geben Sie unter Filterbedingungen definieren eine Abfrage ein, die die mit dem IoT Hub verbundenen Geräte auswählt, die Sie aktualisieren möchten.

   

   Gruppenfilter sind nach der Erstellung unveränderlich. Um andere Mitgliedschaftskriterien zu verwenden, erstellen Sie eine weitere Gruppe mit einer anderen Abfrage.

4. Überprüfen Sie auf der Seite Überprüfen die Grundlagen, die Definition und den Abfragefilter und wählen Sie dann Erstellen aus.

   

Eine Gruppe ist eine Microsoft.DeviceRegistry/namespaces/groups Ressource. Der Wert properties.query wählt die registrierten IoT Hub-verbundenen Geräte aus, die Mitglieder der Gruppe werden, basierend auf Geräteeigenschaften wie manufacturer, model, oder softwareRevision. Nachdem du die Gruppe erstellt hast, kannst du ihre Abfrage nicht mehr ändern. Um andere Mitgliedschaftskriterien zu verwenden, erstellen Sie eine weitere Gruppe mit einer anderen Abfrage.

Erstellen Sie eine Bicep-Datei mit folgendem Inhalt. Ersetzen Sie die Platzhalterwerte, wie zum Beispiel <NAMESPACE_NAME> und <GROUP_NAME>, durch Ihre eigenen.

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
  }
}

1. Im Azure-Portal gehen Sie in Ihr Azure Device Registry und wählen Sie den Namespace aus, der die Geräte enthält, die Sie aktualisieren möchten.

2. Wählen Sie im Namespace Operationen>Aufträge aus. Der Job-Bildschirm listet die definierten Jobs mit ihrem Status, Jobtyp und Zielgruppe auf. Von diesem Bildschirm aus können Sie auch die Gruppen und Software-Updates im Namespace ansehen.

   

3. Wählen Sie Erstellen, um einen neuen Job zu erstellen.

4. Gib auf der Seite Grundlagen einen Namen und eine Beschreibung für den Job an.

5. Für den Jobtyp wählen Sie Software-Update.

   In der Vorschau sind die verfügbaren Jobtypen Software-Update und Onboarding-Update. Ein Software-Update-Job zielt auf eine Gruppe von Geräten ab, und ein Onboarding-Update-Job auf Geräte, die in einen Namespace integriert werden. Dieser Artikel behandelt die Software-Update-Aufgabe.

6. Wählen Sie die Gruppe aus, die Sie ansprechen möchten. Verwenden Sie den Gruppenwähler, um eine Gruppe zu suchen und auszuwählen. Der Picker zeigt die ungefähre Anzahl der Geräte in jeder Gruppe an.

   Informationen darüber, wie die Gruppenmitgliedschaft aktualisiert wird, finden Sie unter Gruppenkonzepte (Vorschau).

7. Speichere die Gruppenauswahl. Das Portal zeigt eine Stichprobe der Geräte in der Gruppe und die Anzahl der Geräte.

8. Definieren Sie die auszuführende Aktion, indem Sie eines der Software-Updates auswählen, die in den Namensraum importiert wurden. Jedes Softwareupdate enthält eine Kompatibilitätsprüfung, die bestimmt, ob es für ein Gerät geeignet ist. Das Portal führt eine Kompatibilitätsprüfung für die ausgewählte Gruppe durch, um festzustellen, ob das Software-Update kompatibel ist.

   

9. Wählen Sie Weiter, um eine Zusammenfassung des Auftrags anzusehen. Die Zusammenfassung zeigt die Anzahl der Gruppenmitglieder und eine Schätzung der Anzahl kompatibler Mitglieder, die voraussichtlich erfolgreich durch den Auftrag aktualisiert werden.

   

10. Wählen Sie "Erstellen" aus. Der Auftragsstatus zeigt Wird erstellt an und ändert sich nach einem Moment in Bereit.

Ein Softwareupdate-Auftrag ist eine Microsoft.DeviceRegistry/namespaces/jobs Ressource, bei der properties.jobType auf SoftwareUpdate festgelegt ist. Die Eigenschaft target.resourceId bezieht sich auf die Gruppe, auf die der Job das Update anwendet, und muss eine Ressourcen-ID für eine Microsoft.DeviceRegistry/namespaces/groups Ressource im selben Namensraum sein. Die Eigenschaft definition.update.updateId identifiziert das zu anwendbare Software-Update anhand seines Anbieters, Namens und Version. Derzeit wird der Wert definition.schedulingType nur von Continuous unterstützt.

Nachdem du den Job geschaffen hast, sind seine Eigenschaften – einschließlich target und definition– unveränderlich. Um die Zielgruppe zu ändern oder die Definition zu aktualisieren, löschen Sie den Job und erstellen Sie einen neuen.

Erstellen Sie eine Bicep-Datei mit folgendem Inhalt. Ersetzen Sie die Platzhalterwerte, wie <NAMESPACE_NAME>, <GROUP_NAME>, und die Update-Kennungswerte, durch Ihre eigenen.

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
        }
      }
    }
  }
}

1. Wähle auf dem Jobs-Bildschirm den Job aus, den du ausführen möchtest.

2. Wählen Sie eine der folgenden Optionen aus:

   • Jetzt ausführen: Der Auftrag wird sofort ausgeführt.
   • Termin für später: Wähle eine Uhrzeit in den nächsten sieben Tagen. Der Job läuft zu dem Zeitpunkt, den du auswählst.

Nachdem Sie den Auftrag ausgeführt oder geplant haben, wechselt das Portal zur Registerkarte Ausführungen.

Bicep deklariert Ressourcen, daher kann er keine Aktion wie das Ausführen oder Planen eines Auftrags direkt auslösen. Verwenden Sie stattdessen die schedule Aktion des Jobs, die Sie mit der Azure CLI aufrufen können. Wenn der Auftrag sofort ausgeführt werden soll, lassen Sie scheduledTime weg. Um den Job zu planen, fügen Sie einen scheduledTime-Wert hinzu.

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: Das UTC-Datum und die Uhrzeit für die Durchführung des Jobs. Lass diese Eigenschaft weg, um den Job sofort auszuführen.
• timeout: Eine ISO-8601-Dauer, die begrenzt, wie lange der Lauf dauern darf, zum Beispiel PT1H für eine Stunde. Diese Eigenschaft ist optional.

Nachdem du den Job ausgeführt oder geplant hast, nutze das Azure-Portal oder die Job-Run-APIs, um die Ausführung zu überwachen.

1. Wählen Sie den Reiter Runs, um die Runs und ihren Status anzuzeigen.

2. Wählen Sie einen abgeschlossenen Durchlauf aus, um dessen Statistiken einzusehen. Die Laufdetails zeigen die Anzahl der aktualisierten Geräte und Details dieser Geräte an.

3. Überprüfe ein bestimmtes Gerät. Um zu prüfen, ob ein bestimmtes Gerät aktualisiert wurde, verwenden Sie das Suchfeld in den Laufdetails, um das Gerät zu finden.

Job-Runs sind schreibgeschützte Ressourcen, daher überwachen Sie sie, indem Sie den Microsoft.DeviceRegistry/namespaces/jobs/runs Ressourcentyp abfragen, anstatt sie in Bicep zu deklarieren. Verwenden Sie Azure CLI, um die Läufe für den Job aufzulisten und ihren Status zu überprüfen:

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"

Jede Ausführung enthält einen Wert status wie Scheduled, Running oder Ended sowie eine results-Zusammenfassung mit der Anzahl erfolgreicher, fehlgeschlagener, laufender, ausstehender und abgebrochener Geräte.

Um ein bestimmtes Gerät zu überprüfen, erhalten Sie die Ergebnisse für einen Durchlauf und filtern Sie nach Status:

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'\''"
  }'

Jeder Eintrag in den Ergebnissen identifiziert das Zielgerät und seinen gerätespezifischen Status. Lassen Sie die filter Eigenschaft im Request-Body weg, um alle Geräteergebnisse für den Run zurückzugeben.