device-group
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).
Crea e gestisce i gruppi di dispositivi.
I gruppi di dispositivi vengono indirizzati in base all'identificatore (ID) o alla coppia nome prodotto e nome gruppo di dispositivi.
| Operazione | Descrizione |
|---|---|
| create | Crea un nuovo gruppo di dispositivi. |
| list | Elencare tutti i gruppi di dispositivi nel tenant di Azure Sphere. |
| delete | Elimina un gruppo di dispositivi esistente. |
| deployment | Gestisce le distribuzioni all'interno di un gruppo di dispositivi. |
| device | Elenca i dispositivi in un gruppo di dispositivi. |
| show | Visualizza informazioni su un gruppo di dispositivi. |
| update | Modifica un gruppo di dispositivi esistente. |
create
Crea un gruppo di dispositivi con il nome specificato per il prodotto specificato. Il gruppo di dispositivi organizza i dispositivi che hanno lo stesso prodotto e ricevono le stesse applicazioni dal cloud.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -p, --product | GUID o nome | Specifica il prodotto a cui aggiungere questo gruppo di dispositivi. È possibile specificare l'ID o il nome del prodotto Azure Sphere. |
| -n,--name | String | Specifica un nome per il gruppo di dispositivi. Il nome può includere solo caratteri alfanumerici. Se il nome include degli spazi, racchiuderlo tra virgolette. Il nome del gruppo di dispositivi non può superare i 50 caratteri, senza distinzione tra maiuscole e minuscole, deve essere univoco all'interno del prodotto. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -a, --application-update | Enum | Specifica i criteri di aggiornamento dell'applicazione da applicare per questo gruppo di dispositivi. Valori accettati: No3rdPartyAppUpdates, UpdateAlle NoUpdates. Il valore predefinito è UpdateAll. Il NoUpdates criterio è attualmente riservato solo per uso interno. |
| -f, --os-feed | Enum | Specifica il tipo di feed del sistema operativo da usare per gli aggiornamenti del sistema operativo. Valori accettati: Retail, RetailEval. |
| -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 gruppo di dispositivi. La lunghezza massima consentita è di 100 caratteri. Se la descrizione include spazi, racchiuderla tra virgolette. |
| -r, --regional-data-boundary | String | Limite dei dati a livello di area per questa immagine. Valori consentiti: EU, None. Il valore predefinito è None. Se non viene specificato alcun valore, verrà usato il valore predefinito. Per altre informazioni, vedere Configurare i dump di arresto anomalo del sistema - Considerazioni su Pivacy |
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 device-group create --name Marketing --product DW100
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- ---------------------
Id TenantId OsFeedType ProductId Name UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
===================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
list
Elencare tutti i gruppi di dispositivi nel 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 device-group list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- ---------------------
Id Name Description ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
=====================================================================================================================================================================================================================================================================================
a3a49688-4601-4422-8b51-a0838ea84627 Development Default development device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept only system software updates. Don't accept application updates. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
7cb46b96-8c17-4afd-bd3f-614acad9d264 Field Test Default test device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
30c39bae-f525-4094-8008-d03705429ef0 Production Default production device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
cb5c9685-5dbe-470c-91a9-91dc129884d6 Production OS Evaluation Default Production OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
63e72035-3fcf-4fdc-b88a-05e30d1ba224 Field Test OS Evaluation Default Field Test OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
eliminare
Elimina il gruppo di dispositivi specificato nel tenant di Azure Sphere.
Un gruppo di dispositivi può essere eliminato solo quando:
- L'utente dispone delle autorizzazioni di amministratore per il tenant.
- Il gruppo di dispositivi è vuoto e non contiene dispositivi. Il comando azsphere device-group device list elenca tutti i dispositivi in un gruppo di dispositivi. Eseguire azsphere device update --device-group per spostare il dispositivo in un gruppo di dispositivi diverso.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -g, --device-group | String | Specifica il gruppo di dispositivi da eliminare. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi. Per usare il nome del gruppo di dispositivi, è necessario specificare sia il nome del prodotto che il nome del <product-name/device-group-name> gruppo di dispositivi nel formato. |
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 device-group delete --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Successfully deleted the device group
azsphere device-group delete --device-group DW100/Development
Successfully deleted the device group
distribuzione
Gestisce le distribuzioni per un gruppo di dispositivi.
| Operazione | Descrizione |
|---|---|
| create | Crea una nuova distribuzione per il gruppo di dispositivi specificato. |
| list | Visualizza le distribuzioni per un gruppo di dispositivi. |
deployment create
Crea una nuova distribuzione per un gruppo di dispositivi con le immagini fornite.
È possibile identificare il gruppo di dispositivi in base all'identificatore (ID) o alla coppia nome prodotto e nome gruppo di dispositivi.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -g, --device-group | String | Specifica il gruppo di dispositivi in cui creare la distribuzione. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi. Per usare il nome del gruppo di dispositivi, è necessario specificare sia il nome del prodotto che il nome del <product-name/device-group-name> gruppo di dispositivi nel formato. |
| -i, --images | String | Specifica gli ID immagine per una o più immagini da includere nella distribuzione. È possibile aggiungere più immagini aggiungendo parametri aggiuntivi oppure è possibile combinare più ID immagine in un singolo parametro in un elenco separato da spazi. Eseguire il comando azsphere image add per ottenere l'ID immagine. |
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
Il --device-group parametro identifica il gruppo di dispositivi. L'ID del gruppo di dispositivi fornisce un GUID che identifica in modo univoco il gruppo di dispositivi in tutti i prodotti. In alternativa, è possibile usare la coppia nome prodotto e nome gruppo di dispositivi nel <formato product-name>/<device-group-name> . Questa coppia di nomi identifica in modo univoco un gruppo di dispositivi per un prodotto specifico.
Esempio per specificare il gruppo di dispositivi in base all'ID:
azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Esempio per specificare il gruppo di dispositivi in base al nome:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Esempio per specificare più ID immagine fornendo un elenco di valori separati da spazi:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4
Verrà visualizzato un output simile al seguente:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb 5572509b-43a4-45b0-88c5-365cbf9732c1 2021-04-01T18:48:41.721662+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
deployment list
Visualizza la cronologia delle distribuzioni per un gruppo di dispositivi. Restituisce l'ID della distribuzione, il timestamp e l'elenco delle immagini incluse. L'elenco è ordinato in base alle distribuzioni più recenti.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -g, --device-group | String | Specifica il gruppo di dispositivi per il quale visualizzare l'elenco della cronologia di distribuzione. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi. Per usare il nome del gruppo di dispositivi, è necessario specificare sia il nome del prodotto che il nome del <product-name/device-group-name> gruppo di dispositivi nel formato. |
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 gruppo di dispositivi in base all'ID:
azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Esempio per specificare il gruppo di dispositivi in base al nome:
azsphere device-group deployment list --device-group DW100/Development
Verrà visualizzato un output simile al seguente:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb e3769536-dc4b-48d9-afd4-22ed321ba4bc 2020-11-18T19:46:50.514429+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
dispositivo
Gestisce i dispositivi per un gruppo di dispositivi.
| Operazione | Descrizione |
|---|---|
| list | Visualizza i dispositivi in un gruppo di dispositivi. |
| show-count | Indica il numero di dispositivi in un gruppo di dispositivi. |
device list
Visualizza i dispositivi in un gruppo di dispositivi.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -g, --device-group | String | Specifica il gruppo di dispositivi per cui visualizzare l'elenco dei dispositivi. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi. Per usare il nome del gruppo di dispositivi, è necessario specificare sia il nome del prodotto che il nome del <product-name/device-group-name> gruppo di dispositivi nel formato. |
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 gruppo di dispositivi in base all'ID:
azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Esempio per specificare il gruppo di dispositivi in base al nome:
azsphere device-group device list --device-group DW100/Marketing
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
Visualizza il numero di dispositivi in un gruppo di dispositivi.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -g, --device-group | String | Specifica il gruppo di dispositivi per il quale visualizzare il numero di dispositivi. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi. Per usare il nome del gruppo di dispositivi, è necessario specificare sia il nome del prodotto che il nome del <product-name/device-group-name> gruppo di dispositivi nel formato. |
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 device-group per ID:
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Esempio per specificare device-group per nome:
azsphere device-group device show-count --device-group DW100/Marketing
Verrà visualizzato un output simile al seguente:
------
Result
======
1
------
show
Restituisce le informazioni su un gruppo di dispositivi.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -g, --device-group | String | Specifica il gruppo di dispositivi per cui visualizzare i dettagli. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi. Per usare il nome del gruppo di dispositivi, è necessario specificare sia il nome del prodotto che il nome del <product-name/device-group-name> gruppo di dispositivi nel formato. |
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 device-group per ID:
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Esempio per specificare device-group per nome:
azsphere device-group show --device-group DW100/Marketing
Verrà visualizzato un output simile al seguente:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Id Name Description TenantId ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd Marketing Marketing device group 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
update
Aggiorna un gruppo di dispositivi esistente, identificato in base all'ID o dalla coppia nome prodotto e nome gruppo di dispositivi.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -g, --device-group | String | 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. Per usare il nome del gruppo di dispositivi, è necessario specificare sia il nome del prodotto che il nome del <product-name/device-group-name> gruppo di dispositivi nel formato. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -c, --allow-crash-dumps-collection | String | Impostare il consenso per la raccolta di dump di arresto anomalo di Microsoft per il gruppo di dispositivi. Il valore predefinito è Off. Valori consentiti: Off e On. Usare il --regional-data-boundary parametro per specificare dove archiviare i file di dump di arresto anomalo del sistema. Per altre informazioni, vedere Configurare i dump di arresto anomalo del sistema. |
| -a, --application-update | ApplicationUpdatePolicyType | Specifica i criteri di aggiornamento dell'applicazione per il gruppo di dispositivi. Valori consentiti: No3rdPartyAppUpdates, UpdateAlle NoUpdates. Il valore predefinito è UpdateAll. Il NoUpdates criterio è attualmente riservato solo per uso interno. |
| -d, --new-description | String | Specifica il testo facoltativo per descrivere il gruppo di dispositivi. La lunghezza massima consentita è di 100 caratteri. |
| -n, --new-name | String | Specifica un nuovo nome per il gruppo di dispositivi. Il nome può includere solo caratteri alfanumerici. Se il nome include degli spazi, racchiuderlo tra virgolette. 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. |
| -f, --os-feed | String | Specifica il feed del sistema operativo per il gruppo di dispositivi. I valori possibili sono Retail e RetailEval. |
| -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. |
| -r, --regional-data-boundary | String | Limite dei dati a livello di area per questa immagine. Valori consentiti: EU, None. Il valore predefinito è None. Se non viene specificato alcun valore, verrà usato il valore predefinito. Per altre informazioni, vedere Configurare i dump di arresto anomalo del sistema - Considerazioni su Pivacy |
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 device-group per ID:
azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"
Esempio per specificare device-group per nome:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
Verrà visualizzato un output simile al seguente:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
Id TenantId OsFeedType ProductId Name Description UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Marketing device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------