device-group, dgdevice-group, dg

Crea e gestisce i gruppi di dispositivi.Creates and manages device groups.

I gruppi di dispositivi vengono indirizzati in base all'identificatore (ID) o alla coppia nome prodotto e nome gruppo di dispositivi.Device groups are addressed either by identifier (ID) or by a product name and device group name pair.

OperazioneOperation DescrizioneDescription
createcreate Crea un nuovo gruppo di dispositivi.Creates a new device group.
listlist Elencare tutti i gruppi di dispositivi nel tenant di Azure Sphere.List all device groups in your Azure Sphere tenant.
distribuzionedeployment Gestisce le distribuzioni all'interno di un gruppo di dispositivi.Manages deployments within a device group.
dispositivodevice Elenca i dispositivi in un gruppo di dispositivi.Lists devices in a device group.
showshow Visualizza informazioni su un gruppo di dispositivi.Displays information about a device group.
updateupdate Modifica un gruppo di dispositivi esistente.Modifies an existing device group.

createcreate

Crea un gruppo di dispositivi con il nome specificato per il prodotto specificato.Creates a device group with the specified name for the specified product. Il gruppo di dispositivi organizza i dispositivi che hanno lo stesso prodotto e ricevono le stesse applicazioni dal cloud.The device group organizes devices that have the same product and receive the same applications from the cloud.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-n, --name-n, --name stringString Specifica un nome per il gruppo di dispositivi.Specifies a name for the device group. 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 gruppo di dispositivi non può superare i 50 caratteri, non fa distinzione tra maiuscole e minuscole. deve essere univoco all'interno del prodotto.The device group name cannot exceed 50 characters, is case insensitive, must be unique within the product. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-PI,--ProductID-pi, --productid GUIDGUID Specifica l'ID del prodotto Azure Sphere per il quale creare un gruppo di dispositivi.Specifies the ID of the Azure Sphere product for which to create a device group. --productname o --productid è obbligatorio.Either --productname or --productid is required. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-PN,--ProductName-pn, --productname stringString Specifica il nome del prodotto Azure Sphere per il quale creare un gruppo di dispositivi.Specifies the name of the Azure Sphere product for which to create a device group. --productname o --productid è obbligatorio.Either --productname or --productid is required. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-p,--prodotto-p, --product GUID o nomeGUID or name Specifica il prodotto a cui aggiungere questo gruppo di dispositivi.Specifies the product to add this device group to. È 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 DescrizioneDescription
-d,--Description-d, --description stringString Specifica il testo facoltativo per descrivere il gruppo di dispositivi.Specifies the optional text to describe the device group. 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
-a,--applicationupdate-a, --applicationupdate On\OffOn\Off Disabilita o abilita gli aggiornamenti dell'applicazione per questo gruppo di dispositivi.Disables or enables application updates for this device group. Si tratta di un'opzione binaria: on significa che gli aggiornamenti dell'applicazione sono abilitati, off indica che gli aggiornamenti dell'applicazione sono disabilitati.This is a binary option: On means that application updates are enabled, Off indicates application updates are disabled. Il valore predefinito è On.Default is On. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-o, --osfeed -o, --osfeed EnumerazioneEnum Specifica il tipo di feed del sistema operativo da usare per gli aggiornamenti del sistema operativo.Specifies the OS feed type to use for OS updates. Valori accettati: Retail , RetailEval .Accepted values: Retail, RetailEval. Il valore predefinito è Retail.Default is Retail. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-a,--applicazione-aggiornamento-a, --application-update EnumerazioneEnum Specifica i criteri di aggiornamento dell'applicazione da applicare per il gruppo di dispositivi.Specifies the application update policy to apply for this device group. Valori accettati: No3rdPartyAppUpdates , NoUpdates , UpdateAll .Accepted values: No3rdPartyAppUpdates, NoUpdates, UpdateAll. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-f,--OS-feed-f, --os-feed EnumerazioneEnum Specifica il tipo di feed del sistema operativo da usare per gli aggiornamenti del sistema operativo.Specifies the OS feed type to use for OS updates. Valori accettati: Retail , RetailEval .Accepted values: Retail, RetailEval. 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

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

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

