product, prdproduct, prd

Gestisce i prodotti.Manages products.

OperazioneOperation DescrizioneDescription
createcreate Crea un nuovo prodotto.Creates a new product.
device, devdevice, dev Visualizza i dispositivi in questo prodotto.Displays devices in this product.
device-group, dgdevice-group, dg Gestisce i gruppi di dispositivi del prodotto.Manages product device groups.
listlist Elenca tutti i prodotti del tenant di Azure Sphere.Lists all products in the Azure Sphere tenant.
showshow Visualizza le informazioni dettagliate su un prodotto.Displays details about a product.
updateupdate Aggiorna i metadati specificati.Updates specified metadata.

createcreate

Crea un nuovo prodotto.Creates a new product.

Il comando azsphere product create aggiunge automaticamente cinque gruppi di dispositivi predefiniti al prodotto creato:The azsphere product create command automatically adds five default device groups to the created product:

  • Il gruppo di dispositivi Sviluppo disabilita gli aggiornamenti delle applicazioni cloud e fornisce il sistema operativo retail.Development device group disables cloud application updates and delivers the Retail OS.
  • Il gruppo di dispositivi Test sul campo abilita gli aggiornamenti delle applicazioni cloud e fornisce il sistema operativo per la vendita al dettaglio.Field Test device group enables cloud application updates, and delivers the Retail OS.
  • Il gruppo di dispositivi Produzione abilita gli aggiornamenti delle applicazioni cloud e fornisce il sistema operativo per la vendita al dettaglio.Production device group enables cloud application updates, and delivers the Retail OS.
  • 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.Production OS Evaluation device group enables cloud application updates and delivers the Retail Evaluation OS.
  • 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.Field Test OS Evaluation device group enables cloud application updates and delivers the Retail Evaluation OS.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-n, --name-n, --name stringString Specifica un nome per il prodotto.Specifies a name for the product. Il nome può includere solo caratteri alfanumerici.The name can only include alphanumeric characters. Se il nome include degli spazi, racchiuderlo tra virgolette.If the name includes spaces, enclose it in quotation marks. 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.The product name cannot exceed 50 characters, is case insensitive, and must be unique within a tenant. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-d,--Description-d, --description stringString Specifica il testo facoltativo per descrivere il prodotto.Specifies the optional text to describe the product. La lunghezza massima è di 100 caratteri.The maximum length is 100 characters. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-NDG,--nodefaultdevicegroups-ndg, --nodefaultdevicegroups - Specifica un flag facoltativo che impedisce la creazione dei gruppi di dispositivi predefiniti.Specifies an optional flag that prevents the creation of the default device groups. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-g,--no-default-device-groups-g, --no-default-device-groups - Specifica un flag facoltativo che impedisce la creazione dei gruppi di dispositivi predefiniti.Specifies an optional flag that prevents the creation of the default device groups. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:The following global parameters are available for the Azure Sphere CLI:

ParametroParameter DescrizioneDescription
--debug--debug Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.Increases logging verbosity to show all debug logs. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.
-h, --help-h, --help Stampa le informazioni di riferimento dell'interfaccia della riga di comando sui comandi e i relativi argomenti ed elenca i sottogruppi e i comandi disponibili.Prints CLI reference information about commands and their arguments and lists available subgroups and commands.
--only-show-errors--only-show-errors Mostra solo gli errori, evitando gli avvisi.Shows only errors, suppressing warnings.
-o, --output-o, --output Modifica il formato di output.Changes the output format. I formati di output disponibili sono JSON, jsonc (colori JSON), TSV (valori delimitati da tabulazioni), tabelle (tabelle ASCII leggibili) e YAML.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table.By default the CLI outputs table. Per altre informazioni sui formati di output disponibili, vedere il formato di output per i comandi dell'interfaccia della riga di comando Azure Sphere.To learn more about the available output formats, see Output format for Azure Sphere CLI commands.
--query--query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere servizi di sicurezza.Uses the JMESPath query language to filter the output returned from Azure Sphere Security Services. Per altre informazioni ed esempi, vedere esercitazione su JMESPath ed eseguire query sull'output del comando dell'interfaccia della riga di comandoSee JMESPath tutorial and Query Azure CLI command output for more information and examples.
--verbose--verbose Stampa le informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili.Prints information about resources created in Azure Sphere during an operation and other useful information. Usare --debug per i log di debug completi.Use --debug for full debug logs.

