Creare e gestire gruppi di dispositivi Azure SphereCreate and manage Azure Sphere device groups

Questo argomento illustra come creare gruppi di dispositivi, aggiornare i gruppi di dispositivi e spostare i dispositivi in gruppi di dispositivi diversi.This topic documents how to create device groups, update device groups, and move devices to different device groups.

Prima di iniziareBefore you begin

I passaggi descritti in questo argomento presuppongono che si abbia familiarità con i concetti di Azure Sphere tenant, prodottie gruppi di dispositivi.The steps in this topic assume that you are familiar with the concepts of Azure Sphere Tenants, Products, and Device groups.

Elencare i prodotti e i gruppi di dispositiviList products and device groups

Con il dispositivo connesso, eseguire il comando seguente per elencare i prodotti e i gruppi di dispositivi:With your device connected, run the following command to list your products and device groups:

azsphere device show

  1. Selezionare l'icona Esplora Azure Sphere nella barra delle attività di Visual Studio Code per aprire Azure Sphere Explorer.Select the Azure Sphere Explorer icon in Visual Studio Code's Activity Bar to open Azure Sphere Explorer. Se il riquadro tenant Mostra Accedi per visualizzare i tenant, accedere a Azure Sphere e selezionare Aggiorna per visualizzare i tenant disponibili.If the Tenant pane shows Log in to see tenants, log in to Azure Sphere and select Refresh to see the available tenants.

  2. Espandere il nodo tenant per il tenant a cui si è interessati.Expand the Tenant node for the tenant you are interested in.

  1. Selezionare Visualizza > altre finestre > Azure Sphere Esplora risorse.Select View > Other Windows > Azure Sphere Explorer. Se il riquadro tenant Mostra Accedi per visualizzare i tenant, accedere a Azure Sphere e selezionare Aggiorna per visualizzare i tenant disponibili.If the Tenant pane shows Log in to see tenants, log in to Azure Sphere and select Refresh to see the available tenants.

  2. Espandere il nodo tenant per il tenant a cui si è interessati.Expand the Tenant node for the tenant you are interested in.

Se non è elencato alcun prodotto, creare un prodotto.If there are no products listed, create a product.

azsphere device show
Retrieved the device configuration for device with ID <device-id>:
   ChipSKU: 'MT3620AN'
   This device does not have a product set.
   The device does not have a device group set.

Se il dispositivo è già associato a un prodotto e assegnato a un gruppo, è possibile aggiornare il relativo gruppo di dispositivi in qualsiasi momento.If the device is already associated with a product and assigned to a group, you can update its device group at any time.

azsphere device show
Retrieved the device configuration for device with ID <device-id>:
  ChipSKU: 'MT3620AN'
  Product ID: <product-id>
  Product name: 'SprinklerTest'
  Device group ID: <device-group-id>
  Device group name: 'Field Test'

Creare un gruppo di dispositiviCreate a device group

  1. Eseguire il comando seguente per creare un gruppo di dispositivi:Run the following command to create a device group:

    azsphere device-group create --productname <product-name> --name <device-group-name> --osfeed RetailEval --applicationupdate Off

    La sintassi di esempio include i parametri facoltativi seguenti:Sample syntax includes the following optional parameters:

    • --osfeed è impostato su RetailEval.--osfeed is set to RetailEval.
    • --applicationupdate imposta gli aggiornamenti dell'applicazione su off, in modo che il gruppo di dispositivi possa essere usato per il test con il sistema operativo RetailEval.--applicationupdate sets application updates to off so that the device group can be used for testing with the RetailEval operating system.
  2. Prendere nota dell'ID del gruppo di dispositivi.Note the device group ID. Questa operazione verrà usata per spostare i dispositivi in questo gruppo di dispositivi.You will use this to move devices to this device group.

    Per un elenco di parametri facoltativi, vedere gruppo di dispositivi: crea.For a list of optional parameters, see Device group: Create.

  1. Selezionare l'icona Esplora Azure Sphere nella barra delle attività di Visual Studio Code per aprire Azure Sphere Explorer.Select the Azure Sphere Explorer icon in Visual Studio Code's Activity Bar to open Azure Sphere Explorer. Se il riquadro tenant Mostra Accedi per visualizzare i tenant, accedere a Azure Sphere e selezionare Aggiorna per visualizzare i tenant disponibili.If the Tenant pane shows Log in to see tenants, log in to Azure Sphere and select Refresh to see the available tenants.

  2. Per il tenant a cui si è interessati, espandere il nodo Product.For the tenant you are interested in, expand the Product node.

  3. Per il prodotto a cui si è interessati, fare clic con il pulsante destro del mouse e scegliere Crea gruppo di dispositivi.For the product you are interested in, right-click and select Create device group.

  4. Specificare un nome e una descrizione per il gruppo di dispositivi.Specify a name and description for the device group.

  5. Prendere nota dell'ID del gruppo di dispositivi.Note the device group ID. Questa operazione verrà usata per spostare i dispositivi in questo gruppo di dispositivi.You will use this to move devices to this device group.

    Per un elenco di parametri facoltativi, vedere gruppo di dispositivi: crea.For a list of optional parameters, see Device group: Create.

Aggiornare il gruppo di dispositiviUpdate the device group

È possibile modificare il nome o la descrizione di un gruppo di dispositivi in qualsiasi momento usando l' aggiornamento del gruppo di dispositivi azsphere.You can modify a device group's name or description at any time using azsphere device-group update.

Per aggiornare il nome e la descrizione di un gruppo di dispositivi:To update a device group's name and description:

azsphere device-group update --newname <new-device-group-name> --newdescription <new-device-group-description> --devicegroupid <device-group-id>

È anche possibile aggiornare i osfeed applicationupdate parametri e usando il device-group update comando.You can also update the osfeed and applicationupdate parameters using the device-group update command. Per ulteriori informazioni, vedere gruppo di dispositivi: aggiornamento.For more information, see Device group: Update.

  1. Selezionare l'icona Esplora Azure Sphere nella barra delle attività di Visual Studio Code per aprire Azure Sphere Explorer.Select the Azure Sphere Explorer icon in Visual Studio Code's Activity Bar to open Azure Sphere Explorer. Se il riquadro tenant Mostra Accedi per visualizzare i tenant, accedere a Azure Sphere e selezionare Aggiorna per visualizzare i tenant disponibili.If the Tenant pane shows Log in to see tenants, log in to Azure Sphere and select Refresh to see the available tenants.

  2. Per il tenant a cui si è interessati, espandere il nodo Product.For the tenant you are interested in, expand the Product node.

  3. Per il prodotto a cui si è interessati, espandere il nodo prodotto per visualizzare i gruppi di dispositivi inclusi.For the product you are interested in, expand the product node to show its included device groups.

  4. Per il gruppo di dispositivi che si desidera aggiornare, fare clic con il pulsante destro del mouse sul nome del gruppo di dispositivi e selezionare Aggiorna.For the device group you want to update, right-click the device group name and select Update.

  5. Specificare un nuovo nome e una descrizione per il gruppo di dispositivi.Specify a new name and description for the device group.

Spostare un dispositivo in un gruppo di dispositivi desideratoMove a device to a desired device group

Eseguire il comando seguente per spostare un dispositivo in un altro gruppo di dispositivi.Run the following command to move a device to a different device group. È possibile usare l'ID del gruppo di dispositivi o una combinazione del nome del prodotto e del nome del gruppo di dispositivi:You can use either the device group ID or a combination of the product name and device group name:

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

azsphere device update --devicegroupname <device-group-name> --productname <product-name>