Condividi tramite

Gestire i gruppi di dispositivi

  • Articolo

Importante

Questa è la documentazione di Azure Sphere (legacy). Azure Sphere (legacy) viene ritirato il 27 settembre 2027 e gli utenti devono eseguire la migrazione ad Azure Sphere (integrato) entro questo periodo. Usare il selettore di versione posizionato sopra il sommario per visualizzare la documentazione di Azure Sphere (integrata).

Questo argomento illustra come gestire i gruppi di dispositivi usando l'interfaccia della riga di comando o Azure Sphere Explorer. I passaggi descritti in questo argomento presuppongono che si abbia familiarità con i concetti relativi a tenant, prodotti e gruppi di dispositivi di Azure Sphere.

Elencare i gruppi di dispositivi

Elencare tutti i gruppi di dispositivi nel tenant di Azure Sphere usando il comando azsphere device-group list o l'API Gruppo di dispositivi - Elenco.

Per elencare tutti i gruppi di dispositivi:

azsphere device-group list

Elencare i gruppi di dispositivi in un prodotto specifico usando il comando azsphere product device-group list o l'API Product - List Groups.

azsphere product device-group list --product <product-name>

  1. Aprire Azure Sphere Explorer.

  2. Espandere il nodo Tenant per il tenant a cui si è interessati.

  1. Aprire Azure Sphere Explorer.

  2. Espandere il nodo Tenant per il tenant a cui si è interessati.

Per visualizzare i prodotti e i gruppi di dispositivi di un tenant:

  1. Aprire Azure Sphere Explorer.

  2. Espandere il nodo Tenant per il tenant a cui si è interessati.

Se non sono elencati prodotti, creare un prodotto.

Se il dispositivo è già associato a un prodotto e assegnato a un gruppo, è possibile aggiornare il gruppo di dispositivi in qualsiasi momento.

Per visualizzare i prodotti e i gruppi di dispositivi di un tenant:

  1. Aprire Azure Sphere Explorer.

  2. Espandere il nodo Tenant per il tenant a cui si è interessati.

Se non sono elencati prodotti, creare un prodotto.

Se il dispositivo è già associato a un prodotto e assegnato a un gruppo, è possibile aggiornare il gruppo di dispositivi in qualsiasi momento.

Creare un gruppo di dispositivi

Creare un gruppo di dispositivi usando il comando azsphere device-group create o usando l'API Device Group - Create.

Per creare un gruppo di dispositivi:

azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>

I nomi per i gruppi di dispositivi possono contenere solo caratteri alfanumerici e spazi. Non possono superare i 50 caratteri. Se il nome o la descrizione include spazi, racchiuderlo tra virgolette.

È possibile includere i parametri facoltativi seguenti:

  • --os-feed specifica il tipo di feed del sistema operativo da usare per gli aggiornamenti del sistema operativo.
  • --application-update imposta i criteri di aggiornamento dell'applicazione per questo gruppo di dispositivi.

  1. Aprire Azure Sphere Explorer.

  2. Per il tenant a cui si è interessati, espandere il nodo Prodotto.

  3. Per il prodotto a cui si è interessati, fare clic con il pulsante destro del mouse e selezionare Nuovo gruppo di dispositivi.

  4. Specificare un nome per il gruppo di dispositivi e premere INVIO. I nomi per i gruppi di dispositivi possono contenere solo caratteri alfanumerici e spazi. Non possono superare i 50 caratteri. Se si specifica un nome non valido, viene segnalato un errore nella finestra Output .

È possibile creare un gruppo di dispositivi in Visual Studio Code, ma non eliminarlo. Per eliminare un gruppo di dispositivi, usare il comando azsphere device-group delete o l'API pubblica di Azure Sphere.

  1. Aprire Azure Sphere Explorer.

  2. Per il tenant a cui si è interessati, espandere il nodo Prodotto.

  3. Per il prodotto a cui si è interessati, fare clic con il pulsante destro del mouse e selezionare Nuovo gruppo di dispositivi.

  4. Specificare un nome per il gruppo di dispositivi e premere INVIO o fare clic su Applica. I nomi per i gruppi di dispositivi possono contenere solo caratteri alfanumerici e spazi. Non possono superare i 50 caratteri. Se si specifica un nome non valido, viene segnalato un errore nella finestra Output .

È possibile creare un gruppo di dispositivi in Visual Studio, ma non eliminarlo. Per eliminare i prodotti, usare il comando azsphere device-group delete o l'API pubblica di Azure Sphere.

Aggiornare il gruppo di dispositivi

È possibile modificare il nome o la descrizione di un gruppo di dispositivi usando il comando azsphere device-group update o usando l'API Device Group - Patch.

Per aggiornare il nome e la descrizione di un gruppo di dispositivi:

azsphere device-group update --device-group <device group ID or product-name/device-group-name> --new-name <new-device-group-name> --new-description <new-device-group-description>

