dispositivo
Importante
Questa è la documentazione di Azure Sphere (legacy). Azure Sphere (legacy) viene ritirato il 27 settembre 2027 e gli utenti devono eseguire la migrazione ad Azure Sphere (integrato) entro questo periodo. Usare il selettore di versione posizionato sopra il sommario per visualizzare la documentazione di Azure Sphere (integrata).
Gestisce i dispositivi di Azure Sphere.
| Operazione | Descrizione |
|---|---|
| app | Modifica lo stato delle applicazioni in un dispositivo. |
| capability | Gestisce le funzionalità del dispositivo. |
| certificate | Gestisce l'archivio certificati del dispositivo. |
| claim | Richiede un dispositivo non reclamato in precedenza al tenant di Azure Sphere. |
| enable-cloud-test | Configura un dispositivo per disabilitare il debug e ricevere gli aggiornamenti. |
| enable-development | Configura un dispositivo per il debug locale. |
| Immagine | Gestisce le immagini per un dispositivo. |
| list | Visualizza tutti i dispositivi nel tenant. |
| list-attached | Elenca i dispositivi collegati. |
| stato di produzione | Gestisce lo stato di produzione del dispositivo collegato. |
| network | Fornisce informazioni sullo stato delle interfacce di rete nel dispositivo. |
| recover | Usa una modalità di ripristino speciale per caricare il nuovo firmware nel dispositivo. |
| ripetere l'analisi collegata | Analizza nuovamente i dispositivi collegati come supporto per la risoluzione dei problemi (solo Windows). |
| restart | Riavvia il dispositivo collegato. |
| show | Visualizza i dettagli sulla configurazione degli aggiornamenti del dispositivo. |
| show-attached | Visualizza i dettagli sul dispositivo collegato dal dispositivo stesso. |
| show-count | Mostra il numero totale di dispositivi in un tenant. |
| show-deployment-status | Visualizza lo stato dell'aggiornamento della distribuzione più recente. |
| show-os-version | Visualizza la versione del sistema operativo del dispositivo locale. |
| sideload | Carica un'immagine nel dispositivo collegato. |
| update | Aggiorna un dispositivo inserendolo in un gruppo di dispositivi specifico. |
| wifi | Gestisce la configurazione Wi-Fi per il dispositivo. |
app
Gestisce le applicazioni nel dispositivo.
Molte delle opzioni dell'app richiedono la funzionalità appDevelopment, che può essere acquisita usando azsphere device enable-development. Per avviare, arrestare o eseguire il debug di un'applicazione con firma SDK o di produzione, il dispositivo deve essere dotato della funzionalità appDevelopment.
È possibile usare azsphere device app stop e azsphere device app start per riavviare un'applicazione con funzionalità in tempo reale in esecuzione per determinare il core in tempo reale in cui è in esecuzione.
| Operazione | Descrizione |
|---|---|
| show-memory-stats | Visualizza le statistiche di memoria per le applicazioni nel dispositivo collegato. |
| show-quota | Visualizza la quantità di spazio di archiviazione usato dall'applicazione corrente nel dispositivo. |
| show-status | Restituisce lo stato dell'applicazione corrente nel dispositivo. |
| start | Avvia l'applicazione caricata nel dispositivo. |
| stop | Arresta l'applicazione in esecuzione nel dispositivo. |
app show-memory-stats
Mostra le statistiche di memoria per le applicazioni nel dispositivo collegato. Questo comando è disponibile solo se la funzionalità del dispositivo appDevelopment è configurata. Vengono visualizzate informazioni aggiuntive se è configurato il rilevamento dell'allocazione di memoria heap.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 app show-memory-stats
-------------- -------------
Name Usage (bytes)
============================
Total 434176
User Mode 147456
Peak User Mode 147456
-------------- -------------
app show-quota
Visualizza la quantità di spazio di archiviazione modificabile allocato e in uso nel dispositivo connesso.
La quota di archiviazione modificabile viene impostata nel manifesto dell'applicazione e il sistema operativo Azure Sphere applica le quote quando alloca i settori per il file. Di conseguenza, se si riduce il valore di MutableStorage, la quantità di spazio di archiviazione in uso non cambia, ma il valore segnalato per l'allocazione sarà diverso. Ad esempio, se l'applicazione ha già usato 16 KB e si modifica il MutableStorage valore in 8 KB, il comando segnala che l'applicazione usa 16 KB di 8 KB allocati. I dati rimangono nel dispositivo.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -i, --component-id | GUID | Specifica l'ID del componente per il quale ottenere informazioni sulla quota. Se omesso, visualizza le informazioni sulla quota per tutti i componenti. |
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 app show-quota
ae4714aa-03aa-492b-9663-962f966a9cc3: 0KB out of 8KB of mutable storage used.
app show-status
Restituisce lo stato corrente delle applicazioni nel dispositivo.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -i, --component-id | GUID | Specifica l'ID del componente per visualizzare lo stato. Se omesso, mostra lo stato di tutti i componenti. |
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 app show-status
9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
App state: running
app start
Avvia le applicazioni nel dispositivo.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| --debug-mode | Booleano | Avvia l'applicazione per eseguire il debug. L'oggetto --component-id deve essere specificato. |
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| -i, --component-id | GUID | Specifica l'ID del componente da avviare. Se omesso, avvia tutte le applicazioni. |
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 app start
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: running
Core : High-level
app stop
Arresta le applicazioni nel dispositivo.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -i, --component-id | GUID | Specifica l'ID del componente da arrestare. Se omesso, arresta tutte le applicazioni. |
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 app stop
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: stopped
capability
Gestisce le funzionalità del dispositivo. Le funzionalità di dispositivo determinano le operazioni che possono essere eseguite in un singolo dispositivo Azure Sphere.
Le funzionalità del dispositivo vengono scaricate come file dal servizio di sicurezza di Azure Sphere usando il comando azsphere device capability download. È possibile applicare la configurazione delle funzionalità di dispositivo al dispositivo Azure Sphere collegato usando il comando azsphere device capability update ed è possibile creare una sessione di manutenzione usando il comando azsphere device capability select. Per altre informazioni sulle funzionalità del dispositivo, vedere Funzionalità e comunicazione dei dispositivi.
| Operazione | Descrizione |
|---|---|
| download | Scarica una configurazione delle funzionalità del dispositivo dal servizio di sicurezza di Azure Sphere. |
| select | Seleziona un file di funzionalità scaricato da usare per una sessione di manutenzione. |
| show-attached | Visualizza la configurazione delle funzionalità per il dispositivo collegato. |
| update | Applica una configurazione delle funzionalità al dispositivo collegato. |
Download di funzionalità
Scarica una funzionalità di dispositivo dal servizio di sicurezza di Azure Sphere.
La funzionalità appDevelopment consente di trasferire localmente le applicazioni con firma SDK e di avviare, arrestare, eseguire il debug o eliminare qualsiasi applicazione nel dispositivo. Senza la funzionalità appDevelopment è possibile caricare solo le applicazioni caricate sul cloud, mentre l'avvio, l'arresto, l'esecuzione del debug e l'eliminazione non sono consentiti. La funzionalità appDevelopment viene applicata come parte del comando azsphere device enable-development.
Il download della funzionalità fieldServicing consente di ottenere un file contenente la funzionalità per un singolo dispositivo Azure Sphere. Il file di funzionalità fieldServicing viene scaricato nel computer locale e può essere usato in combinazione con il comando azsphere device capability select.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| --type | Tipo di funzionalità | Specifica il tipo di funzionalità del dispositivo da scaricare. I valori sono appDevelopment, fieldServicing o None. Usare None per rimuovere la funzionalità appDevelopment o la funzionalità fieldServicing. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando. Questo parametro è obbligatorio quando vengono collegati più dispositivi o quando non è collegato alcun dispositivo. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare un ID dispositivo per un dispositivo non collegato oppure specificare l'indirizzo IP o l'ID connessione locale di un dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| --destinazione | String | Specifica il percorso e il nome file in cui salvare la configurazione delle funzionalità. Specificare un percorso assoluto o relativo. Se non si specifica un percorso, il comando archivia il file nella directory locale usando la funzionalità di convenzione <di denominazione type-first>< otto caratteri di ID.cap> del dispositivo. |
| -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 capability download --type appDevelopment
The appdevelopment capability was saved as:
--------------------------------------------
Result
============================================
C:\capability-file\appdevelopment-<first eight characters of device ID>.cap
--------------------------------------------
capability select
Seleziona un file di funzionalità da usare con il dispositivo Azure Sphere collegato.
Il comando azsphere device capability selectpuò essere usato con qualsiasi funzionalità, ma viene generalmente usato con la funzionalità fieldServicing per abilitare una sessione di manutenzione. Tutti i ruoli utente hanno accesso al comando azsphere device capability select.
Quando si usa la funzionalità fieldServicing, la comunicazione tra il dispositivo Azure Sphere e il computer locale che contiene il file di funzionalità è abilitata. Il file di funzionalità fieldServicing viene usato per una sessione tra il computer locale e il dispositivo Azure Sphere e a ogni comando della sessione viene anteposto un messaggio che indica il file di funzionalità in uso.
Per terminare una sessione di manutenzione, usare azsphere device capability select --none.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| --capability-file | String | Specifica il percorso e il nome file del file di configurazione delle funzionalità del dispositivo da selezionare. È possibile specificare un percorso relativo o assoluto. |
| -n, --none | - | Cancella tutte le configurazioni di funzionalità di dispositivo selezionate in precedenza. |
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 capability select --capability-file appdevcap
The capability session uses C:\capability-file\appdevcap.
funzionalità show-attached
Visualizza la configurazione delle funzionalità archiviata nel dispositivo collegato.
Nota
Il comando visualizza le funzionalità configurate usando un file di funzionalità e alcune funzionalità, ma non tutte, presenti per impostazione predefinita nelle schede.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 capability show-attached
--------------------
DeviceCapabilities
====================
EnableFieldServicing
--------------------
azsphere device capability show-attached
--------------------
DeviceCapabilities
====================
EnableAppDevelopment
--------------------
funzionalità update
Applica una configurazione delle funzionalità al dispositivo collegato.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| --capability-file | String | Specifica il percorso e il nome file del file di funzionalità del dispositivo da applicare. È possibile specificare un percorso relativo o assoluto. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando. Questo parametro è obbligatorio quando vengono collegati più dispositivi o quando non è collegato alcun dispositivo. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare un ID dispositivo per un dispositivo non collegato oppure specificare l'indirizzo IP o l'ID connessione locale di un dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 capability update --capability-file appdevcap.bin
Using selected capability file: C:\capability-file\appdevcap.bin
The capability file C:\capability-file\appdevcap.bin was added on the device. The device will restart.
certificato
Gestisce i certificati nel dispositivo collegato.
| Operazione | Descrizione |
|---|---|
| add | Aggiunge un certificato all'archivio certificati nel dispositivo collegato. |
| delete | Elimina un certificato dall'archivio certificati del dispositivo collegato. |
| list | Elenca gli ID certificato disponibili nell'archivio certificati del dispositivo collegato. |
| show | Visualizza i dettagli di un certificato nell'archivio certificati del dispositivo collegato. |
| show-quota | Visualizza lo spazio disponibile nell'archivio certificati del dispositivo collegato. |
certificate add
Aggiunge un certificato all'archivio certificati del dispositivo collegato.
Per caricare i certificati client e CA radice nel dispositivo Azure Sphere, è necessario che siano in formato PEM. È necessario acquisire il certificato CA radice dal server appropriato, insieme al certificato client e alla chiave privata (e facoltativamente una password per la chiave privata) per il dispositivo. Ogni certificato deve essere generato e firmato dal server appropriato nella rete EAP-TLS. L'amministratore di rete o il team di sicurezza può fornire i dettagli necessari per ottenere i certificati. Per altre informazioni sull'acquisizione del certificato CA radice, vedere Acquisire e distribuire certificati per le reti EAP-TLS.
Attenzione
Poiché gli ID certificato sono a livello di sistema sia per il certificato client che per il certificato CA radice, un comando azsphere o una chiamata di funzione che aggiunge un nuovo certificato può sovrascrivere un certificato aggiunto da un comando o una chiamata di funzione precedente, generando possibilmente errori di connessione di rete. È consigliabile sviluppare procedure ben definite per l'aggiornamento dei certificati e scegliere con attenzione gli ID certificato.
Per altre informazioni, vedere ID certificato.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -i, --cert-id | String | Specifica l'identificatore del certificato da aggiungere. Identificatore di stringa (fino a 16 caratteri). I caratteri validi includono lettere maiuscole (A-Z), lettere minuscole (a-z), numeri (0-9), carattere di sottolineatura (_), punto (.) e trattino (-). Questo identificatore viene usato anche nelle configurazioni Wi-Fi per le reti EAP-TLS. |
| --cert-type | String | Specifica il tipo di certificato da aggiungere, client o rootca. |
| -p, --public-key-file | String | Specifica il percorso di un file pem del certificato di chiave pubblica. È possibile specificare un percorso relativo o assoluto. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| --private-key-file | String | Specifica il percorso di un file pem del certificato della chiave privata del client. Obbligatorio quando si aggiunge un certificato di tipo client. È possibile specificare un percorso relativo o assoluto. |
| -w, --private-key-password | String | Specifica una password facoltativa per la chiave privata del client. La password è necessaria quando si aggiunge una chiave privata del certificato client crittografata. |
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 certificate add --cert-id certroot --cert-type rootca --public-key-file publiccert.pem
Certificate 'certroot' successfully added.
azsphere device certificate add --cert-id certclient --cert-type client --private-key-file privatekey.pem --private-key-password 1234 --public-key-file publiccert.pem
Certificate 'certclient' successfully added.
certificate delete
Elimina un certificato dall'archivio certificati del dispositivo collegato.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -c, --certificate o --cert-id [Ritiro] |
String | Specifica l'identificatore del certificato da eliminare. L'argomento --cert-id verrà ritirato e verrà rimosso in una versione futura. Per altre informazioni, vedere Modifiche importanti (ritiro delle funzionalità) nell'interfaccia della riga di comando di Azure Sphere. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 certificate delete --certificate certclient
certificate list
Elenca i certificati disponibili nell'archivio certificati del dispositivo.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 certificate list
-----------
Identifiers
===========
rootCert
-----------
certificate show
Visualizza i dettagli di un singolo certificato nell'archivio certificati del dispositivo.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -c, --certificate o --cert-id [Ritiro] |
String | Specifica l'identificatore del certificato per il quale visualizzare i dettagli. L'argomento --cert-id verrà ritirato e verrà rimosso in una versione futura. Per altre informazioni, vedere Modifiche importanti (ritiro delle funzionalità) nell'interfaccia della riga di comando di Azure Sphere. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 certificate show --certificate certclient
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
Id StartDate EndDate SubjectName IssuerName
==========================================================================================================================
certclient 06/08/2019 19:15:48 06/08/2069 19:25:44 /DC=local/DC=azsphere/CN=azsphereca /DC=local/DC=azsphere/CN=azsphereca
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
certificate show-quota
Visualizza lo spazio disponibile nell'archivio certificati del dispositivo collegato.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 certificate show-quota
--------------
Available space (bytes)
==============
24514
--------------
claim
Attesta un dispositivo non attestato in precedenza per il tenant di Azure Sphere.
Importante
Prima dell'attestazione del dispositivo, assicurarsi di aver eseguito l'accesso al tenant corretto di Azure Sphere. L'attestazione del dispositivo può essere eseguita una sola volta. Una volta eseguita l'attestazione, non è possibile spostare il dispositivo in un tenant diverso.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando. Questo parametro è obbligatorio quando vengono collegati più dispositivi o quando non è collegato alcun dispositivo. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare un ID dispositivo per un dispositivo non collegato oppure specificare l'indirizzo IP o l'ID connessione locale di un dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| -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. |
| --force | Booleano | Forza l'attestazione di un dispositivo nel tenant di Azure Sphere selezionato dall'utente corrente. |
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 claim
warn: You are claiming a device to the following tenant:
warn: a323c263-2aa3-2559-aabb-a3fc32631900 (Tenant1)
warn: Do you want to claim the device ID 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968 to this tenant?
warn: You cannot change the Azure Sphere tenant this device is claimed to once this action has completed.
Enter 'yes' to continue. Enter anything else to exit.
> yes
Claiming device.
Successfully claimed device ID '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968' into tenant 'Tenant1' with ID 'a323c263-2aa3-2559-aabb-a3fc32631900'.
enable-cloud-test
Rende il dispositivo collegato pronto per il caricamento del cloud di test disabilitando lo sviluppo dell'applicazione, eliminando tutte le applicazioni esistenti e consentendo l'esecuzione degli aggiornamenti dell'applicazione caricati sul cloud.
Richiede un dispositivo collegato al computer e funziona solo su tale dispositivo.
In particolare, enable-cloud-test:
- Rimuove la funzionalità appDevelopment per il dispositivo collegato.
- Assegna il dispositivo a un gruppo di dispositivi che abilita gli aggiornamenti dell'applicazione caricati dal cloud.
- Riavvia il dispositivo.
Le attività specifiche che enable-cloud-test esegue variano in base all'avvenuta assegnazione al dispositivo del prodotto e del gruppo di dispositivi.
Se azsphere device enable-cloud-test viene eseguito senza parametri, il dispositivo viene inserito nel gruppo di dispositivi Field Test del prodotto corrente del dispositivo. Si tratta di uno dei gruppi di dispositivi predefiniti creati automaticamente per ogni prodotto, che consente gli aggiornamenti dell'applicazione. Viene restituito un errore se il dispositivo non ha un prodotto o se non esiste un gruppo di dispositivi Field Test.
Se viene specificato un prodotto, il dispositivo viene inserito nel gruppo di dispositivi Field Test di tale prodotto. Se il gruppo di dispositivi non esiste, viene restituito un errore.
Se viene specificato un gruppo di dispositivi, il dispositivo viene inserito. Se il gruppo di dispositivi di destinazione non abilita gli aggiornamenti dell'applicazione, viene restituito un errore.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| -p, --product | GUID o nome | Specifica il prodotto di destinazione. Quando si specifica questa opzione, il dispositivo viene spostato nel gruppo di dispositivi Test campi predefinito di questo prodotto, a meno che non --device-group venga specificato anche. È possibile specificare l'ID o il nome del prodotto Azure Sphere. |
| -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. |
| -g, --device-group | GUID o nome | Specifica il gruppo di dispositivi in cui verrà spostato il dispositivo. È 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. Per impostazione predefinita, si tratta del gruppo di dispositivi Field Test del prodotto. |
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.
Esempi
Esempio 1. Assegnare il dispositivo al gruppo di dispositivi esistente in base al relativo ID
L'esempio illustra l'assegnazione di un dispositivo a un prodotto e gruppo di dispositivi esistente.
azsphere device enable-cloud-test --device-group '3548b179-m16f-4f64-6dme-d3c643662e76'
Your internal capabilities will be retained, including the Enable App development capability. Sideloaded images may be removed by over-the-air application updates.
Getting device group by ID '3548b179-m16f-4f64-6dme-d3c643662e76'.
Leaving any existing applications on the device.
Setting device group to 'Field Test' with ID '3548b179-m16f-4f64-6dme-d3c643662e76')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: 'ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD')
Esempio 2. Assegnare il dispositivo a gruppo di dispositivi diverso
Questo esempio è simile al precedente, ma il prodotto esistente viene mantenuto per il dispositivo. In questo caso l'operazione enable-cloud-test modifica il gruppo di dispositivi a cui appartiene il dispositivo e rimuove la funzionalità appDevelopment. Questo comando è utile per lo spostamento di un dispositivo da un ambiente di sviluppo che non consente di eseguire gli aggiornamenti dell'applicazione a un ambiente di produzione che invece consente di eseguirli.
azsphere device enable-cloud-test --device-group "Marketing/Field Test"
Esempio 3. Assegnare il dispositivo in base al nome del prodotto
L'esempio illustra l'abilitazione del caricamento del cloud e l'assegnazione del dispositivo a un prodotto in base al nome.
azsphere device enable-cloud-test --product DW100
enable-development
Abilita un dispositivo per lo sviluppo abilitando il sideload e il debug nel dispositivo e assegnandolo a un gruppo di dispositivi che disabilita gli aggiornamenti delle applicazioni dal cloud. Per impostazione predefinita, si tratta del gruppo di dispositivi Sviluppo del prodotto del dispositivo, ma è possibile specificare altri gruppi di dispositivi. Non usare negli scenari di produzione. Per altre informazioni, vedere Produzione di dispositivi connessi.
In particolare, enable-development:
- Scarica e applica la funzionalità appDevelopment per il dispositivo collegato.
- Assegna il dispositivo a un gruppo di dispositivi che non abilita gli aggiornamenti dell'applicazione caricati dal cloud.
- Riavvia il dispositivo.
Se si esegue il comando azsphere device enable-development senza parametri:
- Se il dispositivo non è già associato a un gruppo di prodotti o di dispositivi, il comando scarica e applica la funzionalità appDevelopment per il dispositivo collegato e lo riavvia. Tutte le app esistenti rimangono nel dispositivo e il sistema operativo viene aggiornato. Il processo di installazione per richiedere il dispositivo e l'avvio rapido per compilare un'applicazione di alto livello non è interessato.
- Se il dispositivo dispone già di un prodotto, il comando sposta il dispositivo al gruppo di dispositivi Sviluppo del prodotto. Per impostazione predefinita, gli aggiornamenti delle applicazioni sono disabilitati per questo gruppo, assicurandosi che le app trasferite localmente non vengano sovrascritte.
Se si esegue il comando azsphere device enable-development con il --product parametro :
- Inserisce il dispositivo nel gruppo di dispositivi Sviluppo per il prodotto. Se il gruppo di dispositivi non esiste, viene restituito un errore.
Se si esegue il comando azsphere device enable-development con il --device-group parametro :
- Inserisce il dispositivo nel gruppo di dispositivi specificato. Il gruppo di dispositivi di destinazione non deve abilitare gli aggiornamenti dell'applicazione o viene restituito un errore.
In alcuni casi, azsphere device enable-development segnala un errore e suggerisce di attestare il dispositivo. Se è già stata eseguita l'attestazione del dispositivo, usare azsphere tenant show-selected per assicurarsi di essere connessi al tenant in cui è stata eseguita l'attestazione del dispositivo. In caso contrario, usare azsphere login per accedere al tenant corretto. Quando si è certi di aver eseguito l'accesso al tenant appropriato, usare azsphere device claim per richiedere il dispositivo.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| -g, --device-group | GUID o nome | Specifica il gruppo di dispositivi in cui verrà spostato il dispositivo. Se omesso, assegna il dispositivo a un gruppo predefinito. È 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. |
| -r, --enable-rt-core-debugging | Booleano | Installa i driver necessari per il debug di applicazioni in esecuzione su un core per operazioni in tempo reale. Questa opzione richiede le autorizzazioni di amministratore. |
| -p, --product | GUID o nome | Specifica il prodotto di destinazione. Quando si specifica questo valore, il dispositivo viene spostato nel gruppo di dispositivi Sviluppo predefinito di questo prodotto, a meno che non --device-group venga specificato anche. È possibile specificare l'ID o il nome del prodotto Azure Sphere. |
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 enable-development
Capability configuration has been successfully cleared.
PS C:\Users\v-shypr> azsphere device enable-development
Getting device group 'Development' for product 'DW100'.
The device already has the 'Enable App development' capability. No changes will be applied to its existing capabilities.
Setting device group to 'Development' with ID '7f860cc1-4949-4000-a541-9a988ba4c3cd'.
Successfully disabled application updates.
Installing debugging server to device.
Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
Previous device capabilities retained. Ensure that you have the correct development capabilities installed before continuing.
Successfully set up device for application development, and disabled application updates.
(Device ID: '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968')
image
Restituisce informazioni sulle immagini installate nel dispositivo collegato o destinate ad esso.
| Operazione | Descrizione |
|---|---|
| list-installed | Fornisce informazioni dettagliate sulle immagini attualmente installate nel dispositivo collegato. |
| list-targeted | Fornisce informazioni dettagliate sulle immagini destinate al dispositivo collegato. |
image list-installed
Elenca le immagini installate nel dispositivo collegato. L'elenco delle informazioni include gli ID dei componenti e delle immagini.
Nota
I nomi delle immagini lunghe vengono troncati a 31 caratteri.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| -f, --full | Booleano | Elenca tutte le immagini software installate nel dispositivo. Per impostazione predefinita, elenca solo le immagini dell'applicazione, i debugger e le immagini di configurazione della scheda. |
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 image list-installed
Installed images:
--> gdbserver
--> Image type: Application
--> Component ID: 8548b129-b16f-4f84-8dbe-d2c847862e78
--> Image ID: dc6205bd-4478-4c9b-81ad-5e41ac23ed68
--> CrashApplicatio
--> Image type: Application
--> Component ID: 9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
--> Image ID: cc77124e-6447-4c0f-9f99-fc0ad5ef46ef
image list-targeted
Elenca le immagini caricate nel servizio di sicurezza di Azure Sphere e verranno installate quando il dispositivo viene aggiornato. Per altre informazioni su come assicurarsi che il dispositivo Azure Sphere sia pronto per accettare gli aggiornamenti delle applicazioni basate sul cloud, vedere Abilitare la distribuzione basata sul cloud per il dispositivo.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando. Questo parametro è obbligatorio quando vengono collegati più dispositivi o quando non è collegato alcun dispositivo. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare un ID dispositivo per un dispositivo non collegato oppure specificare l'indirizzo IP o l'ID connessione locale di un dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| -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. |
| -f, --full | Booleano | Elenca tutte le immagini nel tenant di Azure Sphere. |
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 image list-targeted
----------------------- ------------------------------------ ------------------------------------ ---------------- --------------------
Name ComponentId ImageId ImageType RegionalDataBoundary
=======================================================================================================================================
HelloWorld_HighLevelApp 1689d8b2-c835-2e27-27ad-e894d6d15fa9 50419cb6-a33b-4cbe-8bd0-425048664b6f Applications None
----------------------- ------------------------------------ ------------------------------------ -------------------------------------
list
Elenca tutti i dispositivi in un tenant. L'elenco tronca i primi 500 dispositivi.
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 list
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
========================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
È possibile usare il --query parametro per personalizzare l'output visualizzato per questo comando. Per altre informazioni, vedere Output dei comandi dell'interfaccia della riga di comando di query.
L'esempio seguente illustra come selezionare solo l'ID dispositivo e l'ID prodotto:
azsphere device list --query '[].{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 4f48d618-09f7-45dc-a5a4-1433cabbee91
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD 4f48d618-09f7-45dc-a5a4-1433cabbee91
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
Suggerimento
Eseguire azsphere product show --product <product-ID> per visualizzare il nome del prodotto o azsphere device-group show --device-group <devicegroup-ID> per visualizzare il nome del gruppo di dispositivi.
list-attached
Elenca i dispositivi collegati al PC locale.
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 list-attached
1 device attached:
--> Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
--> Is responsive: yes
--> IP address: 192.128.48.1
--> Connection path: 21143
stato di produzione
Gestisce lo stato di produzione del dispositivo collegato.
| Operazione | Descrizione |
|---|---|
| show | Consente di visualizzare lo stato di produzione del dispositivo collegato. |
| update | Aggiorna lo stato di produzione del dispositivo collegato. |
Attenzione
Le modifiche allo stato di produzione sono definitive e irreversibili.
manufacturing-state show
Consente di visualizzare lo stato di produzione del dispositivo collegato.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 manufacturing-state show
------------------
ManufacturingState
==================
Module1Complete
------------------
manufacturing-state update
Aggiorna lo stato di produzione del dispositivo collegato. Per altre informazioni, vedere Impostare lo stato di produzione del dispositivo.
Attenzione
Le modifiche allo stato di produzione sono definitive e irreversibili.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -s, --state | Stati di produzione | Specifica lo stato di produzione da impostare per il dispositivo. Gli stati possibili includono DeviceComplete e Module1Complete. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 manufacturing-state update --state Module1Complete
Updating manufacturing state to Module1Complete.
Restarting device for changes to take effect.
The device was successfully restarted.
rete
Fornisce informazioni sullo stato delle interfacce di rete nel dispositivo collegato.
| Operazione | Descrizione |
|---|---|
| enable | Abilita un'interfaccia di rete nel dispositivo collegato. |
| disable | Disabilita un'interfaccia di rete nel dispositivo collegato. |
| list-firewall-rules | Elenca le regole del firewall per il dispositivo collegato. |
| list-interfaces | Elenca le interfacce di rete per il dispositivo collegato. |
| proxy | Gestisce le impostazioni proxy di rete. |
| show-diagnostics | Mostra la diagnostica di rete per una o tutte le reti wireless nel dispositivo collegato. |
| show-status | Mostra lo stato di rete per il dispositivo collegato. |
| update-interface | Aggiorna una configurazione dell'interfaccia di rete per il dispositivo. |
abilitazione rete
Abilita un'interfaccia di rete nel dispositivo collegato.
Nota
Questo comando è supportato per la configurazione di Ethernet eth0 e wlan0 connessioni. Viene restituito un errore se si configura lo o azspheresvc.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| --interfaccia | string | Specifica l'interfaccia da abilitare. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 network enable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.
network disable
Disabilita un'interfaccia di rete nel dispositivo collegato.
Nota
Questo comando è supportato per la configurazione di Ethernet eth0 e wlan0 connessioni. Viene restituito un errore se si configura lo o azspheresvc.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| --interfaccia | string | Specifica l'interfaccia da abilitare. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 network disable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.
network list-firewall-rules
Elenca le regole del firewall per il dispositivo collegato.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
Vengono visualizzate le regole seguenti:
- Nome del set di regole del firewall: visualizza il nome del blocco del set di regole del firewall.
- I valori sono PREROUTING, POSTROUTING, INPUT, FORWARD e OUTPUT.
- Set di regole valido: visualizza lo stato del set di regole. I valori sono True o False.
- Regole del set di regole del firewall: visualizza i valori per le regole seguenti:
- IP di origine: visualizza l'indirizzo IP del computer di invio.
- Maschera di origine: visualizza la maschera di rete del computer di invio.
- IP di destinazione: visualizza l'indirizzo IP del computer di destinazione.
- Maschera di destinazione: visualizza la maschera di rete del computer di destomazione.
- UID: visualizza l'identificazione utente applicata alla regola. 4294967295 (0xFFFFFFFF) significa che non è stato applicato alcun UID e pertanto si applica a tutti.
- Azione: visualizza l'azione da eseguire. I valori possono essere accettati o rilasciati.
- Interface IN name (Nome interfaccia IN): visualizza il nome dell'interfaccia di input. Ad esempio, wlan0.
- Nome OUT dell'interfaccia: visualizza il nome dell'interfaccia di output. Ad esempio, wlan0.
- Stato: visualizza lo stato della connessione. I valori sono none, stabiliti o correlati.
- Maschera TCP: visualizza la matrice di maschere TCP. I valori sono fin, syn, rst, psh, ack e urg.
- TCP Cmp: visualizza la matrice di flag TCP. I valori sono urg, ack, psh, rst, syb e fin.
- TCP Inv: valore booleano indica che il senso dei flag TCP deve essere invertito. I valori sono True o False.
- Protocollo: visualizza il protocollo della regola del firewall. I valori sono icmp, igmp, tcp, udp.
- Intervallo di porte di origine: visualizza l'intervallo di porte dall'origine che invia il traffico. Il valore può essere compreso tra 0 e 65535.
- Intervallo di porte di destinazione: visualizza l'intervallo di porte nella destinazione che riceve il traffico. Il valore può essere compreso tra 0 e 65535.
- Pacchetti: visualizza il numero di pacchetti.
- Byte: visualizza il numero di byte.
Di seguito è riportato un breve riepilogo dei flag:
- URG: Campo puntatore urgente significativo
- ACK: campo di riconoscimento significativo
- PSH: Funzione push
- RST: Reimpostare la connessione
- SYN: Sincronizzare i numeri di sequenza
- FIN: Nessun altro dato dal mittente
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 network list-firewall-rules
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
Ruleset IsValid SourceIp SourceMask DestinationIp DestinationMask UID Action InterfaceInName TcpInv Protocol SourcePortRange DestinationPortRange Packets Bytes TcpMask TcpCmp
=====================================================================================================================================================================================================
PREROUTING False None None None None None None None None None None None None None None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False any 0-65535 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept True tcp 0-65535 0-65535 823 394754 syn,ack syn
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True 192.168.35.1 <value> <value> <value> <value> accept azspheresvc False any 0-65535 0-65535 15 780 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
network list-interfaces
Elenca le interfacce di rete per il dispositivo collegato.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 network list-interfaces
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
InterfaceName InterfaceUp ConnectedToNetwork IpAcquired IpAddresses ConnectedToInternet IpAssignment HardwareAddress
========================================================================================================================
azspheresvc True False False <value> False None None
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
eth0 True True True <value> True dynamic <value>
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
lo True False False <value> False None None
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
wlan0 True True True <value> True dynamic <value>
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
proxy di rete
Gestisce l'uso dell'indirizzo proxy per la connessione di rete. Per altre informazioni sulla configurazione di un dispositivo Azure Sphere per la connessione a Internet tramite un server proxy, vedere Connettersi tramite un server proxy.
Nota
Attualmente sono supportati solo i proxy HTTP.
| Operazione | Descrizione |
|---|---|
| proxy apply | Configura il proxy di rete nel dispositivo collegato. |
| eliminazione proxy | Elimina la connessione proxy nel dispositivo collegato. |
| proxy show | Mostra la connessione proxy nel dispositivo collegato. |
proxy apply
Configura il proxy di rete nel dispositivo collegato.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -a, --address | String | Specifica l'indirizzo di rete del proxy da usare. |
| -t, --authentication | String | Specifica il tipo di autenticazione da usare. Valori consentiti: anonymous o basic. Se il proxy richiede un nome utente e una password, impostarlo su basic, in caso contrario usare anonymous. |
| -r, --port | Intero | Specifica la porta sull'indirizzo di rete da usare. Il valore deve essere uguale o minore di 65535. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| --abilitare | String | Specifica se il proxy deve essere abilitato. È necessario impostare --enable o --disable. |
| --disabilitare | String | Specifica se il proxy deve essere disabilitato. È necessario impostare --enable o --disable. |
| -n, --no-proxy-addresses | String | Specifica una matrice di indirizzi di rete separati da spazi che il dispositivo deve evitare per la connessione proxy. |
| -p, --password | String | Specifica la password per l'autenticazione proxy usata solo per l'autenticazione di base. Lunghezza massima: 64 caratteri. |
| -u, --username | String | Specifica il nome utente per l'autenticazione proxy. Usato solo per l'autenticazione di base. Lunghezza massima: 64 caratteri. |
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 network proxy apply --address contoso.com --authentication anonymous --port 8080 --enable
----------- ------- ----- ------------------ ----------------
Address Enabled Port AuthenticationType NoProxyAddresses
=============================================================
contoso.com True 8080 anonymous
----------- ------- ----- ------------------ ----------------
eliminazione proxy
Elimina la connessione proxy nel dispositivo collegato.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 network proxy delete
proxy show
Mostra la connessione proxy nel dispositivo collegato.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 network proxy show
----------- ------- ----- ------------------ ----------------
Address Enabled Port AuthenticationType NoProxyAddresses
=============================================================
contoso.com True 8080 anonymous
----------- ------- ----- ------------------ ----------------
network show-diagnostics
Mostra la diagnostica per una o tutte le reti Wi-Fi nel dispositivo collegato.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| -n, --network | Intero | Specifica l'ID della rete Wi-Fi per cui visualizzare la diagnostica. |
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 network show-diagnostics
------------------------- --------- ----- ------------- --------------- --------
Timestamp NetworkId Ssid ConfigState ConnectionState Error
================================================================================
2021-06-16T20:51:29+00:00 0 <value> temp-disabled disconnected WrongKey
------------------------- --------- ----- ------------- --------------- --------
network show-status
Mostra lo stato di rete per il dispositivo collegato.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 network show-status
--------------------------- --------------- -----
DeviceAuthenticationIsReady NetworkTimeSync Proxy
=================================================
True complete ready
--------------------------- --------------- -----
network update-interface
Aggiorna l'interfaccia di rete Ethernet per il dispositivo. Per altre informazioni sull'impostazione dell'indirizzo MAC per il dispositivo, vedere Configurare il dispositivo per Ethernet.
Nota
Questo comando è supportato per la configurazione delle connessioni Ethernet eth0 . Se si configura lo, azspheresvc o wlan0viene restituito un errore.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| --hardware-address | String | Specifica l'indirizzo hardware da impostare per il dispositivo in uno dei formati seguenti: AA:BB:33:DD:EE:FF o aa:bb:33:dd:ee:ff. |
| --interfaccia o --interface-name [Ritiro] |
String | Specifica il nome dell'interfaccia da configurare. Eseguire azsphere device network list-interfaces per visualizzare i dettagli delle interfacce di rete per il dispositivo collegato. L'argomento --interface-name verrà ritirato e verrà rimosso in una versione futura. Per altre informazioni, vedere Modifiche importanti (ritiro delle funzionalità) nell'interfaccia della riga di comando di Azure Sphere. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 network update-interface --interface eth0 --hardware-address ba:98:76:54:32:10
recover
Sostituisce il software del sistema nel dispositivo.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. Specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo. |
| -c, --capability | String | Specifica l'immagine della funzionalità del dispositivo da applicare al dispositivo durante il ripristino. |
| -i, --images | String | Specifica il percorso di una cartella che contiene i pacchetti di immagini da scrivere nel dispositivo. Per impostazione predefinita, il ripristino usa le immagini nell'SDK, a meno che non si specifichi un percorso alternativo con questo flag. |
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 1:
azsphere device recover
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 17 images. (5443272 bytes to send)
Sent 1 of 17 images. (5440896 of 5443272 bytes remaining)
Sent 2 of 17 images. (5414844 of 5443272 bytes remaining)
Sent 3 of 17 images. (5311892 of 5443272 bytes remaining)
Sent 4 of 17 images. (5311500 of 5443272 bytes remaining)
Sent 5 of 17 images. (5041520 of 5443272 bytes remaining)
Sent 6 of 17 images. (5024908 of 5443272 bytes remaining)
Sent 7 of 17 images. (4994856 of 5443272 bytes remaining)
Sent 8 of 17 images. (2397456 of 5443272 bytes remaining)
Sent 9 of 17 images. (885796 of 5443272 bytes remaining)
Sent 10 of 17 images. (861220 of 5443272 bytes remaining)
Sent 11 of 17 images. (758608 of 5443272 bytes remaining)
Sent 12 of 17 images. (135796 of 5443272 bytes remaining)
Sent 13 of 17 images. (70048 of 5443272 bytes remaining)
Sent 14 of 17 images. (41164 of 5443272 bytes remaining)
Sent 15 of 17 images. (32768 of 5443272 bytes remaining)
Sent 16 of 17 images. (16384 of 5443272 bytes remaining)
Sent 17 of 17 images. (0 of 5443272 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.
Esempio 2:
azsphere device recover --capability "C:\Users\capability file\capability_352FE1F_5.bin"
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 16 images. (5474668 bytes to send)
Sent 1 of 16 images. (5447384 of 5474668 bytes remaining)
Sent 2 of 16 images. (5343788 of 5474668 bytes remaining)
Sent 3 of 16 images. (5343396 of 5474668 bytes remaining)
Sent 4 of 16 images. (5073416 of 5474668 bytes remaining)
Sent 5 of 16 images. (5056612 of 5474668 bytes remaining)
Sent 6 of 16 images. (5026240 of 5474668 bytes remaining)
Sent 7 of 16 images. (2479376 of 5474668 bytes remaining)
Sent 8 of 16 images. (889892 of 5474668 bytes remaining)
Sent 9 of 16 images. (865316 of 5474668 bytes remaining)
Sent 10 of 16 images. (754512 of 5474668 bytes remaining)
Sent 11 of 16 images. (135796 of 5474668 bytes remaining)
Sent 12 of 16 images. (70048 of 5474668 bytes remaining)
Sent 13 of 16 images. (41164 of 5474668 bytes remaining)
Sent 14 of 16 images. (32768 of 5474668 bytes remaining)
Sent 15 of 16 images. (16384 of 5474668 bytes remaining)
Sent 16 of 16 images. (0 of 5474668 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.
ripetere l'analisi collegata
Analizza nuovamente i dispositivi collegati eseguendo il ciclo automatico di tutte le porte FTDI e visualizza il numero totale di dispositivi collegati. Usare questo comando per la risoluzione dei problemi di connessione del dispositivo in Windows. Questo comando viene eseguito solo in Windows.
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 rescan-attached
-----------
Count
===========
2
-----------
restart
Riavvia il dispositivo collegato.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 restart
Restarting device.
Device restarted successfully.
show
Visualizza i dettagli di un dispositivo collegato nel tenant di Azure Sphere.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando. Questo parametro è obbligatorio quando vengono collegati più dispositivi o quando non è collegato alcun dispositivo. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare un ID dispositivo per un dispositivo non collegato oppure specificare l'indirizzo IP o l'ID connessione locale di un dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| -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 show
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
========================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
È possibile usare il --query parametro per personalizzare l'output visualizzato per questo comando. Per altre informazioni, vedere Output dei comandi dell'interfaccia della riga di comando di query.
L'esempio seguente illustra come selezionare solo l'ID dispositivo e l'ID prodotto:
azsphere device show --device 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 --query '{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
show-attached
Consente di visualizzare informazioni relative al dispositivo collegato dal dispositivo stesso. Questi dettagli differiscono da quelli che il servizio di sicurezza di Azure Sphere archivia per il dispositivo.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 show-attached
Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
IP address: 192.128.48.1
Connection path: 21143
show-deployment-status
Mostra lo stato di distribuzione degli aggiornamenti dell'applicazione e del sistema operativo per il dispositivo.
Usare questo comando per scoprire la versione del sistema operativo di Azure Sphere in esecuzione nel dispositivo o per ottenere informazioni sul completamento dell'aggiornamento della distribuzione corrente.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| -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 show-deployment-status
Your device is running Azure Sphere OS version <version-number>.
The Azure Sphere Security Service is targeting this device with Azure Sphere OS version <version-number>.
Your device has the expected version of the Azure Sphere OS: <version-number>.
In questo esempio il <numero> di versione rappresenta la versione corrente del sistema operativo.
show-count
Mostra il numero di dispositivi nel tenant corrente.
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 show-count
------
Result
======
2
------
show-os-version
Mostra la versione corrente del sistema operativo nel dispositivo collegato.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 show-os-version
Your device is running Azure Sphere OS version <version-number>
In questo esempio il <numero> di versione rappresenta la versione corrente del sistema operativo.
sideload
Gestisce l'applicazione nel dispositivo.
Alcune opzioni di trasferimento locale richiedono funzionalità aggiuntive quando il dispositivo si trova nello stato di produzione DeviceComplete. La funzionalità fieldServicing consente di distribuire ed eliminare immagini temporanee firmate dall'ambiente di produzione e di distribuire immagini permanenti firmate dall'ambiente di produzione. La funzionalità appDevelopment consente di distribuire ed eliminare sia immagini firmate dall'SDK sia firmate dall'ambiente di produzione.
| Operazione | Descrizione |
|---|---|
| delete | Elimina l'applicazione corrente dal dispositivo. |
| deploy | Carica un'applicazione nel dispositivo. |
| set-deployment-timeout | Imposta il periodo di timeout della distribuzione in secondi. |
| show-deployment-timeout | Mostra il periodo di timeout della distribuzione in secondi. |
Si noti che i parametri in start, stop, show-statuse show-quota sono stati spostati nel comando azsphere device app .
sideload delete
Elimina le applicazioni dal dispositivo.
Questo comando è disponibile solo se la funzionalità del dispositivo appDevelopment è configurata.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -i, --component-id | GUID | Specifica l'ID dell'applicazione da eliminare dal dispositivo. Se omesso, elimina tutte le applicazioni. |
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 sideload delete
Component '54acba7c-7719-461a-89db-49c807e0fa4d' deleted.
sideload deploy
Carica un'applicazione nel dispositivo collegato e la avvia.
Questo comando non può essere eseguito se il manifesto dell'applicazione richiede una risorsa che è già in uso da un'applicazione presente sul dispositivo. In questo caso, usare azsphere device sideload delete per eliminare l'applicazione esistente e quindi ripetere l'operazione. Il comando azsphere device sideload delete elimina sia applicazioni di alto livello che applicazioni in tempo reale. Per eliminare un'applicazione e lasciare l'altra, specificare l'ID componente dell'applicazione da eliminare.
Lo stesso comando viene usato per distribuire sia le applicazioni di alto livello che le applicazioni con operazioni in tempo reale.
Nota
Un riavvio del dispositivo viene attivato quando viene installata una nuova applicazione che usa periferiche e vengono soddisfatte le condizioni seguenti:
- Lo stato di produzione del dispositivo è impostato su DeviceComplete.
- La funzionalità appDevelopment non è presente nel dispositivo. Per altre informazioni, vedere Blocco della configurazione delle periferiche.
Se viene avviato un riavvio del dispositivo, attendere il completamento del riavvio e il dispositivo diventa reattivo.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -p, --image-package | String | Specifica il percorso e il nome del file del pacchetto di immagini da caricare nel dispositivo. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| -m, --manual-start | Booleano | Specifica di non avviare automaticamente l'applicazione dopo il caricamento. |
| --force | Booleano | Forza la distribuzione di un'immagine che usa un'API Beta che potrebbe non essere più supportata. |
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 sideload deploy --image-package C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
Deploying 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' to the attached device.
Image package 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' has been deployed to the attached device.
sideload set-deployment-timeout
Imposta il valore di timeout della distribuzione in secondi per il trasferimento locale delle immagini nel dispositivo.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -v, --value | Intero | Specifica la durata in secondi prima del timeout di un comando di trasferimento locale. Il valore deve essere un numero intero positivo. |
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 sideload set-deployment-timeout --value 60
------------------
Deployment timeout
==================
60
------------------
sideload show-deployment-timeout
Visualizza il valore di timeout della distribuzione corrente in secondi per il trasferimento locale delle immagini nel dispositivo.
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 sideload show-deployment-timeout
------------------
Deployment timeout
==================
60
------------------
update
Sposta il dispositivo in un altro gruppo di dispositivi nel tenant di Azure Sphere.
Oltre ai gruppi di dispositivi creati in un prodotto, vengono aggiunti cinque gruppi di dispositivi predefiniti quando viene creato un prodotto:
- Sviluppo: accetta solo gli aggiornamenti software di sistema. Non accetta gli aggiornamenti dell'applicazione.
- Test sul campo: accetta tutti gli aggiornamenti dal servizio di sicurezza di Azure Sphere.
- Produzione: accetta tutti gli aggiornamenti dal servizio di sicurezza di Azure Sphere.
- Valutazione del sistema operativo di produzione: accetta tutti gli aggiornamenti dal servizio di sicurezza di Azure Sphere.
- Valutazione del sistema operativo di test sul campo: accetta tutti gli aggiornamenti dal servizio di sicurezza di Azure Sphere.
Per altre informazioni sugli elementi fondamentali coinvolti nella distribuzione, vedere Nozioni di base sulla distribuzione.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -g, --device-group | GUID o nome | Specifica il gruppo di dispositivi in cui spostare il dispositivo. È 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. |
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando. Questo parametro è obbligatorio quando vengono collegati più dispositivi o quando non è collegato alcun dispositivo. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare un ID dispositivo per un dispositivo non collegato oppure specificare l'indirizzo IP o l'ID connessione locale di un dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| -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 update --device-group AW100/Marketing
------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
==============================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
427D205E46A166B7E41135EB968
------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
È possibile usare il --query parametro per personalizzare l'output visualizzato per questo comando. Per altre informazioni, vedere Output dei comandi dell'interfaccia della riga di comando di query.
L'esempio seguente illustra come selezionare solo l'ID dispositivo e l'ID prodotto:
azsphere device update --device-group AW100/Marketing --query '{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
wifi
Gestisce le configurazioni Wi-Fi per il dispositivo collegato.
Per usare il dispositivo in una rete Wi-Fi, è necessario aggiungere informazioni sulla rete e abilitare la rete nel dispositivo. Anche se per i nomi delle reti è possibile immettere caratteri non ASCII, azsphere non li visualizza correttamente.
Se l'applicazione usa l'API di configurazione Wi-Fi, è necessario includere anche la funzionalità WifiConfig nel file di app_manifest.json dell'applicazione.
| Operazione | Descrizione |
|---|---|
| add | Aggiunge i dettagli di una rete wireless nel dispositivo. |
| disable | Disabilita una rete wireless dal dispositivo. |
| enable | Abilita una rete wireless nel dispositivo. |
| forget | Rimuove i dettagli di una rete wireless dal dispositivo. |
| list | Elenca l'attuale configurazione Wi-Fi del dispositivo. |
| reload-config | Ricarica la configurazione Wi-Fi del dispositivo. |
| scan | Esegue la ricerca delle reti disponibili. |
| show | Visualizza i dettagli di una configurazione Wi-Fi. |
| show-status | Consente di visualizzare lo stato dell'interfaccia wireless. |
wifi add
Aggiunge i dettagli di una rete Wi-Fi al dispositivo collegato.
Un dispositivo può avere più connessioni Wi-Fi. Anche se per i nomi delle reti è possibile immettere caratteri non ASCII, azsphere non li visualizza correttamente.
È possibile includere il --targeted-scan parametro per connettersi a unità SSD nascoste. Per altre informazioni, vedere Connettere Azure Sphere a Wi-Fi.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -s, --ssid | String | Specifica l'identificatore SSID della rete. I SSID distinguono tra maiuscole e minuscole. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| --client-cert-id | String | [EAP-TLS] Specifica l'identificatore (fino a 16 caratteri) che identifica il certificato client (contenente sia la chiave pubblica che quella privata). Obbligatorio per configurare una rete EAP-TLS. |
| --client-id <user@domain> | String | [EAP-TLS] Specifica l'ID riconosciuto per l'autenticazione dal server RADIUS della rete. Obbligatorio per alcune reti EAP-TLS. |
| --config-name | String | Specifica una stringa (fino a 16 caratteri) che specifica il nome per la configurazione di rete. |
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
| --root-ca-cert-id | String | [EAP-tLS] Specifica l'identificatore (fino a 16 caratteri) che identifica il certificato CA radice del server per le reti EAP-TLS in cui il dispositivo autentica il server. |
| --targeted-scan | Booleano | Prova a connettersi a una rete anche quando questa non trasmette o è nascosta dalla congestione della rete. |
| -p, --psk | String | Specifica la chiave WPA o WPA2 per la nuova rete. Omettere per aggiungere l'SSID come una rete aperta. Se la chiave contiene una e commerciale (&), racchiudere la chiave tra virgolette. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
azsphere device wifi add --ssid MyNetwork --psk MyPassword
Successfully added network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
1 MyNetwork enabled unknown psk False
----- -------- ------------------ --------------- ------------- ------------
Se l'SSID o la chiave di rete ha spazi incorporati o una e commerciale, racchiudere il SSID o la chiave tra virgolette singole. Se l'SSID o la chiave includono una virgoletta, usare una barra rovesciata per annullare le virgolette. Le barre rovesciate non devono essere precedute da un carattere di escape se fanno parte di un valore. Per altre informazioni, vedere Virgolette e caratteri di escape. Ad esempio:
azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"
wifi disable
Disabilita una rete Wi-Fi nel dispositivo collegato.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -i, --id | Intero | Specifica l'ID della rete da disabilitare. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 wifi disable --id 0
Successfully disabled network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0 MyNetwork disabled disconnected psk False
----- -------- ------------------ --------------- ------------- ------------
wifi enable
Abilita una rete Wi-Fi nel dispositivo collegato.
Per cambiare rete nel caso in cui ne sia disponibile più di una, disabilitare la rete attualmente connessa prima di abilitare la nuova.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -i, --id | Intero | Specifica l'ID della rete da abilitare. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 wifi enable --id 0
Successfully enabled network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0 MyNetwork enabled disconnected psk False
----- -------- ------------------ --------------- ------------- ------------
wifi forget
Rimuove i dettagli di una rete Wi-Fi dal dispositivo collegato.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -i, --id | Intero | Specifica l'ID della rete da eliminare. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 wifi forget --id 0
Successfully forgotten network.
wifi list
Elenca la configurazione Wi-Fi corrente per il dispositivo collegato.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 wifi list
----- --------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
=============================================================================
0 MyNetwork1 enabled connected psk False
----- --------- ------------------ --------------- ------------- ------------
1 MyNetwork2 enabled disconnected psk False
----- --------- ------------------ --------------- ------------- ------------
2 MyNetwork3 enabled disconnected eaptls False
----- --------- ------------------ --------------- ------------- ------------
wifi reload-config
Ricarica la configurazione di rete Wi-Fi nel dispositivo collegato. Usare questo comando dopo aver aggiunto o rimosso un certificato (azsphere device certificate) per assicurarsi che le reti EAP-TLS usino il contenuto più recente dell'archivio certificati.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 wifi reload-config
Wi-Fi configuration was successfully reloaded.
wifi scan
Cercare le reti Wi-Fi disponibili visibili al dispositivo collegato. Il comando restituisce fino a 64 reti Wi-Fi, ma il numero di reti Wi-Fi visualizzate può essere limitato da fattori ambientali come la densità dei punti di accesso nell'intervallo.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 wifi scan
----------------- ------------- ----------------- ----------- ---------
SSID SecurityState BSSID SignalLevel Frequency
=======================================================================
MyNetwork0 psk <value> -66 2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork1 psk <value> -75 2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork2 psk <value> -86 2412
----------------- ------------- ----------------- ----------- ---------
wifi show
Mostra i dettagli di una rete Wi-Fi nel dispositivo collegato.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| -i, --id | Intero | Specifica l'ID della configurazione di rete da visualizzare. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 wifi show --id 0
----- --------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
=============================================================================
0 MyNetwork enabled disconnected psk False
----- --------- ------------------ --------------- ------------- ------------
wifi show-status
Mostra lo stato dell'interfaccia Wi-Fi nel dispositivo collegato.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -d, --device | String | Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene usato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. L'interfaccia della riga di comando di Azure Sphere supporta più dispositivi MT3620 in Windows, ma è possibile connettere un solo dispositivo alla volta in Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando in Linux, viene restituito un errore. |
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 wifi show-status
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
SSID ConfigurationState ConnectionState SecurityState Frequency Mode KeyManagement WpaState IpAddress MacAddress
================================================================================================================================
<value> enabled connected psk 2412 station WPA2-PSK COMPLETED <value> <value>
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------