EsempioExample

azsphere device-group create --name marketing --productname DW100
Creating device group 'marketing'.
Successfully created device group 'marketing' with ID '0e78m0mm-47d9-42m5-8572-a20b315d8045',
  and update policy: Accept all updates from the Azure Sphere Security Service.

listlist

Elencare tutti i gruppi di dispositivi nel tenant di Azure Sphere.List all device groups in your Azure Sphere tenant.

Nota

Questo comando non è disponibile in Azure Sphere CLI V1.This command is not available in Azure Sphere CLI v1.

Parametri facoltativiOptional parameters

ParametroParameter DescrizioneDescription
-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

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

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

EsempioExample

Questo comando non è disponibile in Azure Sphere CLI V1.This command is not available in Azure Sphere CLI v1.

distribuzione, DEPdeployment, dep

Gestisce le distribuzioni per un gruppo di dispositivi.Manages deployments for a device group.

OperazioneOperation DescrizioneDescription
createcreate Crea una nuova distribuzione per il gruppo di dispositivi specificato.Creates a new deployment for the specified device group.
listlist Visualizza le distribuzioni per un gruppo di dispositivi.Displays the deployments for a device group.

deployment createdeployment create

Crea una nuova distribuzione per un gruppo di dispositivi con le immagini fornite.Creates a new deployment for a device group with the supplied image(s).

È possibile identificare il gruppo di dispositivi in base all'identificatore (ID) o alla coppia nome prodotto e nome gruppo di dispositivi.You can identify the device group either by identifier (ID) or by a product name and device group name pair.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--devicegroupid-i, --devicegroupid GUIDGUID Specifica l'ID del gruppo di dispositivi in cui creare la distribuzione.Specifies the ID of the device group in which to create the deployment. --devicegroupid --devicegroupname È necessario specificare o e --productname .Either --devicegroupid or --devicegroupname and --productname is required. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-DGN,--nomegruppodispositivi-dgn, --devicegroupname stringString Specifica il nome del gruppo di dispositivi in cui creare la distribuzione.Specifies the name of the device group in which to create the deployment. --devicegroupname --productname È necessario specificare e, o --devicegroupid .Either --devicegroupname and --productname, or --devicegroupid is required. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e del gruppo di dispositivi nel formato seguente: --productname <product-name> --devicegroupname <device-group-name> .To use the device group name, you must specify both the product and device group name in the following format, --productname <product-name> --devicegroupname <device-group-name>. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-g,--Device-Group-g, --device-group stringString Specifica il gruppo di dispositivi in cui creare la distribuzione.Specifies the device group in which to create the deployment. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi.You can specify either the device group ID or the device group name. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e il nome del gruppo di dispositivi nel <product-name/device-group-name> formato.To use the device group name, you must provide both the product name and device group name in the <product-name/device-group-name> format. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
--immagini--images stringString Specifica gli ID immagine per una o più immagini da includere nella distribuzione.Specifies the image IDs for one or more images to include in the deployment. È possibile aggiungere più immagini aggiungendo parametri aggiuntivi oppure più ID immagine possono essere combinati in un singolo parametro in un elenco di spazi separati.You can add multiple images by adding additional parameters, or multiple image IDs can be combined in a single parameter in a space separated list. Eseguire il comando azsphere Image Add per ottenere l'ID immagine.Run the azsphere image add command to get the image ID. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-f, --force-f, --force - Forza il caricamento di un'immagine che usa un'API beta.Forces the upload of an image that uses a beta API. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-p,--FilePath-p, --filepath stringString Specifica i percorsi dei file di una o più immagini da includere nella distribuzione.Specifies the file paths to one or more images to include in the deployment. È possibile fornire un percorso relativo o assoluto.You may provide a relative or absolute path. È possibile aggiungere più immagini aggiungendo parametri aggiuntivi oppure è possibile combinare più percorsi in un singolo parametro in un elenco delimitato da virgole.You can add multiple images by adding additional parameters, or multiple paths can be combined in a single parameter in a comma-separated list. --filepath --imageid È necessario che sia presente o.Either --filepath or --imageid must be present. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-II,--ImageId-ii, --imageid stringString Specifica gli ID immagine per una o più immagini da includere nella distribuzione.Specifies the image IDs for one or more images to include in the deployment. È possibile aggiungere più immagini aggiungendo parametri aggiuntivi oppure è possibile combinare più ID immagine in un singolo parametro in un elenco delimitato da virgole.You can add multiple images by adding additional parameters, or multiple image IDs can be combined in a single parameter in a comma-separated list. --imageid --filepath È necessario che sia presente o.Either --imageid or --filepath must be present. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-PN,--ProductName-pn, --productname stringString Specifica il nome del prodotto.Specifies the name of the product. --devicegroupid --devicegroupname È necessario specificare o e --productname .Either --devicegroupid or --devicegroupname and --productname is required. 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

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

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

