product
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).
Gestisce i prodotti.
| Operazione | Descrizione |
|---|---|
| create | Crea un nuovo prodotto. |
| delete | Elimina un prodotto esistente. |
| device | Visualizza i dispositivi in questo prodotto. |
| device-group | Gestisce i gruppi di dispositivi del prodotto. |
| list | Elenca tutti i prodotti del tenant di Azure Sphere. |
| show | Visualizza le informazioni dettagliate su un prodotto. |
| update | Aggiorna i metadati specificati. |
create
Crea un nuovo prodotto.
Il comando azsphere product create aggiunge automaticamente cinque gruppi di dispositivi predefiniti al prodotto creato:
- Il gruppo di dispositivi Sviluppo disabilita gli aggiornamenti delle applicazioni cloud e fornisce il sistema operativo retail.
- Il gruppo di dispositivi Field Test abilita gli aggiornamenti delle applicazioni cloud e distribuisce il sistema operativo retail.
- Il gruppo di dispositivi di produzione abilita gli aggiornamenti delle applicazioni cloud e distribuisce il sistema operativo retail.
- Il gruppo di dispositivi Valutazione del sistema operativo di produzione abilita gli aggiornamenti delle applicazioni cloud e fornisce il sistema operativo per la valutazione per la vendita al dettaglio.
- Il gruppo di dispositivi Valutazione del sistema operativo per test sul campo abilita gli aggiornamenti delle applicazioni cloud e fornisce il sistema operativo per la valutazione per la vendita al dettaglio.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -n,--name | String | Specifica un nome per il prodotto. Il nome può includere solo caratteri alfanumerici. Se il nome include degli spazi, racchiuderlo tra virgolette. Il nome del prodotto non può superare i 50 caratteri, non fa distinzione tra maiuscole e minuscole e deve essere univoco all'interno di un tenant. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -g, --no-default-device-groups | Booleano | Specifica un flag facoltativo che impedisce la creazione dei gruppi di dispositivi predefiniti. |
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
| -d, --description | String | Specifica il testo facoltativo per descrivere il prodotto. La lunghezza massima consentita è di 100 caratteri. Se la descrizione include spazi, racchiuderla tra virgolette. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
azsphere product create --name DW100 --description "Contoso DW100 models"
Default device groups will been created for this product, use the 'azsphere product device-group list' command to see them.
------------------------------------ -------------------- ----- ------------------------------------
TenantId Description Name Id
====================================================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb Contoso DW100 models DW100 6f52bead-700d-4289-bdc2-2f11f774270e
------------------------------------ -------------------- ----- ------------------------------------
eliminare
Elimina il prodotto specificato nel tenant 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.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -p, --product | GUID o nome | Specifica il prodotto da eliminare. È possibile specificare l'ID o il nome del prodotto Azure Sphere. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
Esempio per specificare il prodotto in base all'ID:
azsphere product delete --product 6f52bead-700d-4289-bdc2-2f11f774270e
Esempio per specificare il prodotto in base al nome:
azsphere product delete --product DW100
Verrà visualizzato un output simile al seguente:
Successfully deleted the product
dispositivo
Mostra i dispositivi all'interno di un prodotto.
| Operazione | Descrizione |
|---|---|
| list | Visualizza i dispositivi all'interno del prodotto specificato. |
| show-count | Restituisce un conteggio dei dispositivi all'interno del prodotto. |
device list
Visualizza i dispositivi all'interno del prodotto specificato, elencati per ID dispositivo.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -p, --product | GUID o nome | Specifica il prodotto in cui elencare i dispositivi. È possibile specificare l'ID o il nome del prodotto Azure Sphere. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
Esempio per specificare il prodotto in base all'ID:
azsphere product device list --product 6f52bead-700d-4289-bdc2-2f11f774270e
Esempio per specificare il prodotto in base al nome:
azsphere product device list --product DW100
Verrà visualizzato un output simile al seguente:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===============================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ------------------------------------
device show-count
Restituisce il numero totale dei dispositivi in tutti i gruppi di dispositivi all'interno di un prodotto.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -p, --product | GUID o nome | Specifica il prodotto per il quale viene visualizzato il numero di dispositivi di destinazione. È possibile specificare l'ID o il nome del prodotto Azure Sphere. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
Esempio per specificare il prodotto in base all'ID:
azsphere product device show-count --product 6f52bead-700d-4289-bdc2-2f11f774270e
Esempio per specificare il prodotto in base al nome:
azsphere product device show-count --product DW100
Verrà visualizzato un output simile al seguente:
------
Result
======
2
------
device-group
Gestisce i gruppi di dispositivi del prodotto.
| Operazione | Descrizione |
|---|---|
| create-defaults | Crea i gruppi di dispositivi predefiniti all'interno del prodotto specificato. |
| list | Visualizza i gruppi di dispositivi all'interno del prodotto specificato. |
device-group create-defaults
Crea i gruppi di dispositivi predefiniti all'interno di un prodotto esistente.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -p, --product | GUID o nome | Specifica il prodotto da ottenere. È possibile specificare l'ID o il nome del prodotto Azure Sphere. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
Esempio per specificare il prodotto in base all'ID:
azsphere product device-group create-defaults --product 6f52bead-700d-4289-bdc2-2f11f774270e
Esempio per specificare il prodotto in base al nome:
azsphere product device-group create-defaults --product DW100
Verrà visualizzato un output simile al seguente:
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- -------------------------
Id Name Description ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
=====================================================================================================================================================================================================================================================================================
6406868c-19bb-4bea-b4cf-fd80608ee5cb Development Default development device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail Accept only system software updates. Don't accept application updates. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
d2e2b2e7-e219-4af8-8876-f8d10624778b Field Test Default test device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
822f1bda-32d7-404a-bf37-9f90aad09509 Production Default production device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
3fafc0e1-f336-4a8a-9be4-fb275322d2cc Production OS Evaluation Default Production OS Evaluation device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
b9b7f388-2ad4-4a7e-a4dc-6559fb80741d Field Test OS Evaluation Default Field Test OS Evaluation device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
device-group list
Elenca tutti i gruppi di dispositivi in un prodotto.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -p, --product | GUID o nome | Specifica il prodotto per cui elencare i gruppi di dispositivi. È possibile specificare l'ID o il nome del prodotto Azure Sphere. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
Esempio per specificare il prodotto in base all'ID:
azsphere product device-group list --product 6f52bead-700d-4289-bdc2-2f11f774270e
Esempio per specificare il prodotto in base al nome:
azsphere product device-group list --product DW100
Verrà visualizzato un output simile al seguente:
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- -------------------------
Id TenantId OsFeedType ProductId Name Description UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
==========================================================================================================================================================================================================================================================================================================================
6406868c-19bb-4bea-b4cf-fd80608ee5cb 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 4f48d618-09f7-45dc-a5a4-1433cabbee91 Development Default development device group Accept only system software updates. Don't accept application updates. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
d2e2b2e7-e219-4af8-8876-f8d10624778b 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 4f48d618-09f7-45dc-a5a4-1433cabbee91 Field Test Default test device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
822f1bda-32d7-404a-bf37-9f90aad09509 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 4f48d618-09f7-45dc-a5a4-1433cabbee91 Production Default production device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
a6c64cda-4ff0-48bb-8a30-6ffab322b846 143adbc9-1bf0-4be2-84a2-084a331d81cb RetailEval 4f48d618-09f7-45dc-a5a4-1433cabbee91 Production OS Evaluation Default Production OS Evaluation device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
3fafc0e1-f336-4a8a-9be4-fb275322d2cc 143adbc9-1bf0-4be2-84a2-084a331d81cb RetailEval 4f48d618-09f7-45dc-a5a4-1433cabbee91 Field Test OS Evaluation Default Field Test OS Evaluation device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
b9b7f388-2ad4-4a7e-a4dc-6559fb80741d 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 4f48d618-09f7-45dc-a5a4-1433cabbee91 Marketing Default Marketing device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
list
Elenca tutti i prodotti del tenant di Azure Sphere.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
azsphere product list
------------------------------------ ------------------------------------ --------- --------------------
Id TenantId Name Description
========================================================================================================
6f52bead-700d-4289-bdc2-2f11f774270e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW100 Contoso DW100 models
------------------------------------ ------------------------------------ --------- --------------------
6a82518f-8965-4bd6-ba79-43aa3fcafe5e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW200 Contoso DW200 models
------------------------------------ ------------------------------------ --------- --------------------
show
Visualizza le informazioni dettagliate su un prodotto.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -p, --product | GUID o nome | Specifica il prodotto da ottenere. È possibile specificare l'ID o il nome del prodotto Azure Sphere. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
Esempio per specificare il prodotto e il tenant in base all'ID:
azsphere product show --product 6f52bead-700d-4289-bdc2-2f11f774270e --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
Esempio per specificare il prodotto e il tenant in base al nome:
azsphere product show --product DW100 --tenant MyTenant
Verrà visualizzato un output simile al seguente:
------------------------------------ ------------------------------------ ----- --------------------
Id TenantId Name Description
====================================================================================================
6f52bead-700d-4289-bdc2-2f11f774270e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW100 Contoso DW100 models
------------------------------------ ------------------------------------ ----- --------------------
update
Aggiorna i metadati del prodotto specificato.
È necessario specificare almeno un parametro facoltativo, --newname o --newdescription. Entrambi possono essere specificati in un unico comando.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -p, --product | GUID o nome | Specifica il prodotto da aggiornare. È possibile specificare l'ID o il nome del prodotto Azure Sphere. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -n, --new-name | String | Specifica un nuovo nome per il prodotto. Il nome può includere solo caratteri alfanumerici. Se il nome include degli spazi, racchiuderlo tra virgolette. Il nome del prodotto non può superare i 50 caratteri, non fa distinzione tra maiuscole e minuscole e deve essere univoco all'interno di un tenant. |
| -d, --new-description | String | Specifica il testo facoltativo per descrivere il prodotto. La lunghezza massima consentita è di 100 caratteri. |
| -t, --tenant | String | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
Esempio per specificare il prodotto in base all'ID:
azsphere product update --product 6f52bead-700d-4289-bdc2-2f11f774270e --new-description Contoso DW100 models
Esempio per specificare il prodotto in base al nome:
azsphere product update --product DW100 --new-description Contoso DW100 models
Verrà visualizzato un output simile al seguente:
------------------------------------ ------------------------------------ ----- ------------------
Id TenantId Name Description
==================================================================================================
6a82518f-8965-4bd6-ba79-43aa3fcafe5e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW200 Contoso DW200 models
------------------------------------ ------------------------------------ ----- ------------------