Nota

Se si usa Azure Sphere interfaccia della riga di comando classica, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere classic CLI, see Global parameters for more information on available options.

EsempioExample

azsphere product create --name DW100 --description "Contoso DW100 models"

Created product 'DW100' with ID '6gae21e6-g661-4b01-b935-3c5bf2ba0f72'.
Command completed successfully in 00:00:05.7252534.

device, devdevice, dev

Mostra i dispositivi all'interno di un prodotto.Shows devices within a product.

OperazioneOperation DescrizioneDescription
listlist Visualizza i dispositivi all'interno del prodotto specificato.Displays devices within the specified product.
show-countshow-count Restituisce un conteggio dei dispositivi all'interno del prodotto.Returns a count of devices within the product.

device listdevice list

Visualizza i dispositivi all'interno del prodotto specificato, elencati per ID dispositivo.Displays devices within the specified product, listed by device ID.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ProductID-i, --productid GUIDGUID Specifica l'ID del prodotto per il quale visualizzare i dispositivi.Specifies the ID of the product for which to display devices. Deve essere presente il parametro --productid OPPURE il parametro --productname.Either --productid OR --productname must be present. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-n,--ProductName-n, --productname stringString Specifica il nome del prodotto per il quale visualizzare i dispositivi.Specifies the name of the product for which to display devices. Deve essere presente il parametro --productid OPPURE il parametro --productname.Either --productid OR --productname must be present. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-p,--prodotto-p, --product GUID o nomeGUID or name Specifica il prodotto in cui elencare i dispositivi.Specifies the product in which to list the devices. È possibile specificare l'ID o il nome del prodotto Azure Sphere.You can specify either the ID or name of the Azure Sphere product. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-NI,--non interattivo-ni, --noninteractive - Consente di visualizzare tutti i dispositivi attivando la modalità non interattiva.Displays all devices by turning on non-interactive mode. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-o, --output-o, --output stringString Specifica il percorso del nuovo file CSV che contiene i dati dell'elenco di dispositivi.Specifies the path to the new csv file to contain the device list data. È possibile fornire un percorso relativo o assoluto.You may provide a relative or absolute path. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-si,--showids-si, --showids - Visualizza gli ID dispositivo nei risultati.Displays device IDs in the results. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:The following global parameters are available for the Azure Sphere CLI:

ParametroParameter DescrizioneDescription
--debug--debug Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.Increases logging verbosity to show all debug logs. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.
-h, --help-h, --help Stampa le informazioni di riferimento dell'interfaccia della riga di comando sui comandi e i relativi argomenti ed elenca i sottogruppi e i comandi disponibili.Prints CLI reference information about commands and their arguments and lists available subgroups and commands.
--only-show-errors--only-show-errors Mostra solo gli errori, evitando gli avvisi.Shows only errors, suppressing warnings.
-o, --output-o, --output Modifica il formato di output.Changes the output format. I formati di output disponibili sono JSON, jsonc (colori JSON), TSV (valori delimitati da tabulazioni), tabelle (tabelle ASCII leggibili) e YAML.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table.By default the CLI outputs table. Per altre informazioni sui formati di output disponibili, vedere il formato di output per i comandi dell'interfaccia della riga di comando Azure Sphere.To learn more about the available output formats, see Output format for Azure Sphere CLI commands.
--query--query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere servizi di sicurezza.Uses the JMESPath query language to filter the output returned from Azure Sphere Security Services. Per altre informazioni ed esempi, vedere esercitazione su JMESPath ed eseguire query sull'output del comando dell'interfaccia della riga di comandoSee JMESPath tutorial and Query Azure CLI command output for more information and examples.
--verbose--verbose Stampa le informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili.Prints information about resources created in Azure Sphere during an operation and other useful information. Usare --debug per i log di debug completi.Use --debug for full debug logs.