EsempioExample

azsphere device-group deployment create --devicegroupname marketing --productname DW100 --filepath "c:\image-file\DW100-image"

deployment listdeployment list

Visualizza la cronologia delle distribuzioni per un gruppo di dispositivi.Displays the deployment history for a device group. Restituisce l'ID della distribuzione, il timestamp e l'elenco delle immagini incluse.Returns the deployment ID, timestamp, and list of included images. L'elenco è ordinato in base alle distribuzioni più recenti.The list is ordered by most recent deployments.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--devicegroupid-i, --devicegroupid GUIDGUID Specifica l'ID del gruppo di dispositivi per il quale visualizzare l'elenco della cronologia di distribuzione.Specifies the ID of the device group for which to display the deployment history list. --devicegroupid --devicegroupname È necessario specificare o e --productname .Either --devicegroupid or --devicegroupname and --productname is required. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-DGN,--nomegruppodispositivi-dgn, --devicegroupname stringString Specifica il nome del gruppo di dispositivi per il quale visualizzare l'elenco della cronologia di distribuzione.Specifies the name of the device group for which to display the deployment history list. --devicegroupname --productname È necessario specificare e, o --devicegroupid .Either --devicegroupname and --productname, or --devicegroupid is required. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e del gruppo di dispositivi nel formato seguente: --productname <product-name> --devicegroupname <device-group-name> .To use the device group name, you must specify both the product and device group name in the following format, --productname <product-name> --devicegroupname <device-group-name>. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-g,--Device-Group-g, --device-group stringString Specifica il gruppo di dispositivi per il quale visualizzare l'elenco della cronologia di distribuzione.Specifies the device group for which to display the deployment history list. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi.You can specify either the device group ID or the device group name. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e il nome del gruppo di dispositivi nel <product-name/device-group-name> formato.To use the device group name, you must provide both the product name and device group name in the <product-name/device-group-name> format. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-PN,--ProductName-pn, --productname stringString Specifica il nome del prodotto.Specifies the name of the product. È necessario specificare --devicegroupname e --productname oppure --devicegroupid.Either --devicegroupname and --productname, or --devicegroupid is required. 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

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

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

EsempioExample

azsphere device-group deployment list --devicegroupname Marketing --productname DW100
Getting device group 'Marketing' for product 'DW100'.
Device group 'Marketing' for product 'DW100' has 1 deployment(s):
ID                                   Deployed Time (UTC) Deployed Images
--                                   ------------------- ---------------
ff5260e2-b6c7-4b3d-b359-c3382eee5986 18/11/2020 19:46:50 [e3769536-dc4b-48d9-afd4-22ed321ba4bc]

device, devdevice, dev

Gestisce i dispositivi per un gruppo di dispositivi.Manages devices for a device group.

OperazioneOperation DescrizioneDescription
listlist Visualizza i dispositivi in un gruppo di dispositivi.Displays the devices in a device group.
show-countshow-count Indica il numero di dispositivi in un gruppo di dispositivi.Shows the number of devices in a device group.

device listdevice list

