Afficher les informations de l’appareil

  • Article

Un locataire Azure Sphere peut contenir des milliers d’appareils, et la gestion des appareils nécessite une méthode pour obtenir des informations détaillées sur chacun d’eux. À l’aide des commandes CLI, vous pouvez répertorier des informations sur les appareils, les produits et les groupes d’appareils dans un locataire. Vous pouvez également rediriger la sortie standard d’une commande vers un fichier pour une révision détaillée.

Vous pouvez également utiliser les commandes CLI pour télécharger des informations de diagnostic et de configuration, des données sur les erreurs et d’autres événements qui affectent vos appareils.

Rediriger ou paginer les résultats

L’interface de ligne de commande (CLI) Azure Sphere fournit les commandes suivantes pour répertorier les informations sur les appareils, les produits et les groupes d’appareils dans un locataire.

Ces commandes peuvent retourner une liste volumineuse d’éléments qui peuvent être redirigés ou paginés. Cette section décrit les différentes façons de rediriger ou de paginer la sortie des deux CLIs.

Azure Sphere CLI

L’interface CLI Azure Sphere ne prend pas en charge la pagination interactive. Toutefois, vous pouvez paginer la sortie à l’écran en la dirigeant vers les outils de pagination existants.

Par exemple :

  • Dans PowerShell (Windows) : azsphere device list | Out-Host –Paging
  • À l’invite de commandes (Windows) : azsphere device list | more
  • Dans l’interpréteur de commandes Bash (Linux) : azsphere device list | less

Note

Cette opération peut être potentiellement lente en fonction de la quantité de données retournées.

Vous pouvez également rediriger la sortie standard d’une commande vers un fichier. Dans l’exemple suivant, la sortie standard est envoyée à output.txt et l’erreur standard est envoyée à logs.txt.

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

Azure Sphere Classic CLI

L’action par défaut de ces commandes consiste à retourner une page d’enregistrements à la fois, où la taille de page est généralement définie sur 100 enregistrements. Au bas de chaque page de résultats se trouve un message indiquant d’appuyer sur n’importe quelle touche pour continuer l’affichage avec la page de résultats suivante. La taille de la page est ajustée automatiquement en fonction de facteurs tels que l’activité de la base de données et la bande passante réseau disponible.

Vous pouvez rediriger les résultats d’une commande de liste vers un fichier de valeurs séparées par des virgules (CSV) pour une révision approfondie en spécifiant un chemin d’accès et un nom de fichier pour --output le paramètre et en ajoutant le --noninteractive paramètre à la commande. Le --noninteractive paramètre supprime la pagination des résultats afin que la liste entière soit capturée dans le fichier CSV sans qu’il soit nécessaire de continuer manuellement à la fin de chaque page.

Afficher des informations pour la prise en charge

Les commandes utilisées pour obtenir des informations de support varient selon que vous collectez des données de support client pour un seul appareil Azure Sphere lorsque vous utilisez le support Microsoft ou que vous retournez des données sur des conditions d’erreur impliquant les applications s’exécutant sur des appareils au sein d’un locataire. Dans la plupart des scénarios, vous allez interroger le locataire à la recherche de conditions d’erreur sur tous les appareils à l’aide de la commande azsphere tenant download-error-report . Cette méthode dépend de la communication du service de sécurité Azure Sphere avec les appareils via une connexion Internet pour collecter les événements correspondants.

get-support-data

La commande azsphere get-support-data collecte et génère des fichiers journaux contenant des informations de diagnostic et de configuration à partir de votre ordinateur, du cloud et de l’appareil Azure Sphere attaché. Les informations contenues dans ces fichiers journaux peuvent être utilisées pour vous aider, vous ou l’équipe de support technique, à analyser et à résoudre les problèmes. Utilisez le --destination paramètre pour spécifier le chemin d’accès et le nom du fichier .zip dans lequel enregistrer les données de prise en charge. Vous pouvez fournir un chemin d’accès relatif ou absolu.

download-error-report

La commande azsphere tenant download-error-report retourne des informations sur les erreurs signalées par les appareils au sein d’un locataire. Les données d’événement sont extraites du cloud Azure Sphere Security Service et ne nécessitent pas de connexion physique à un appareil particulier. La commande fonctionne dans le contexte du locataire actuel et retourne des rapports d’erreurs pour tous les appareils au sein de ce locataire.

Utilisez le --destination paramètre pour spécifier le chemin d’accès et le nom du fichier .csv dans lequel enregistrer les données de prise en charge. Vous pouvez fournir un chemin d’accès relatif ou absolu.