Condividi tramite

Visualizzare informazioni sul dispositivo

  • Articolo

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).

Un tenant di Azure Sphere può contenere migliaia di dispositivi e la gestione dei dispositivi richiede un metodo per ottenere informazioni dettagliate su ognuno di essi. Usando i comandi dell'interfaccia della riga di comando, è possibile elencare informazioni su dispositivi, prodotti e gruppi di dispositivi in un tenant. È anche possibile reindirizzare l'output standard di un comando a un file per una revisione dettagliata.

È anche possibile usare i comandi dell'interfaccia della riga di comando per scaricare informazioni di diagnostica e configurazione, dati sugli errori e altri eventi che interessano i dispositivi.

Reindirizzare o impaginare i risultati

L'interfaccia della riga di comando di Azure Sphere fornisce i comandi seguenti per elencare informazioni sui dispositivi, i prodotti e i gruppi di dispositivi in un tenant.

Questi comandi possono restituire un elenco di elementi di grandi dimensioni che possono essere reindirizzati o impaginati. Questa sezione descrive i diversi modi per reindirizzare o impaginare l'output da entrambe le interfacce della riga di comando.

Interfaccia della riga di comando di Azure Sphere

L'interfaccia della riga di comando di Azure Sphere non supporta l'impaginazione interattiva. È tuttavia possibile impaginare l'output sullo schermo tramite pipe agli strumenti di impaginazione esistenti.

Ad esempio:

  • In PowerShell (Windows): azsphere device list | Out-Host –Paging
  • Al prompt dei comandi (Windows): azsphere device list | more
  • Nella shell Bash (Linux): azsphere device list | less

Nota

Questa operazione può essere potenzialmente lenta a seconda della quantità di dati restituiti.

È anche possibile reindirizzare l'output standard di un comando a un file. Nell'esempio seguente l'output standard viene inviato a output.txt e l'errore standard viene inviato a logs.txt.

azsphere device list --verbose > output.txt 2> logs.txt

Interfaccia della riga di comando classica di Azure Sphere

L'azione predefinita di questi comandi consiste nel restituire una pagina di record alla volta, in cui le dimensioni della pagina sono in genere impostate su 100 record. Alla fine di ogni pagina di risultati è presente un messaggio che indica di premere un tasto qualsiasi per continuare la visualizzazione con la pagina di risultati successiva. Le dimensioni della pagina vengono modificate automaticamente in base a fattori come l'attività del database e la larghezza di banda di rete disponibile.

È possibile reindirizzare i risultati di un comando list a un file con valori delimitati da virgole (CSV) per una revisione approfondita specificando un percorso e un nome di file per --output il parametro e aggiungendo il --noninteractive parametro al comando. Il --noninteractive parametro rimuove la paginazione dai risultati in modo che l'intero elenco venga acquisito nel file CSV senza dover continuare manualmente alla fine di ogni pagina.

Visualizzare informazioni per il supporto

I comandi usati per ottenere informazioni di supporto variano a seconda che si raccolgono dati di supporto tecnico per un singolo dispositivo Azure Sphere quando si lavora con il supporto Microsoft o restituiscano dati in caso di condizioni di errore che coinvolgono le applicazioni in esecuzione nei dispositivi all'interno di un tenant. Nella maggior parte degli scenari, si eseguiranno query sul tenant per rilevare le condizioni di errore in tutti i dispositivi usando il comando azsphere tenant download-error-report. Questo metodo richiede la comunicazione del servizio di sicurezza Azure Sphere con i dispositivi tramite una connessione Internet per raccogliere gli eventi corrispondenti.

get-support-data

Il comando azsphere get-support-data raccoglie e genera file di log contenenti informazioni di diagnostica e configurazione dal computer, dal cloud e dal dispositivo Azure Sphere collegato. Le informazioni contenute in questi file di log possono essere usate per aiutare l'utente o il team di supporto tecnico a analizzare e risolvere i problemi. Usare il --destination parametro per specificare il percorso e il nome file del file .zip in cui salvare i dati di supporto. È possibile specificare un percorso relativo o assoluto.

download-error-report

Il comando azsphere tenant download-error-report restituisce informazioni sugli errori segnalati dai dispositivi all'interno di un tenant. I dati degli eventi vengono estratti dal cloud del servizio di sicurezza di Azure Sphere e non richiedono una connessione fisica a un determinato dispositivo. Il comando funziona nel contesto del tenant corrente e restituisce le segnalazioni degli errori per tutti i dispositivi all'interno di tale tenant.

Usare il --destination parametro per specificare il percorso e il nome file del file .csv in cui salvare i dati di supporto. È possibile specificare un percorso relativo o assoluto.