Visualizzare informazioni sul dispositivoDisplay device information

Un tenant di Azure Sphere può contenere migliaia di dispositivi, la cui gestione richiede un metodo per ottenere informazioni dettagliate su ognuno.An Azure Sphere tenant may contain thousands of devices, and managing the devices requires a method to obtain detailed information about each of them. Un'ampia gamma di comandi può visualizzare i dispositivi in un tenant o in un gruppo di dispositivi. questi comandi possono reindirizzare i risultati in un file delimitato da virgole per una revisione dettagliata.A variety of commands can display the devices in a tenant or device group, and these commands can redirect the results into a comma-delimited file for detailed review. Inoltre, può essere utile per restituire un elenco di condizioni di errore per tutti i dispositivi all'interno del tenant.Additionally, it can be useful to return a list of error conditions for all of the devices within the tenant. Questo articolo descrive come ottenere questi elenchi.This article describes how to obtain these lists.

Paginazione e reindirizzamento di risultatiPaging and result redirection

L'utilità dell'interfaccia della riga di comando di Azure Sphere offre diverse opzioni per ottenere informazioni sui dispositivi inclusi in gruppi, prodotti e tenant.The Azure Sphere command line interface (CLI) utility provides several options for returning information about the devices within groups, products, and tenants. Poiché potrebbero essere presenti centinaia o migliaia di dispositivi Azure Sphere all'interno di ogni gruppo, prodotto o tenant, è importante essere in grado di visualizzare set di risultati di grandi dimensioni.Because there might be hundreds or thousands of Azure Sphere devices within each group, product, or tenant, it is important to be able to display large result sets. La paginazione dei risultati è disponibile per i comandi seguenti:Pagination of results is available for the following commands:

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.The default action of these commands is to return a page of records at one time, where the page size is typically set to 100 records. 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.At the bottom of each page of results is a message to press any key to continue the display with the next page of results. Le dimensioni della pagina vengono modificate automaticamente in base a fattori come l'attività del database e la larghezza di banda di rete disponibile.Page size is adjusted automatically based on factors such as database activity and available network bandwidth.

Reindirizzamento dei risultati in un fileRedirecting results to a file

È 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 file per il parametro --output e aggiungendo il parametro --noninteractive al comando.You can redirect the results of a list command to a comma-separated values (CSV) file for in-depth review by specifying a path and file name for the --output parameter, and by adding the --noninteractive parameter to the command. Il parametro --noninteractive rimuove la paginazione dai risultati in modo che l'intero elenco venga acquisito nel file CSV senza che sia necessario continuare manualmente alla fine di ogni pagina.The --noninteractive parameter removes the pagination from the results so the entire list is captured in the CSV file without the need to manually continue at the end of each page.

Visualizzare informazioni per il supportoDisplay information for support

Il comando usato per ottenere le informazioni di supporto varia a seconda che si raccolgano dati del supporto clienti per un singolo dispositivo Azure Sphere quando si collabora con il supporto Microsoft o che vengano restituiti dati sulle condizioni di errore riguardanti le applicazioni in esecuzione nei dispositivi all'interno di un tenant.The command used to obtain support information will depend on whether you are gathering customer support data for a single Azure Sphere device when working with Microsoft support, or returning data on error conditions involving the applications running on devices within a 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.In most scenarios, you will be querying the tenant for error conditions on all devices using the azsphere tenant download-error-report command. Questo metodo richiede la comunicazione del servizio di sicurezza Azure Sphere con i dispositivi tramite una connessione Internet per raccogliere gli eventi corrispondenti.This method will depend on the Azure Sphere Security Service communication with the devices through an internet connection to gather the matching events.

get-support-dataget-support-data

Per ottenere informazioni sugli errori da un dispositivo Azure Sphere collegato, usare il comando azsphere get-support-data.To obtain error information from an attached Azure Sphere device, use the azsphere get-support-data command. Il comando azsphere get-support-data restituisce una serie di informazioni dal dispositivo collegato localmente che possono essere utili per la risoluzione dei problemi e che potrebbero essere richieste da Microsoft per risolvere i problemi di supporto.The azsphere get-support-data command returns a variety of information from the locally attached device that may be useful for troubleshooting, and that may be requested by Microsoft to resolve support issues.

download-error-reportdownload-error-report

Per ottenere informazioni sugli errori per tutti i dispositivi all'interno di un tenant, usare il comando azsphere tenant download-error-report.To obtain error information for all devices within a tenant, use the azsphere tenant download-error-report command. Poiché questo comando restituisce informazioni sulle condizioni di errore in tutti i dispositivi nel tenant, il parametro --output reindirizza i risultati in un file CSV.Because this command returns information about error conditions on all devices in the tenant, the --output parameter redirects the results to a CSV file.

Il comando azsphere tenant download-error-report può essere usato da qualsiasi ruolo utente con almeno le autorizzazioni di lettura nel tenant (ruoli lettore e collaboratore, oltre ad amministratori).The azsphere tenant download-error-report command can be used by any user role with at least Read permissions in the tenant (reader and contributor roles, as well as administrators).