Mostrar información del dispositivo
Un inquilino de Azure Sphere puede contener miles de dispositivos y la administración de los dispositivos requiere un método para obtener información detallada sobre cada uno de ellos. Con los comandos de la CLI, puede mostrar información sobre dispositivos, productos y grupos de dispositivos en un espacio empresarial. 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 sus dispositivos.
Redirigir o paginar resultados
La interfaz de línea de comandos (CLI) de Azure Sphere proporciona los siguientes comandos para mostrar información sobre los dispositivos, productos y grupos de dispositivos en un espacio empresarial.
- azsphere device-group device list muestra todos los dispositivos dentro de un grupo de dispositivos específico.
- azsphere device list muestra todos los dispositivos dentro de un espacio empresarial.
- la lista de dispositivos de producto azsphere muestra todos los dispositivos de un producto.
Estos comandos pueden devolver una gran lista de elementos que se pueden redirigir o paginar. En esta sección se describen las diferentes maneras de redirigir o paginar la salida de ambos CLIs.
Azure Sphere CLI
La CLI de Azure Sphere no admite paginación interactiva. Sin embargo, se puede paginar la salida en pantalla por tuberías a 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 Shell de Bash (Linux):
azsphere device list | less
Nota
Esta operación puede ser potencialmente lenta dependiendo de cuántos datos 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
Azure Sphere Classic CLI
La acción predeterminada de estos comandos es devolver una página de registros a la vez, donde el tamaño de página normalmente se establece en 100 registros. En la parte inferior de cada página de resultados hay un mensaje para presionar cualquier tecla para continuar la presentación con 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 list a un archivo de valores separados por comas (CSV) para una revisión en profundidad 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, por lo que la lista completa se captura en el archivo CSV sin necesidad de continuar manualmente al final de cada página.
Mostrar información de soporte técnico
Los comandos que se usan para obtener información de soporte técnico dependerán de si recopila datos de asistencia al cliente para un único dispositivo Azure Sphere al trabajar con el soporte técnico de Microsoft o si devuelve datos en condiciones de error relacionadas con las aplicaciones que se ejecutan en dispositivos dentro de un espacio empresarial. En la mayoría de los escenarios, consultará las condiciones de error del espacio empresarial en todos los dispositivos que usen 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 a través de 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 de su equipo, la nube y el dispositivo Azure Sphere adjunto. La información de estos archivos de registro puede usarse para ayudarle a usted 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 de .zip en el que desea 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 espacio empresarial. Los datos de eventos se extraen de la nube de Azure Sphere Security Service y no requieren una conexión física a un determinado dispositivo. El comando funciona en el contexto del inquilino actual y devuelve informes de errores para todos los dispositivos dentro de ese espacio empresarial.
Use el --destination parámetro para especificar la ruta de acceso y el nombre de archivo del archivo de .csv en el que desea guardar los datos de soporte técnico. Puede proporcionar una ruta de acceso relativa o absoluta.