Nota

Se si usa Azure Sphere interfaccia della riga di comando classica, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere classic CLI, see Global parameters for more information on available options.

EsempioExample

azsphere product device list --productname DW100 --showids
The device(s) in product 'DW100':
Device ID                                                                                                                        Chip SKU Device Group Name Device Group ID
---------                                                                                                                        -------- ----------------- ---------------
352FE1F59EB3A862B0782FC38CB589E4B35E5F307FFE9246299C182DF8EA5C19B241BE2743E46778F738562660F45E0729DC182AEEC39B0743FEB99903D188D0 MT3620AN Development       fb923027-a7be-4bb0-85a1-e5021ce9e4f7
1F01B8B8CBDBA8ED4223F267151CBD59B99A0CED193F2446884F231D925FAFEB9ABDD0550438595658FDDC16723B32DECB5494B7F20D067C1C8B77F6020C9F41 MT3620AN Field Test        0e68f0ff-46d9-42f5-8562-a20b715d3045

device show-countdevice show-count

Restituisce il numero totale dei dispositivi in tutti i gruppi di dispositivi all'interno di un prodotto.Returns the total number of all devices in all device groups within a product.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ProductID-i, --productid GUIDGUID Specifica l'ID del prodotto per il quale visualizzare il numero di dispositivi di destinazione.Specifies the ID of product for which to show the number of targeted devices. --productid --productname È necessario che sia presente o.Either --productid or --productname must be present. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-n,--ProductName-n, --productname stringString Specifica il nome del prodotto per il quale visualizzare il numero di dispositivi di destinazione.Specifies the name of product for which to show the number of targeted devices. --productid --productname È necessario che sia presente o.Either --productid or --productname must be present. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-p,--prodotto-p, --product GUID o nomeGUID or name Specifica il prodotto per il quale visualizzare il numero di dispositivi di destinazione.Specifies the product for which to show the number of targeted devices. È possibile specificare l'ID o il nome del prodotto Azure Sphere.You can specify either the ID or name of the Azure Sphere product. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:The following global parameters are available for the Azure Sphere CLI:

ParametroParameter DescrizioneDescription
--debug--debug Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.Increases logging verbosity to show all debug logs. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.
-h, --help-h, --help Stampa le informazioni di riferimento dell'interfaccia della riga di comando sui comandi e i relativi argomenti ed elenca i sottogruppi e i comandi disponibili.Prints CLI reference information about commands and their arguments and lists available subgroups and commands.
--only-show-errors--only-show-errors Mostra solo gli errori, evitando gli avvisi.Shows only errors, suppressing warnings.
-o, --output-o, --output Modifica il formato di output.Changes the output format. I formati di output disponibili sono JSON, jsonc (colori JSON), TSV (valori delimitati da tabulazioni), tabelle (tabelle ASCII leggibili) e YAML.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table.By default the CLI outputs table. Per altre informazioni sui formati di output disponibili, vedere il formato di output per i comandi dell'interfaccia della riga di comando Azure Sphere.To learn more about the available output formats, see Output format for Azure Sphere CLI commands.
--query--query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere servizi di sicurezza.Uses the JMESPath query language to filter the output returned from Azure Sphere Security Services. Per altre informazioni ed esempi, vedere esercitazione su JMESPath ed eseguire query sull'output del comando dell'interfaccia della riga di comandoSee JMESPath tutorial and Query Azure CLI command output for more information and examples.
--verbose--verbose Stampa le informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili.Prints information about resources created in Azure Sphere during an operation and other useful information. Usare --debug per i log di debug completi.Use --debug for full debug logs.

Nota

Se si usa Azure Sphere interfaccia della riga di comando classica, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere classic CLI, see Global parameters for more information on available options.

