device-group
Crea e gestisce gruppi di dispositivi.
I gruppi di dispositivi vengono risolti tramite identificatore (ID) o una coppia di nomi di prodotto e gruppi di dispositivi.
| Operazione | Descrizione |
|---|---|
| Creare | Crea un nuovo gruppo di dispositivi. |
| Elenco | Elencare tutti i gruppi di dispositivi nel tenant Azure Sphere. |
| Elimina | Elimina un gruppo di dispositivi esistente. |
| Distribuzione | Gestisce le distribuzioni all'interno di un gruppo di dispositivi. |
| Dispositivo | Elenca i dispositivi in un gruppo di dispositivi. |
| Visualizza | Visualizza informazioni su un gruppo di dispositivi. |
| Aggiornamento | Modifica un gruppo di dispositivi esistente. |
Creare
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 | Digitare | Descrizione |
|---|---|---|
| -p, --product | GUID o nome | Specifica il prodotto a cui aggiungere il gruppo di dispositivi. È possibile specificare l'ID o il nome del prodotto Azure Sphere. |
| -n, --name | Stringa | Specifica un nome per il gruppo di dispositivi. Il nome può includere solo caratteri alfanumerici. Se il nome include 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 | Digitare | Descrizione |
|---|---|---|
| -a, --application-update | Enum | Specifica i criteri di aggiornamento dell'applicazione da applicare per questo gruppo di dispositivi. Valori accettati: No3rdPartyAppUpdates, UpdateAlle NoUpdates. L'impostazione predefinita è 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. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
| -d, --description | Stringa | Specifica il testo facoltativo per descrivere il gruppo di dispositivi. La lunghezza massima è di 100 caratteri. Se la descrizione include spazi, racchiuderla tra virgolette. |
| -r, --regional-data-boundary | Stringa | Limite dei dati regionali per questa immagine. Valori consentiti: EU, None. Il valore predefinito è None. Se non viene specificato alcun valore, verrà usato il valore predefinito. Per ulteriori informazioni, vedi Configurare dump di arresto anomalo - Considerazioni pivacy |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
| -h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
| -o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
| --Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
| --Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori 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
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Elenco
Elencare tutti i gruppi di dispositivi nel tenant Azure Sphere.
Parametri facoltativi
| Parametro | Digitare | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
| -h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
| -o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
| --Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
| --Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori 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
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
Elimina
Elimina il gruppo di dispositivi specificato nel tenant di Azure Sphere.
Un gruppo di dispositivi può essere eliminato solo quando:
- L'utente ha autorizzazioni di amministratore per il tenant.
- Il gruppo di dispositivi è vuoto e non contiene alcun dispositivo. Il comando elenco di dispositivi del gruppo di dispositivi azsfera elenca tutti i dispositivi in un gruppo di dispositivi. Esegui l'aggiornamento del dispositivo azsfera : gruppo di dispositivi per spostare il dispositivo in un gruppo di dispositivi diverso.
Parametri obbligatori
| Parametro | Digitare | Descrizione |
|---|---|---|
| -g, --device-group | Stringa | Specifica il gruppo di dispositivi da eliminare. Puoi 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 gruppo di <product-name/device-group-name> dispositivi nel formato. |
Parametri facoltativi
| Parametro | Digitare | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
| -h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
| -o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
| --Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
| --Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori 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 |
|---|---|
| Creare | Crea una nuova distribuzione per il gruppo di dispositivi specificato. |
| Elenco | Visualizza le distribuzioni per un gruppo di dispositivi. |
creazione distribuzione
Crea una nuova distribuzione per un gruppo di dispositivi con le immagini fornite.
Puoi identificare il gruppo di dispositivi in base all'identificatore (ID) o a una coppia di nome prodotto e gruppo di dispositivi.
Parametri obbligatori
| Parametro | Digitare | Descrizione |
|---|---|---|
| -g, --device-group | Stringa | Specifica il gruppo di dispositivi in cui creare la distribuzione. Puoi 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 gruppo di <product-name/device-group-name> dispositivi nel formato. |
| -i, --immagini | Stringa | Specifica gli ID immagine per una o più immagini da includere nella distribuzione. È possibile aggiungere più immagini aggiungendo altri parametri oppure combinare più ID immagine in un unico parametro in un elenco separato da spazi. Eseguire il comando azsfera image add per ottenere l'ID immagine. |
Parametri facoltativi
| Parametro | Digitare | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
| -h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
| -o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
| --Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
| --Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori 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, puoi usare la coppia nome prodotto e nome gruppo di dispositivi nel <formato nome-prodotto>/<nome-gruppo-dispositivo> . Questa coppia di nomi identifica in modo univoco un gruppo di dispositivi per un determinato prodotto.
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
L'output dovrebbe essere 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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
elenco di distribuzione
Visualizza la cronologia di distribuzione per un gruppo di dispositivi. Restituisce l'ID di distribuzione, il timestamp e l'elenco delle immagini incluse. L'elenco è ordinato in base alle distribuzioni più recenti.
Parametri obbligatori
| Parametro | Digitare | Descrizione |
|---|---|---|
| -g, --device-group | Stringa | Specifica il gruppo di dispositivi per cui visualizzare l'elenco della cronologia delle distribuzioni. Puoi 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 gruppo di <product-name/device-group-name> dispositivi nel formato. |
Parametri facoltativi
| Parametro | Digitare | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
| -h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
| -o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
| --Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
| --Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori 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
L'output dovrebbe essere 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 |
|---|---|
| Elenco | Visualizza i dispositivi in un gruppo di dispositivi. |
| show-count | Mostra il numero di dispositivi in un gruppo di dispositivi. |
elenco dispositivi
Visualizza i dispositivi in un gruppo di dispositivi.
Parametri obbligatori
| Parametro | Digitare | Descrizione |
|---|---|---|
| -g, --device-group | Stringa | Specifica il gruppo di dispositivi per cui visualizzare l'elenco dei dispositivi. Puoi 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 gruppo di <product-name/device-group-name> dispositivi nel formato. |
Parametri facoltativi
| Parametro | Digitare | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
| -h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
| -o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
| --Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
| --Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori 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
L'output dovrebbe essere 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 | Digitare | Descrizione |
|---|---|---|
| -g, --device-group | Stringa | Specifica il gruppo di dispositivi per cui visualizzare il numero di dispositivi. Puoi 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 gruppo di <product-name/device-group-name> dispositivi nel formato. |
Parametri facoltativi
| Parametro | Digitare | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
| -h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
| -o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
| --Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
| --Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.
Esempio
Esempio per specificare device-group by ID:
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Esempio per specificare il nome del gruppo di dispositivi:
azsphere device-group device show-count --device-group DW100/Marketing
L'output dovrebbe essere simile al seguente:
------
Result
======
1
------
Visualizza
Restituisce informazioni su un gruppo di dispositivi.
Parametri obbligatori
| Parametro | Digitare | Descrizione |
|---|---|---|
| -g, --device-group | Stringa | Specifica il gruppo di dispositivi per cui visualizzare i dettagli. Puoi 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 gruppo di <product-name/device-group-name> dispositivi nel formato. |
Parametri facoltativi
| Parametro | Digitare | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
| -h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
| -o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
| --Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
| --Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.
Esempio
Esempio per specificare device-group by ID:
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Esempio per specificare il nome del gruppo di dispositivi:
azsphere device-group show --device-group DW100/Marketing
L'output dovrebbe essere 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
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Aggiornamento
Aggiornamenti un gruppo di dispositivi esistente, identificato dall'ID o dalla coppia nome prodotto e nome gruppo di dispositivi.
Parametri obbligatori
| Parametro | Digitare | Descrizione |
|---|---|---|
| -g, --device-group | Stringa | Specifica il gruppo di dispositivi per cui aggiornare i dettagli. Puoi 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 gruppo di <product-name/device-group-name> dispositivi nel formato. |
Parametri facoltativi
| Parametro | Digitare | Descrizione |
|---|---|---|
| -c, --allow-crash-dumps-collection | Stringa | Imposta il consenso per la raccolta di dump di arresto anomalo da parte di Microsoft per il gruppo di dispositivi. L'impostazione predefinita è Off. Valori consentiti: Off e On. Utilizzare il --regional-data-boundary parametro per specificare dove devono essere archiviati i file dump di arresto anomalo. Per ulteriori informazioni, vedi Configurare dump di arresto anomalo. |
| -a, --application-update | ApplicationUpdatePolicyType | Specifica i criteri di aggiornamento dell'applicazione per il gruppo di dispositivi. Valori consentiti: No3rdPartyAppUpdates, UpdateAlle NoUpdates. L'impostazione predefinita è UpdateAll. Il NoUpdates criterio è attualmente riservato solo per uso interno. |
| -d, --new-description | Stringa | Specifica il testo facoltativo per descrivere il gruppo di dispositivi. La lunghezza massima è di 100 caratteri. |
| -n, --new-name | Stringa | Specifica un nuovo nome per il gruppo di dispositivi. Il nome può includere solo caratteri alfanumerici. Se il nome include spazi, racchiuderlo tra virgolette. Il nome del gruppo di dispositivi non può superare i 50 caratteri, senza distinzione tra maiuscole e minuscole e deve essere univoco all'interno del prodotto. |
| -f, --os-feed | Stringa | 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. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
| -r, --regional-data-boundary | Stringa | Limite dei dati regionali per questa immagine. Valori consentiti: EU, None. Il valore predefinito è None. Se non viene specificato alcun valore, verrà usato il valore predefinito. Per ulteriori informazioni, vedi Configurare dump di arresto anomalo - Considerazioni pivacy |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
| -h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
| -o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
| --Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
| --Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.
Esempio
Esempio per specificare device-group by ID:
azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"
Esempio per specificare il nome del gruppo di dispositivi:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
L'output dovrebbe essere 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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------