Distribuisci un aggiornamento software a un gruppo (anteprima)

Per creare un gruppo nel portale di Azure:

1. Nella navigazione dello spazio dei nomi, apri Operations>Groups (anteprima) e poi inizia la creazione dei gruppi dalla barra dei comandi.

2. Nella pagina Informazioni di base, inserisci un Nome descrittivo e, opzionalmente, una Descrizione che identifica il gruppo di dispositivi previsto.

3. Nella pagina Definizione, sotto Definisci condizioni di filtro, inserisci una query che seleziona i dispositivi connessi a hub IoT che vuoi aggiornare.

   

   I filtri di gruppo sono immutabili dopo la creazione. Per usare criteri di appartenenza diversi, crea un altro gruppo con una query diversa.

4. Nella pagina Rivedi, verificare Informazioni di base, Definizione e Filtro query, quindi selezionare Crea.

   

Un gruppo è una Microsoft.DeviceRegistry/namespaces/groups risorsa. Il properties.query valore seleziona i dispositivi registrati connessi all'hub IoT che diventano membri del gruppo, basandosi sulle proprietà del dispositivo come manufacturer, model, o softwareRevision. Dopo aver creato il gruppo, non puoi cambiare la sua query. Per usare criteri di appartenenza diversi, crea un altro gruppo con una query diversa.

Crea un file Bicep con il seguente contenuto. Sostituisci i valori provvisori, come <NAMESPACE_NAME> e <GROUP_NAME> con i tuoi.

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. Nel portale Azure, vai al tuo Azure Device Registry e seleziona il namespace che contiene i dispositivi che vuoi aggiornare.

2. Nel namespace, seleziona Operations>Jobs. La schermata Lavori elenca i lavori definiti con il loro stato, tipo di lavoro e gruppo target. Da questa schermata puoi anche visualizzare i gruppi e gli aggiornamenti software nel namespace.

   

3. Selezionare Crea per creare un nuovo processo.

4. Nella pagina Nozioni di base, fornire un nome e una descrizione per il processo.

5. Per il tipo di lavoro, seleziona aggiornamento software.

   In anteprima, i tipi di processo disponibili sono Aggiornamento software e Aggiornamento dell'onboarding. Un processo di aggiornamento software è destinato a un gruppo di dispositivi, mentre un processo di aggiornamento di onboarding è destinato ai dispositivi che vengono registrati in uno spazio dei nomi. Questo articolo illustra il processo di aggiornamento software.

6. Seleziona il gruppo che vuoi raggiungere. Usa il selezionatore di gruppo per cercare e selezionare un gruppo. Il picker mostra il numero approssimativo di dispositivi in ciascun gruppo.

   Per informazioni su come si aggiorna l'appartenenza al gruppo, vedi Concetti di gruppo (anteprima).

7. Salva la selezione del gruppo. Il portale mostra un campione dei dispositivi nel gruppo e il conteggio dei dispositivi.

8. Definisci l'azione da eseguire selezionando uno degli aggiornamenti software importati nel namespace. Ogni aggiornamento software include un controllo di compatibilità che determina se si applica a un dispositivo. Il portale esegue un controllo di compatibilità per il gruppo selezionato per determinare se l'aggiornamento software sia compatibile.

   

9. Seleziona Avanti per visualizzare un riepilogo del lavoro. Il riepilogo mostra il numero di membri del gruppo e una stima del numero di membri compatibili che il lavoro probabilmente aggiornerà con successo.

   

10. Fare clic su Crea. Lo stato del lavoro mostra In creazione e poi cambia in Pronto dopo un attimo.

Un lavoro di aggiornamento software è una Microsoft.DeviceRegistry/namespaces/jobs risorsa con properties.jobType impostato su SoftwareUpdate. La target.resourceId proprietà fa riferimento al gruppo a cui il lavoro applica l'aggiornamento e deve essere un ID risorsa per una Microsoft.DeviceRegistry/namespaces/groups risorsa nello stesso namespace. La proprietà definition.update.updateId identifica l'aggiornamento software da applicare in base al provider, al nome e alla versione. Attualmente, definition.schedulingType supporta solo il valore Continuous.

Dopo aver creato il lavoro, le sue proprietà—inclusi target e definitione—sono immutabili. Per cambiare il gruppo target o aggiornare la definizione, elimina il lavoro e creane uno nuovo.

Crea un file Bicep con il seguente contenuto. Sostituisci i valori segnaposto, come <NAMESPACE_NAME>, <GROUP_NAME>, e i valori dell'identificatore di aggiornamento, con i tuoi.

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. Nella schermata Lavori , seleziona il lavoro che vuoi eseguire.

2. Seleziona una delle opzioni seguenti.

   • Esegui ora: Il processo viene eseguito immediatamente.
   • Programma per dopo: Scegli un orario nei prossimi sette giorni. Il lavoro viene eseguito all'orario che selezioni.

Dopo aver eseguito o programmato il processo, il portale passa alla scheda Runs.

Bicep dichiara risorse, quindi non può attivare direttamente un'azione come eseguire o programmare un lavoro. Invece, usa l'azione del job schedule, che puoi chiamare con interfaccia della riga di comando di Azure. Per svolgere subito il lavoro, ometti scheduledTime. Per programmare il processo, includere un valore 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: La data e l'ora UTC per eseguire il lavoro. Omettere questa proprietà per eseguire il processo immediatamente.
• timeout: Una durata ISO 8601 che limita la durata consentita dell'esecuzione, ad esempio PT1H per un'ora. Questa proprietà è facoltativa.

Dopo aver eseguito o programmato il lavoro, usa il portale Azure o le API di esecuzione del lavoro per monitorare l'esecuzione.

1. Seleziona la scheda Esecuzioni per visualizzare le esecuzioni e il loro stato.

2. Seleziona una run completata per visualizzarne le statistiche. I dettagli dell'esecuzione mostrano il numero di dispositivi aggiornati e i dettagli di quei dispositivi.

3. Controlla un dispositivo specifico. Per confermare se un dispositivo specifico è stato aggiornato, usa la casella di ricerca nei dettagli della run per trovare il dispositivo.

Le run di lavoro sono risorse di sola lettura, quindi le monitori interrogando il Microsoft.DeviceRegistry/namespaces/jobs/runs tipo di risorsa invece di dichiararle in Bicep. Usa interfaccia della riga di comando di Azure per elencare le esecuzioni del processo e controllarne lo stato:

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"

Ogni esecuzione include un valore status, come Scheduled, Running o Ended, e un riepilogo results con i conteggi dei dispositivi completati con successo, falliti, in corso, in attesa e cancellati.

Per controllare un dispositivo specifico, ottieni i risultati di una run e filtra per stato:

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

Ogni voce nei risultati identifica il dispositivo target e il suo stato per dispositivo. Omettere la proprietà filter nel corpo della richiesta per restituire tutti i risultati dei dispositivi per l'esecuzione.