EsempioExample

azsphere product device show-count --productname DW100
The current tenant has 2 device(s).

device-group, dgdevice-group, dg

Gestisce i gruppi di dispositivi del prodotto.Manages product device groups.

OperazioneOperation DescrizioneDescription
create-defaultscreate-defaults Crea i gruppi di dispositivi predefiniti all'interno del prodotto specificato.Creates the default device groups within the specified product.
listlist Visualizza i gruppi di dispositivi all'interno del prodotto specificato.Displays device groups within the specified product.

device-group create-defaultsdevice-group create-defaults

Crea i gruppi di dispositivi predefiniti all'interno di un prodotto esistente.Creates the default device groups within an existing product.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ProductID-i, --productid GUIDGUID Specifica l'ID del prodotto per cui creare gruppi di dispositivi predefiniti.Specifies the ID of the product for which to create default device groups. Deve essere presente il parametro --productid OPPURE il parametro --productname.Either --productid OR --productname must be present. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-n,--ProductName-n, --productname stringString Specifica il nome del prodotto per cui creare gruppi di dispositivi predefiniti.Specifies the name of the product for which to create default device groups. Deve essere presente il parametro --productid OPPURE il parametro --productname.Either --productid OR --productname must be present. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-p,--prodotto-p, --product GUID o nomeGUID or name Specifica il prodotto da ottenere.Specifies the product to get. È possibile specificare l'ID o il nome del prodotto Azure Sphere.You can specify either the ID or name of the Azure Sphere product. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

EsempioExample

azsphere product device-group create-defaults --productname DW100
Parametri globaliGlobal parameters

Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:The following global parameters are available for the Azure Sphere CLI:

ParametroParameter DescrizioneDescription
--debug--debug Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.Increases logging verbosity to show all debug logs. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.
-h, --help-h, --help Stampa le informazioni di riferimento dell'interfaccia della riga di comando sui comandi e i relativi argomenti ed elenca i sottogruppi e i comandi disponibili.Prints CLI reference information about commands and their arguments and lists available subgroups and commands.
--only-show-errors--only-show-errors Mostra solo gli errori, evitando gli avvisi.Shows only errors, suppressing warnings.
-o, --output-o, --output Modifica il formato di output.Changes the output format. I formati di output disponibili sono JSON, jsonc (colori JSON), TSV (valori delimitati da tabulazioni), tabelle (tabelle ASCII leggibili) e YAML.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table.By default the CLI outputs table. Per altre informazioni sui formati di output disponibili, vedere il formato di output per i comandi dell'interfaccia della riga di comando Azure Sphere.To learn more about the available output formats, see Output format for Azure Sphere CLI commands.
--query--query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere servizi di sicurezza.Uses the JMESPath query language to filter the output returned from Azure Sphere Security Services. Per altre informazioni ed esempi, vedere esercitazione su JMESPath ed eseguire query sull'output del comando dell'interfaccia della riga di comandoSee JMESPath tutorial and Query Azure CLI command output for more information and examples.
--verbose--verbose Stampa le informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili.Prints information about resources created in Azure Sphere during an operation and other useful information. Usare --debug per i log di debug completi.Use --debug for full debug logs.

Nota

Se si usa Azure Sphere interfaccia della riga di comando classica, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere classic CLI, see Global parameters for more information on available options.

device-group listdevice-group list

Elenca tutti i gruppi di dispositivi in un prodotto.Lists all device groups in a product.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ProductID-i, --productid GUIDGUID Specifica l'ID del prodotto per il quale visualizzare i gruppi di dispositivi.Specifies the ID of the product for which to display device groups. Deve essere presente il parametro --productid OPPURE il parametro --productname.Either --productid OR --productname must be present. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-n,--ProductName-n, --productname stringString Specifica il nome del prodotto per il quale visualizzare i gruppi di dispositivi.Specifies the name of the product for which to display device groups. Deve essere presente il parametro --productid OPPURE il parametro --productname.Either --productid OR --productname must be present. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-p,--prodotto-p, --product GUID o nomeGUID or name Specifica il prodotto per il quale elencare i gruppi di dispositivi.Specifies the product for which to list the device groups. È possibile specificare l'ID o il nome del prodotto Azure Sphere.You can specify either the ID or name of the Azure Sphere product. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:The following global parameters are available for the Azure Sphere CLI:

