Gestire i prodotti
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).
Un prodotto identifica una MCU Azure Sphere incorporata in un dispositivo connesso per eseguire una funzione specifica. Come produttore, si crea un prodotto per ogni modello di un dispositivo connesso, ad esempio una lavastoviglie o una macchina per il caffè. Ad esempio, Contoso crea un prodotto per le lavastoviglie DW100 di sua produzione, assegnando in fase di produzione tale prodotto a tutte le lavastoviglie DW100. Ogni prodotto dispone di un GUID univoco all'interno del tenant e non può essere modificato.
Ogni dispositivo connesso presenta un singolo prodotto, tuttavia quest'ultimo può essere associato a molti dispositivi. Ogni prodotto ha un nome che deve essere univoco all'interno del tenant, insieme a una descrizione. Il prodotto presenta un nome e una descrizione leggibili dall'utente per distinguere un prodotto dall'altro. Il nome e la descrizione del prodotto possono essere modificati con la frequenza desiderata.
Elencare i prodotti
Elencare tutti i prodotti nel tenant di Azure Sphere usando il comando azsphere product list o l'API pubblica di Azure Sphere.
Per elencare tutti i prodotti:
azsphere product list
È possibile che venga visualizzato un messaggio se il tenant predefinito non è selezionato. Selezionare il tenant richiesto dall'elenco e riprovare a eseguire il comando.
Per elencare tutti i prodotti in un tenant di Azure Sphere:
Selezionare l'icona Esplora Azure Sphere nella barra delle attività di Visual Studio Code per aprire Esplora Azure Sphere. Se nel riquadro Tenant viene visualizzato Accedi per visualizzare i tenant, accedere ad Azure Sphere e selezionare Aggiorna per visualizzare i tenant disponibili.
Espandere il tenant a cui si è interessati.
Espandere il nodo prodotto.
Selezionare Visualizza>altro Esplora Azure>Sphere per aprire Azure Sphere Explorer. Se nel riquadro Tenant viene visualizzato Accedi per visualizzare i tenant, accedere ad Azure Sphere e selezionare Aggiorna per visualizzare i tenant disponibili.
Espandere il tenant a cui si è interessati.
Espandere il nodo prodotto.
Creare un prodotto
Creare un prodotto nel tenant di Azure Sphere usando il comando azsphere product create o l'API pubblica di Azure Sphere.
Per creare un prodotto:
azsphere product create --name <product-name>
Sostituire <product-name> con un nome leggibile per il prodotto, ad esempio DW100. I nomi dei prodotti possono contenere solo caratteri alfanumerici e spazi. Non possono superare i 50 caratteri. Se il nome o la descrizione include spazi, racchiuderlo tra virgolette.
Per impostazione predefinita, quando si crea un nuovo prodotto, Azure Sphere crea automaticamente cinque gruppi di dispositivi da usare per la creazione di distribuzioni. I cinque gruppi di dispositivi predefiniti sono Development, Field Test, Production, Field Test OS Evaluation e Production OS Evaluation. Per creare il prodotto senza i gruppi di dispositivi predefiniti, usare il comando :
- Interfaccia della riga di comando di Azure Sphere
- Interfaccia della riga di comando classica di Azure Sphere
azsphere product create --name <product-name> --no-default-device-groups
Un tenant può contenere molti prodotti, può essere utile fornire una descrizione di ognuno di essi. È possibile aggiungere una descrizione a un prodotto nel modo seguente:
azsphere product create --name <product-name> --description <product-description>
Per creare un prodotto:
Per il tenant a cui si è interessati, fare clic con il pulsante destro del mouse sul nodo Prodotto e scegliere Nuovo prodotto.
Specificare un nome per il prodotto e premere INVIO. I nomi dei prodotti 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 .
Quando si crea un prodotto in Azure Sphere Explorer, i cinque gruppi di dispositivi predefiniti vengono creati automaticamente. Se si vuole creare un prodotto senza gruppi di dispositivi, usare il comando azsphere product create o l'API pubblica di Azure Sphere e specificare --no-default-device-groups.
È possibile creare un prodotto in Azure Sphere Explorer, ma non eliminarlo. Per eliminare i prodotti, usare il comando azsphere product delete o l'API pubblica di Azure Sphere.
Per creare un prodotto:
Per il tenant a cui si è interessati, fare clic con il pulsante destro del mouse sul nodo Prodotto e scegliere Nuovo prodotto.
Specificare un nome per il prodotto e quindi premere INVIO o fare clic su Applica. I nomi dei prodotti 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 .
Quando si crea un prodotto in Azure Sphere Explorer, i cinque gruppi di dispositivi predefiniti vengono creati automaticamente. Se si vuole creare un prodotto senza gruppi di dispositivi, usare il comando azsphere product create o l'API pubblica di Azure Sphere e specificare --no-default-device-groups.
È possibile creare un prodotto in Azure Sphere Explorer, ma non eliminarlo. Per eliminare i prodotti, usare il comando azsphere product delete o l'API pubblica di Azure Sphere.
Aggiornare un prodotto
Modificare il nome o la descrizione di un prodotto in qualsiasi momento usando il comando azsphere product update o usando l'API pubblica di Azure Sphere. Per aggiornare il nome e la descrizione di un prodotto:
- Interfaccia della riga di comando di Azure Sphere
- Interfaccia della riga di comando classica di Azure Sphere
azsphere product update --product <product-name> --new-name <new-product-name> --new-description <new-product-description>
Eliminare un prodotto
Eliminare un prodotto in qualsiasi momento usando il comando azsphere product delete o l'API pubblica di Azure Sphere.
Un prodotto può essere eliminato solo quando:
- L'utente dispone delle autorizzazioni di amministratore per il tenant.
- Il prodotto è vuoto e i gruppi di dispositivi non dispongono di dispositivi in esso contenuti. Il comando azsphere product device list elenca tutti i dispositivi in un prodotto. Eseguire azsphere device update --device-group per spostare il dispositivo in un gruppo di dispositivi diverso o azsphere device-group delete per eliminare un gruppo di dispositivi.
Per eliminare un prodotto:
- Interfaccia della riga di comando di Azure Sphere
- Interfaccia della riga di comando classica di Azure Sphere
azsphere product delete --product <product-name>
Per il tenant a cui si è interessati, espandere il nodo Prodotto.
Per rinominare il prodotto, fare clic con il pulsante destro del mouse sul nome del prodotto e scegliere Rinomina, specificare un nuovo nome di prodotto e quindi premere INVIO.
Per aggiornare la descrizione, fare clic con il pulsante destro del mouse sul nome del prodotto e scegliere Aggiorna descrizione, specificare una nuova descrizione e quindi premere INVIO.
Per il tenant a cui si è interessati, espandere il nodo Prodotto.
Per rinominare il prodotto, selezionare il nome del prodotto e premere F2 o fare clic con il pulsante destro del mouse sul nome del prodotto e scegliere Rinomina, specificare un nuovo nome di prodotto e quindi premere INVIO o fare clic su Applica.
Per aggiornare la descrizione, espandere il prodotto, selezionare Descrizione e premere F2 o fare clic con il pulsante destro del mouse su Descrizione e scegliere Modifica, specificare una nuova descrizione, quindi premere INVIO o fare clic su Applica.
Mostra i dettagli del prodotto
Visualizzare i dettagli di un prodotto nel tenant usando il comando azsphere product show o l'API pubblica di Azure Sphere.
- Interfaccia della riga di comando di Azure Sphere
- Interfaccia della riga di comando classica di Azure Sphere
azsphere product show --product <product-name>
Per visualizzare i dettagli di un prodotto nel tenant:
Selezionare l'icona Esplora Azure Sphere nella barra delle attività di Visual Studio Code per aprire Esplora Azure Sphere. Se nel riquadro Tenant viene visualizzato Accedi per visualizzare i tenant, accedere ad Azure Sphere e selezionare Aggiorna per visualizzare i tenant disponibili.
Per il tenant a cui si è interessati, espandere il nodo Prodotto.
Espandere il prodotto a cui si è interessati.
Selezionare Visualizza>altro Esplora Azure>Sphere per aprire Azure Sphere Explorer. Se nel riquadro Tenant viene visualizzato Accedi per visualizzare i tenant, accedere ad Azure Sphere e selezionare Aggiorna per visualizzare i tenant disponibili.
Per il tenant a cui si è interessati, espandere il nodo Prodotto.
Espandere il prodotto a cui si è interessati.