È anche possibile aggiornare i parametri e application-update usando il comando azsphere device-group update.os-feed

  1. Aprire Azure Sphere Explorer.

  2. Per il tenant a cui si è interessati, espandere il nodo Prodotto.

  3. Per il prodotto a cui si è interessati, espandere il nodo del prodotto per visualizzare i gruppi di dispositivi inclusi. È possibile rinominare il gruppo di dispositivi o aggiornarne la descrizione, il tipo di feed del sistema operativo o i criteri di aggiornamento:

  • Per rinominare un gruppo di dispositivi, fare clic con il pulsante destro del mouse sul nome del gruppo di dispositivi e scegliere Rinomina, digitare un nuovo nome e quindi premere INVIO. I nomi per i gruppi di dispositivi possono contenere solo caratteri alfanumerici e spazi. Non possono superare i 50 caratteri. Se si specifica un nome non valido, viene segnalato un errore nella finestra Output .

  • Per aggiornare la descrizione per il gruppo di dispositivi, fare clic con il pulsante destro del mouse sul nome del gruppo di dispositivi e scegliere Aggiorna descrizione, digitare una nuova descrizione e quindi premere INVIO.

  • Per aggiornare il tipo di feed del sistema operativo, espandere il gruppo di dispositivi, fare clic con il pulsante destro del mouse sul tipo di feed del sistema operativo, scegliere Aggiorna e quindi scegliere Retail o RetailEval dal menu.

  • Per modificare i criteri di aggiornamento, espandere il gruppo di dispositivi, fare clic con il pulsante destro del mouse su Aggiorna criterio, scegliere Aggiorna e quindi scegliere No3rdPartyAppUpdates o UpdateAll dal menu. (La terza opzione, NoUpdates, attualmente è riservato per l'uso interno. Se si sceglie questa opzione, viene segnalato un errore nella finestra Output .

Spostare un dispositivo in un gruppo di dispositivi diverso usando il comando azsphere device update o l'API Devices - Move.

  1. Aprire Azure Sphere Explorer.

  2. Per il tenant a cui si è interessati, espandere il nodo Prodotto.

  3. Per il prodotto a cui si è interessati, espandere il nodo del prodotto per visualizzare i gruppi di dispositivi inclusi. È possibile rinominare il gruppo di dispositivi o aggiornarne la descrizione, il tipo di feed del sistema operativo o i criteri di aggiornamento:

  • Per rinominare un gruppo di dispositivi, selezionare il nome del gruppo di dispositivi e premere F2 o fare clic con il pulsante destro del mouse sul nome del gruppo di dispositivi e scegliere Rinomina, digitare un nuovo nome e quindi premere INVIO o fare clic su Applica. I nomi per i gruppi di dispositivi possono contenere solo caratteri alfanumerici e spazi. Non possono superare i 50 caratteri. Se si specifica un nome non valido, viene segnalato un errore nella finestra Output .

  • Per aggiornare la descrizione per il gruppo di dispositivi, espandere il gruppo di dispositivi, selezionare Descrizione e premere F2 o fare clic con il pulsante destro del mouse su Descrizione e scegliere Modifica, digitare una nuova descrizione, quindi premere INVIO o fare clic su Applica.

  • Per aggiornare il tipo di feed del sistema operativo, espandere il gruppo di dispositivi, selezionare Tipo di feed del sistema operativo e premere F2 o fare clic con il pulsante destro del mouse sul tipo di feed del sistema operativo e scegliere Modifica, scegliere Retail o RetailEval dal menu e quindi premere INVIO o fare clic su Applica.

  • Per modificare i criteri di aggiornamento, espandere il gruppo di dispositivi, selezionare Aggiorna criterio e premere F2 o fare clic con il pulsante destro del mouse su Aggiorna criterio e scegliere Modifica, scegliere No3rdPartyAppUpdates o UpdateAll dal menu, quindi premere INVIO o fare clic su Applica. (La terza opzione, NoUpdates, attualmente è riservato per l'uso interno. Se si sceglie questa opzione, viene segnalato un errore nella finestra Output .

Spostare un dispositivo in un gruppo di dispositivi diverso usando il comando azsphere device update o l'API Devices - Move.

Spostare un dispositivo in un gruppo di dispositivi diverso

Spostare un dispositivo in un gruppo di dispositivi diverso usando il comando azsphere device update o l'API Devices - Move.

Specificare l'ID del gruppo di dispositivi o una combinazione del nome del prodotto e del <gruppo di dispositivi nel formato product-name>/<device-group-name> :

azsphere device update --device-group <device-group-id>

azsphere device update --device-group <product-name/device-group-name>

Eliminare un gruppo di dispositivi

Eliminare un gruppo di dispositivi specificato nel tenant di Azure Sphere usando il comando azsphere device-group delete o usando l'API Device Group - Delete.

Un gruppo di dispositivi può essere eliminato solo quando:

Specificare l'ID del gruppo di dispositivi o una combinazione del nome del prodotto e del <gruppo di dispositivi nel formato product-name>/<device-group-name> :

azsphere device-group delete --device-group <device-group-id>

azsphere device-group delete --device-group <product-name/device-group-name>