ParametroParameter DescrizioneDescription
--debug--debug Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.Increases logging verbosity to show all debug logs. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.
-h, --help-h, --help Stampa le informazioni di riferimento dell'interfaccia della riga di comando sui comandi e i relativi argomenti ed elenca i sottogruppi e i comandi disponibili.Prints CLI reference information about commands and their arguments and lists available subgroups and commands.
--only-show-errors--only-show-errors Mostra solo gli errori, evitando gli avvisi.Shows only errors, suppressing warnings.
-o, --output-o, --output Modifica il formato di output.Changes the output format. I formati di output disponibili sono JSON, jsonc (colori JSON), TSV (valori delimitati da tabulazioni), tabelle (tabelle ASCII leggibili) e YAML.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table.By default the CLI outputs table. Per altre informazioni sui formati di output disponibili, vedere il formato di output per i comandi dell'interfaccia della riga di comando Azure Sphere.To learn more about the available output formats, see Output format for Azure Sphere CLI commands.
--query--query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere servizi di sicurezza.Uses the JMESPath query language to filter the output returned from Azure Sphere Security Services. Per altre informazioni ed esempi, vedere esercitazione su JMESPath ed eseguire query sull'output del comando dell'interfaccia della riga di comandoSee JMESPath tutorial and Query Azure CLI command output for more information and examples.
--verbose--verbose Stampa le informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili.Prints information about resources created in Azure Sphere during an operation and other useful information. Usare --debug per i log di debug completi.Use --debug for full debug logs.

Nota

Se si usa Azure Sphere interfaccia della riga di comando classica, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere classic CLI, see Global parameters for more information on available options.

EsempioExample

azsphere product device-group list --productname DW100
Getting device groups for product 'DW100'.
Product 'DW100' has 7 device group(s):
ID                                   Name
--                                   ----
a8cef916-a830-4c4b-9276-cf12b0478077 Devicegrouptest
e5d3ce3d-21fe-4676-ab80-1cd54be2cf26 Field Test
e05390cc-8b82-4ecc-b665-e5fa5628e4fb Production
d96bd76f-22aa-4565-934d-6439c816f39d Production OS Evaluation
f0fac6d0-4d82-4ebc-8836-47b81e11a260 Field Test OS Evaluation
2c633108-9947-47e9-a089-c8484a1beaa4 Marketing
2ce8e492-8e71-4194-b35e-31ddaf55b844 Development

listlist

Elenca tutti i prodotti del tenant di Azure Sphere.Lists all products in the Azure Sphere tenant.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:The following global parameters are available for the Azure Sphere CLI:

ParametroParameter DescrizioneDescription
--debug--debug Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.Increases logging verbosity to show all debug logs. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.
-h, --help-h, --help Stampa le informazioni di riferimento dell'interfaccia della riga di comando sui comandi e i relativi argomenti ed elenca i sottogruppi e i comandi disponibili.Prints CLI reference information about commands and their arguments and lists available subgroups and commands.
--only-show-errors--only-show-errors Mostra solo gli errori, evitando gli avvisi.Shows only errors, suppressing warnings.
-o, --output-o, --output Modifica il formato di output.Changes the output format. I formati di output disponibili sono JSON, jsonc (colori JSON), TSV (valori delimitati da tabulazioni), tabelle (tabelle ASCII leggibili) e YAML.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table.By default the CLI outputs table. Per altre informazioni sui formati di output disponibili, vedere il formato di output per i comandi dell'interfaccia della riga di comando Azure Sphere.To learn more about the available output formats, see Output format for Azure Sphere CLI commands.
--query--query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere servizi di sicurezza.Uses the JMESPath query language to filter the output returned from Azure Sphere Security Services. Per altre informazioni ed esempi, vedere esercitazione su JMESPath ed eseguire query sull'output del comando dell'interfaccia della riga di comandoSee JMESPath tutorial and Query Azure CLI command output for more information and examples.
--verbose--verbose Stampa le informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili.Prints information about resources created in Azure Sphere during an operation and other useful information. Usare --debug per i log di debug completi.Use --debug for full debug logs.

