Visualización de la información del dispositivo
Importante
Esta es la documentación de Azure Sphere (heredado). Azure Sphere (heredado) se retira el 27 de septiembre de 2027 y los usuarios deben migrar a Azure Sphere (integrado) en este momento. Use el selector de versiones situado encima de la TOC para ver la documentación de Azure Sphere (integrado).
Un inquilino de Azure Sphere puede contener miles de dispositivos y administrar los dispositivos requiere un método para obtener información detallada sobre cada uno de ellos. Con los comandos de la CLI, puede enumerar información sobre dispositivos, productos y grupos de dispositivos en un inquilino. También puede redirigir la salida estándar de un comando a un archivo para una revisión detallada.
También puede usar los comandos de la CLI para descargar información de diagnóstico y configuración, datos sobre los errores y otros eventos que afectan a los dispositivos.
Redirigir o paginar los resultados
La interfaz de la línea de comandos (CLI) de Azure Sphere proporciona los siguientes comandos para enumerar información sobre los dispositivos, los productos y los grupos de dispositivos de un inquilino.
- azsphere device-group device list muestra todos los dispositivos dentro de un grupo de dispositivos específico.
- azsphere device list muestra todos los dispositivos de un inquilino.
- azsphere product device list muestra todos los dispositivos de un producto.
Estos comandos pueden devolver una lista grande de elementos que se pueden redirigir o paginar. En esta sección se describen las distintas formas de redirigir o paginar la salida de ambas CLIs.
CLI de Azure Sphere
La CLI de Azure Sphere no admite la paginación interactiva. Sin embargo, puede paginar la salida en pantalla canalizando a las herramientas de paginación existentes.
Por ejemplo:
- En PowerShell (Windows):
azsphere device list | Out-Host –Paging - En un símbolo del sistema (Windows):
azsphere device list | more - En el shell de Bash (Linux):
azsphere device list | less
Nota:
Esta operación puede ser lenta en función de la cantidad de datos que se devuelvan.
También puede redirigir la salida estándar de un comando a un archivo. En el ejemplo siguiente, la salida estándar se envía a output.txt y el error estándar se envía a logs.txt.
azsphere device list --verbose > output.txt 2> logs.txt
CLI clásica de Azure Sphere
La acción predeterminada de estos comandos es devolver una página de registros a la vez, con un tamaño de página establecido habitualmente en 100 registros. En la parte inferior de cada página de resultados se muestra un mensaje que indica que se debe presionar cualquier tecla para continuar con la presentación de la siguiente página de resultados. El tamaño de página se ajusta automáticamente en función de factores como la actividad de la base de datos y el ancho de banda de red disponible.
Puede redirigir los resultados de un comando de lista a un archivo de valores separados por comas (CSV) para su revisión detallada especificando una ruta de acceso y un nombre de archivo para --output el parámetro y agregando el --noninteractive parámetro al comando. El --noninteractive parámetro quita la paginación de los resultados para que toda la lista se capture en el archivo CSV sin necesidad de continuar manualmente al final de cada página.
Visualización de información para soporte técnico
Los comandos usados para obtener información de soporte técnico dependerán de si está recopilando datos de soporte al cliente para un único dispositivo de Azure Sphere al trabajar con soporte técnico de Microsoft o devolviendo datos sobre condiciones de error que implican que las aplicaciones que se ejecutan en dispositivos dentro de un inquilino. En la mayoría de los escenarios, consultará el inquilino en busca de condiciones de error en todos los dispositivos con el comando azsphere tenant download-error-report. Este método dependerá de la comunicación del servicio de seguridad de Azure Sphere con los dispositivos mediante una conexión a Internet para recopilar los eventos coincidentes.
get-support-data
El comando azsphere get-support-data recopila y genera archivos de registro que contienen información de diagnóstico y configuración del equipo, la nube y el dispositivo de Azure Sphere conectado. La información de estos archivos de registro se puede usar para ayudarle o al equipo de soporte técnico a analizar y solucionar problemas.
Use el --destination parámetro para especificar la ruta de acceso y el nombre de archivo del archivo .zip en el que guardar los datos de soporte técnico. Puede proporcionar una ruta de acceso relativa o absoluta.
download-error-report
El comando azsphere tenant download-error-report devuelve información sobre los errores notificados por los dispositivos dentro de un inquilino. Los datos de eventos se extraen de la nube del servicio de seguridad de Azure Sphere y no requieren una conexión física a un dispositivo determinado. El comando funciona en el contexto del inquilino actual y devuelve informes de errores para todos los dispositivos de ese inquilino.
Use el --destination parámetro para especificar la ruta de acceso y el nombre de archivo del archivo .csv en el que guardar los datos de soporte técnico. Puede proporcionar una ruta de acceso relativa o absoluta.