Visualizza i dispositivi in un gruppo di dispositivi.Displays the devices in a device group.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--devicegroupid-i, --devicegroupid GUIDGUID Specifica l'ID del gruppo di dispositivi per il quale visualizzare l'elenco dei dispositivi.Specifies the ID of the device group for which to display the device list. --devicegroupid --devicegroupname È necessario specificare o e --productname .Either --devicegroupid or --devicegroupname and --productname is required. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-DGN,--nomegruppodispositivi-dgn, --devicegroupname stringString Specifica il nome del gruppo di dispositivi per il quale visualizzare l'elenco dei dispositivi.Specifies the name of the device group for which to display the device list. --devicegroupname --productname È necessario specificare e, o --devicegroupid .Either --devicegroupname and --productname, or --devicegroupid is required. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e del gruppo di dispositivi nel formato seguente: --productname <product-name> --devicegroupname <device-group-name> .To use the device group name, you must specify both the product and device group name in the following format, --productname <product-name> --devicegroupname <device-group-name>. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-g,--Device-Group-g, --device-group stringString Specifica il gruppo di dispositivi per il quale visualizzare l'elenco dei dispositivi.Specifies the device group for which to display the device list. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi.You can specify either the device group ID or the device group name. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e il nome del gruppo di dispositivi nel <product-name/device-group-name> formato.To use the device group name, you must provide both the product name and device group name in the <product-name/device-group-name> format. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-o, --output-o, --output stringString Specifica il percorso e il nome file per l'esportazione dei risultati dell'elenco.Specifies the location and filename for exporting the list results. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-NI,--non interattivo-ni, --noninteractive - Specifica se l'elenco continuerà automaticamente dopo ogni pagina di risultati.Specifies if the list will automatically continue after each page of results. Questo parametro è utile per l'automazione e per il piping dei risultati in un file con estensione CSV.This parameter is useful for automation and for piping results to a .csv file. Usare con--output per salvare i risultati in un file.Use with --output to save results to a file. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-PN,--ProductName-pn, --productname stringString Specifica il nome del prodotto.Specifies the name of the product. È necessario specificare --devicegroupname e --productname oppure --devicegroupid.Either --devicegroupname and --productname, or --devicegroupid is required. 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

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

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

EsempioExample

Esempio per l'uso dell'ID del gruppo di dispositivi:Example for using device group ID:

azsphere device-group device list --devicegroupid 0e78m0mm-47d9-42m5-8572-a20b315d8045
Getting device group by ID '0e78m0mm-47d9-42m5-8572-a20b315d8045'.
Device group '0e78m0mm-47d9-42m5-8572-a20b315d8045' has no devices.

Esempio per l'uso del nome del gruppo di dispositivi:Example for using device group name:

azsphere device-group device  list --devicegroupname Marketing --productname DW100
Getting device group 'Marketing' for product 'DW100'.
Device group 'Marketing' for product 'DW100' has no devices.

device show-countdevice show-count

Visualizza il numero di dispositivi in un gruppo di dispositivi.Displays the number of devices in a device group.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--devicegroupid-i, --devicegroupid GUIDGUID Specifica l'ID del gruppo di dispositivi per il quale visualizzare il numero di dispositivi.Specifies the ID of the device group for which to show the device count. È necessario specificare --devicegroupid oppure --devicegroupname e --productname.Either --devicegroupid or --devicegroupname and --productname is required. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-DGN,--nomegruppodispositivi-dgn, --devicegroupname stringString Specifica il nome del gruppo di dispositivi per il quale visualizzare il numero di dispositivi.Specifies the name of the device group for which to show the device count. È necessario specificare --devicegroupname e --productname oppure --devicegroupid.Either --devicegroupname and --productname, or --devicegroupid is required. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e del gruppo di dispositivi nel formato seguente: --productname <product-name> --devicegroupname <device-group-name> .To use the device group name, you must specify both the product and device group name in the following format, --productname <product-name> --devicegroupname <device-group-name>. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-g,--Device-Group-g, --device-group stringString Specifica il gruppo di dispositivi per il quale visualizzare il numero di dispositivi.Specifies the device group for which to show the device count. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi.You can specify either the device group ID or the device group name. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e il nome del gruppo di dispositivi nel <product-name/device-group-name> formato.To use the device group name, you must provide both the product name and device group name in the <product-name/device-group-name> format. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-PN,--ProductName-pn, --productname stringString Specifica il nome del prodotto.Specifies the name of the product. È necessario specificare --devicegroupname e --productname oppure --devicegroupid.Either --devicegroupname and --productname, or --devicegroupid is required. 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

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

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