Nota

Se si usa Azure Sphere interfaccia della riga di comando classica, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere classic CLI, see Global parameters for more information on available options.

EsempioExample

azsphere product list
The current tenant has 2 product(s):
ID                                   Name
--                                   ----
6gae21e6-g661-4b01-b935-3c5bf2ba0f72 DW100
6a82518f-8965-4bd6-ba79-43aa3fcafe5e DW200

showshow

Visualizza le informazioni dettagliate su un prodotto.Displays details about a product.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ProductID-i, --productid GUIDGUID Specifica l'ID del prodotto per cui visualizzare i dettagli.Specifies the ID of the product for which to display details. Deve essere presente il parametro --productid OPPURE il parametro --productname.Either --productid OR --productname must be present. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-n,--ProductName-n, --productname stringString Specifica il nome del prodotto per cui visualizzare i dettagli.Specifies the name of the product for which to display details. Deve essere presente il parametro --productid OPPURE il parametro --productname.Either --productid OR --productname must be present. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-p,--prodotto-p, --product GUID o nomeGUID or name Specifica il prodotto da ottenere.Specifies the product to get. È possibile specificare l'ID o il nome del prodotto Azure Sphere.You can specify either the ID or name of the Azure Sphere product. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:The following global parameters are available for the Azure Sphere CLI:

ParametroParameter DescrizioneDescription
--debug--debug Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.Increases logging verbosity to show all debug logs. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.
-h, --help-h, --help Stampa le informazioni di riferimento dell'interfaccia della riga di comando sui comandi e i relativi argomenti ed elenca i sottogruppi e i comandi disponibili.Prints CLI reference information about commands and their arguments and lists available subgroups and commands.
--only-show-errors--only-show-errors Mostra solo gli errori, evitando gli avvisi.Shows only errors, suppressing warnings.
-o, --output-o, --output Modifica il formato di output.Changes the output format. I formati di output disponibili sono JSON, jsonc (colori JSON), TSV (valori delimitati da tabulazioni), tabelle (tabelle ASCII leggibili) e YAML.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table.By default the CLI outputs table. Per altre informazioni sui formati di output disponibili, vedere il formato di output per i comandi dell'interfaccia della riga di comando Azure Sphere.To learn more about the available output formats, see Output format for Azure Sphere CLI commands.
--query--query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere servizi di sicurezza.Uses the JMESPath query language to filter the output returned from Azure Sphere Security Services. Per altre informazioni ed esempi, vedere esercitazione su JMESPath ed eseguire query sull'output del comando dell'interfaccia della riga di comandoSee JMESPath tutorial and Query Azure CLI command output for more information and examples.
--verbose--verbose Stampa le informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili.Prints information about resources created in Azure Sphere during an operation and other useful information. Usare --debug per i log di debug completi.Use --debug for full debug logs.

Nota

Se si usa Azure Sphere interfaccia della riga di comando classica, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere classic CLI, see Global parameters for more information on available options.

EsempioExample

azsphere product show --productid 6gae21e6-g661-4b01-b935-3c5bf2ba0f72
Getting details for product '6gae21e6-g661-4b01-b935-3c5bf2ba0f72'.
Retrieved product:
   ID:          6gae21e6-g661-4b01-b935-3c5bf2ba0f72
   Name:        'DW100'
   Description: 'Contoso DW100 models'

updateupdate

Aggiorna i metadati del prodotto specificato.Updates specified product metadata.

