Gestire i prodotti
Un prodotto identifica una MCU Azure Sphere incorporata in un dispositivo connesso per eseguire una funzione specifica. Il produttore crea un prodotto per ogni modello di un dispositivo connesso, ad esempio lavastoviglie o caffettiera. Ad esempio, Contoso crea un prodotto per le lavastoviglie DW100 e assegna questo prodotto a ogni lavastoviglie DW100 durante la produzione. Ogni prodotto ha un GUID univoco all'interno del tenant e non può essere modificato.
Ogni dispositivo connesso ha un singolo prodotto, ma un singolo prodotto può essere associato a molti dispositivi. Ogni prodotto ha un nome che deve essere univoco all'interno del relativo tenant, insieme a una descrizione. Il nome e la descrizione del prodotto costituiscono un modo leggibile per distinguere un prodotto dall'altro. Il nome e la descrizione del prodotto possono essere modificati ogni volta che si desidera.
Elencare i prodotti
Elencare tutti i prodotti nel tenant Azure Sphere usando il comando elenco di prodotti azsfera o usando l'API pubblica Azure Sphere.
Per elencare tutti i prodotti:
azsphere product list
Se il tenant predefinito non è selezionato, potrebbe essere visualizzato un messaggio. Selezionare il tenant richiesto nell'elenco e riprovare a eseguire il comando.
Per elencare tutti i prodotti in un tenant azure sphere:
Seleziona l'icona Esplora sfere di Azure nella barra attività di Visual Studio Code per aprire Azure Sphere Explorer. Se il riquadro Tenant mostra Accedi per visualizzare i tenant, accedi ad Azure Sphere e seleziona Aggiorna per visualizzare i tenant disponibili.
Espandere il tenant a cui si è interessati.
Espandere il nodo prodotto.
Seleziona Visualizza>altro Esplora sfere di Windows>Azure per aprire Azure Sphere Explorer. Se il riquadro Tenant mostra Accedi per visualizzare i tenant, accedi ad Azure Sphere e seleziona Aggiorna per visualizzare i tenant disponibili.
Espandere il tenant a cui si è interessati.
Espandere il nodo prodotto.
Creare un prodotto
Crea un prodotto nel tuo tenant Azure Sphere usando il comando di creazione del prodotto azsfera o usando l'API pubblica Azure Sphere.
Per creare un prodotto:
azsphere product create --name <product-name>
Sostituire <il nome> del prodotto 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 nella creazione di distribuzioni. I cinque gruppi di dispositivi predefiniti sono Sviluppo, Test campo, Produzione, Valutazione del sistema operativo di test sul campo e Valutazione del sistema operativo di produzione. Per creare il prodotto senza i gruppi di dispositivi predefiniti, utilizzare il comando:
azsphere product create --name <product-name> --no-default-device-groups
Un tenant può contenere molti prodotti, può essere utile fornire una descrizione di ognuno. È 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 sei interessato, fai clic con il pulsante destro del mouse sul nodo Prodotto e seleziona 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 crei un prodotto in Azure Sphere Explorer, vengono creati automaticamente i cinque gruppi di dispositivi predefiniti. Se vuoi creare un prodotto senza gruppi di dispositivi, usa il comando azsfera product create o l'API Pubblica Azure Sphere e specifica --no-default-device-groups.
Puoi creare un prodotto in Azure Sphere Explorer, ma non eliminarlo. Per eliminare i prodotti, usare il comando azsfera per l'eliminazione del prodotto o l'API pubblica Azure Sphere.
Per creare un prodotto:
Per il tenant a cui sei interessato, fai clic con il pulsante destro del mouse sul nodo Prodotto e seleziona 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 crei un prodotto in Azure Sphere Explorer, vengono creati automaticamente i cinque gruppi di dispositivi predefiniti. Se vuoi creare un prodotto senza gruppi di dispositivi, usa il comando azsfera product create o l'API Pubblica Azure Sphere e specifica --no-default-device-groups.
Puoi creare un prodotto in Azure Sphere Explorer, ma non eliminarlo. Per eliminare i prodotti, usare il comando azsfera per l'eliminazione del prodotto o l'API pubblica Azure Sphere.
Aggiornare un prodotto
Modifica il nome o la descrizione di un prodotto in qualsiasi momento usando il comando di aggiornamento del prodotto azsfera o usando l'API pubblica Azure Sphere. Per aggiornare il nome e la descrizione di un prodotto:
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 azsfera per l'eliminazione del prodotto o tramite l'API pubblica Azure Sphere.
Un prodotto può essere eliminato solo quando:
- L'utente ha autorizzazioni di amministratore per il tenant.
- Il prodotto è vuoto e i gruppi di dispositivi non hanno dispositivi al suo interno. Il comando elenco di dispositivi del prodotto azsfera elenca tutti i dispositivi in un prodotto. Esegui l'aggiornamento del dispositivo azsfera-- device-group per spostare il dispositivo in un gruppo di dispositivi o un gruppo azsfera diverso per eliminare un gruppo di dispositivi.
Per eliminare un prodotto:
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 oppure 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 oppure 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 dettagli prodotto
Visualizza i dettagli di un prodotto nel tuo tenant usando il comando di presentazione del prodotto azsfera o usando l'API pubblica Azure Sphere.
azsphere product show --product <product-name>
Per visualizzare i dettagli di un prodotto nel tenant:
Seleziona l'icona Esplora sfere di Azure nella barra attività di Visual Studio Code per aprire Azure Sphere Explorer. Se il riquadro Tenant mostra Accedi per visualizzare i tenant, accedi ad Azure Sphere e seleziona Aggiorna per visualizzare i tenant disponibili.
Per il tenant a cui si è interessati, espandere il nodo Prodotto.
Espandi il prodotto che ti interessa.
Seleziona Visualizza>altro Esplora sfere di Windows>Azure per aprire Azure Sphere Explorer. Se il riquadro Tenant mostra Accedi per visualizzare i tenant, accedi ad Azure Sphere e seleziona Aggiorna per visualizzare i tenant disponibili.
Per il tenant a cui si è interessati, espandere il nodo Prodotto.
Espandi il prodotto che ti interessa.