EsempioExample

azsphere device-group device show-count  --devicegroupid  0e78m0mm-47d9-42m5-8572-a20b315d8045
Getting device group by ID '0e78m0mm-47d9-42m5-8572-a20b315d8045'.
Device group '0e78m0mm-47d9-42m5-8572-a20b315d8045' has 0 device(s).

showshow

Restituisce le informazioni su un gruppo di dispositivi.Returns information about a device group.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--devicegroupid-i, --devicegroupid GUIDGUID Specifica l'ID del gruppo di dispositivi per cui visualizzare i dettagli.Specifies the ID of the device group for which to display details. È necessario specificare --devicegroupid oppure --devicegroupname e --productname.Either --devicegroupid or --devicegroupname and --productname is required. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-DGN,--nomegruppodispositivi-dgn, --devicegroupname stringString Specifica il nome del gruppo di dispositivi per cui visualizzare i dettagli.Specifies the name of the device group for which to display details. È necessario specificare --devicegroupname e --productname oppure --devicegroupid.Either --devicegroupname and --productname, or --devicegroupid is required. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e del gruppo di dispositivi nel formato seguente: --productname <product-name> --devicegroupname <device-group-name> .To use the device group name, you must specify both the product and device group name in the following format, --productname <product-name> --devicegroupname <device-group-name>. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-g,--Device-Group-g, --device-group stringString Specifica il gruppo di dispositivi per cui visualizzare i dettagli.Specifies the device group for which to display details. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi.You can specify either the device group ID or the device group name. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e il nome del gruppo di dispositivi nel <product-name/device-group-name> formato.To use the device group name, you must provide both the product name and device group name in the <product-name/device-group-name> format. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-PN,--ProductName-pn, --productname stringString Specifica il nome del prodotto.Specifies the name of the product. È necessario specificare --devicegroupname e --productname oppure --devicegroupid.Either --devicegroupname and --productname, or --devicegroupid is required. 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

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

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

EsempioExample

azsphere device-group show --devicegroupid 0e78m0mm-47d9-42m5-8572-a20b315d8045
Getting device group by ID '0e78m0mm-47d9-42m5-8572-a20b315d8045'.
Successfully retrieved the device group:
   ID:                 '0e78m0mm-47d9-42m5-8572-a20b315d8045'
   Name:               'Marketing'
   Description:        'Marketing device group'
   OS Feed Type:       'Retail'
   Update Policy:      Accept all updates from the Azure Sphere Security Service.
   Current Deployment: None

updateupdate