È necessario specificare almeno un parametro facoltativo tra --newname o --newdescription.At least one optional parameter must be provided, either --newname or --newdescription. Entrambi possono essere specificati in un unico comando.Both can be specified in a single command.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ProductID-i, --productid GUIDGUID Specifica l'ID del prodotto da aggiornare.Specifies the ID of the product to update. Deve essere presente il parametro --productid OPPURE il parametro --productname.Either --productid OR --productname must be present. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-n,--ProductName-n, --productname stringString Specifica il nome del prodotto da aggiornare.Specifies the name of the product to update. Deve essere presente il parametro --productid OPPURE il parametro --productname.Either --productid OR --productname must be present. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-p,--prodotto-p, --product GUID o nomeGUID or name Specifica il prodotto da aggiornare.Specifies the product to update. È possibile specificare l'ID o il nome del prodotto Azure Sphere.You can specify either the ID or name of the Azure Sphere product. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-nn,--NewName-nn, --newname stringString Specifica un nuovo nome per il prodotto.Specifies a new name for the product. Il nome può includere solo caratteri alfanumerici.The name can only include alphanumeric characters. Se il nome include degli spazi, racchiuderlo tra virgolette.If the name includes spaces, enclose it in quotation marks. 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.The product name cannot exceed 50 characters, are case insensitive, and must be unique within a tenant. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ND,--NewDescription-nd, --newdescription stringString Specifica il testo facoltativo per descrivere il prodotto.Specifies optional text to describe the product. La lunghezza massima è di 100 caratteri.The maximum length is 100 characters. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-n,--New-Name-n, --new-name stringString Specifica un nuovo nome per il prodotto.Specifies a new name for the product. Il nome può includere solo caratteri alfanumerici.The name can only include alphanumeric characters. Se il nome include degli spazi, racchiuderlo tra virgolette.If the name includes spaces, enclose it in quotation marks. 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.The product name cannot exceed 50 characters, is case insensitive, and must be unique within a tenant. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-d,--New-Description-d, --new-description stringString Specifica il testo facoltativo per descrivere il prodotto.Specifies optional text to describe the product. La lunghezza massima è di 100 caratteri.The maximum length is 100 characters. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-t,--tenant-t, --tenant stringString Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:The following global parameters are available for the Azure Sphere CLI:

ParametroParameter DescrizioneDescription
--debug--debug Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.Increases logging verbosity to show all debug logs. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.
-h, --help-h, --help Stampa le informazioni di riferimento dell'interfaccia della riga di comando sui comandi e i relativi argomenti ed elenca i sottogruppi e i comandi disponibili.Prints CLI reference information about commands and their arguments and lists available subgroups and commands.
--only-show-errors--only-show-errors Mostra solo gli errori, evitando gli avvisi.Shows only errors, suppressing warnings.
-o, --output-o, --output Modifica il formato di output.Changes the output format. I formati di output disponibili sono JSON, jsonc (colori JSON), TSV (valori delimitati da tabulazioni), tabelle (tabelle ASCII leggibili) e YAML.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table.By default the CLI outputs table. Per altre informazioni sui formati di output disponibili, vedere il formato di output per i comandi dell'interfaccia della riga di comando Azure Sphere.To learn more about the available output formats, see Output format for Azure Sphere CLI commands.
--query--query Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere servizi di sicurezza.Uses the JMESPath query language to filter the output returned from Azure Sphere Security Services. Per altre informazioni ed esempi, vedere esercitazione su JMESPath ed eseguire query sull'output del comando dell'interfaccia della riga di comandoSee JMESPath tutorial and Query Azure CLI command output for more information and examples.
--verbose--verbose Stampa le informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili.Prints information about resources created in Azure Sphere during an operation and other useful information. Usare --debug per i log di debug completi.Use --debug for full debug logs.

Nota

Se si usa Azure Sphere interfaccia della riga di comando classica, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere classic CLI, see Global parameters for more information on available options.

EsempioExample

azsphere product update --productid DW100 --newname DW100Product --newdescription 'Contoso DW100 models'