Aggiorna un gruppo di dispositivi esistente, identificato in base all'ID o dalla coppia nome prodotto e nome gruppo di dispositivi.Updates an existing device group, identified by ID or by product name and device group name pair.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--devicegroupid-i, --devicegroupid GUIDGUID Specifica l'ID del gruppo di dispositivi per cui aggiornare i dettagli.Specifies the ID of the device group for which to update details. È necessario specificare --devicegroupid oppure --devicegroupname e --productname.Either --devicegroupid or --devicegroupname and --productname is required. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-DGN,--nomegruppodispositivi-dgn, --devicegroupname stringString Specifica il nome del gruppo di dispositivi per cui aggiornare i dettagli.Specifies the name of the device group for which to update details. È necessario specificare --devicegroupname e --productname oppure --devicegroupid.Either --devicegroupname and --productname, or --devicegroupid is required. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e del gruppo di dispositivi nel formato seguente: --productname <product-name> --devicegroupname <device-group-name> .To use the device group name, you must specify both the product and device group name in the following format, --productname <product-name> --devicegroupname <device-group-name>. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-g,--Device-Group-g, --device-group stringString Specifica il gruppo di dispositivi per cui aggiornare i dettagli.È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi.You can specify either the device group ID or the device group name. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e il nome del gruppo di dispositivi nel <product-name/device-group-name> formato.To use the device group name, you must provide both the product name and device group name in the <product-name/device-group-name> format.Specifies the device group for which to update details.È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi.You can specify either the device group ID or the device group name. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e il nome del gruppo di dispositivi nel <product-name/device-group-name> formato.To use the device group name, you must provide both the product name and device group name in the <product-name/device-group-name> format. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-a.-a. --applicationupdate--applicationupdate ApplicationUpdatePolicyTypeApplicationUpdatePolicyType Specifica l'impostazione di aggiornamento dell'applicazione per il gruppo di dispositivi.Specifies the application update setting for the device group. On significa che gli aggiornamenti dell'applicazione sono abilitati, Off indica che gli aggiornamenti dell'applicazione sono disabilitati.On means application updates are enabled, and Off indicates application updates are disabled. Il valore predefinito è On.Default is On. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ND,--NewDescription-nd, --newdescription stringString Specifica il testo facoltativo per descrivere il gruppo di dispositivi.Specifies optional text to describe the device group. La lunghezza massima è di 100 caratteri.The maximum length is 100 characters. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-nn,--NewName-nn, --newname stringString Specifica un nuovo nome per il gruppo di dispositivi.Specifies a new name for the device group. 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 gruppo di dispositivi non può superare i 50 caratteri, non fa distinzione tra maiuscole e minuscole e deve essere univoco all'interno del prodotto.The device group name cannot exceed 50 characters, is case insensitive, and must be unique within the product. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-o, --osfeed -o, --osfeed stringString Specifica il feed del sistema operativo per il gruppo di dispositivi.Specifies the operating system feed for the device group. I valori possibili sono Retail e RetailEval.Possible values are Retail and RetailEval. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-PN,--ProductName-pn, --productname stringString Specifica il nome del prodotto.Specifies the name for the product. Specificare il --devicegroupname o specificare semplicemente il --devicegroupid.Specify this with --devicegroupname, or just specify --devicegroupid. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-a,--applicazione-aggiornamento-a, --application-update ApplicationUpdatePolicyTypeApplicationUpdatePolicyType Specifica l'impostazione di aggiornamento dell'applicazione per il gruppo di dispositivi.Specifies the application update setting for the device group. Valori consentiti: No3rdPartyAppUpdates, NoUpdates, UpdateAll.Allowed values: No3rdPartyAppUpdates, NoUpdates, UpdateAll. 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 gruppo di dispositivi.Specifies optional text to describe the device group. 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 gruppo di dispositivi.Specifies a new name for the device group. 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 gruppo di dispositivi non può superare i 50 caratteri, non fa distinzione tra maiuscole e minuscole e deve essere univoco all'interno del prodotto.The device group name cannot exceed 50 characters, is case insensitive, and must be unique within the product. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-f,--OS-feed-f, --os-feed stringString Specifica il feed del sistema operativo per il gruppo di dispositivi.Specifies the operating system feed for the device group. I valori possibili sono Retail e RetailEval.Possible values are Retail and RetailEval. 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

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

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

EsempioExample

azsphere device-group update --devicegroupid 0e78m0mm-47d9-42m5-8572-a20b315d8045 -newdescription "Marketing device group"
Getting device group by ID '0e78m0mm-47d9-42m5-8572-a20b315d8045'.
Applying update to device group '0e78m0mm-47d9-42m5-8572-a20b315d8045'.
New device group details after successful update:
   ID:                 '0e78m0mm-47d9-42m5-8572-a20b315d8045'
   Name:               'Marketing'
   Description:        'Marketing device group'
   OS Feed Type:       'Retail'
   Update Policy:      Accept all updates from the Azure Sphere Security Service.
   Current Deployment: None