Afficher les informations de l’appareil

Important

Il s’agit de la documentation Azure Sphere (héritée). Azure Sphere (hérité) prend sa retraite le 27 septembre 2027 et les utilisateurs doivent migrer vers Azure Sphere (intégré) pour l’instant. Utilisez le sélecteur de version situé au-dessus du TOC pour afficher la documentation Azure Sphere (intégrée).

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 Azure Sphere fournit les commandes suivantes pour répertorier les informations sur les appareils, les produits et les groupes d’appareils dans un locataire.

• azsphere device-group device list affiche tous les appareils au sein d’un groupe d’appareils spécifique.
• azsphere device list affiche tous les appareils au sein d’un locataire.
• azsphere product device list affiche tous les appareils au sein d’un produit.

Ces commandes peuvent retourner une grande liste 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.

Interface CLI Azure Sphere

Azure Sphere CLI ne prend pas en charge la pagination interactive. Toutefois, vous pouvez paginer la sortie à l’écran en pipant 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

Remarque

Cette opération peut être 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 est de retourner une page d’enregistrements à la fois, où la taille de la page est généralement définie sur 100 enregistrements. En bas de chaque page de résultats est affiché un message indiquant d’appuyer sur n’importe quelle touche pour poursuivre l’affichage avec la page de résultats suivante. La taille de la page est automatiquement ajustée 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 avoir à continuer manuellement à la fin de chaque page.

Afficher des informations pour le support technique

Les commandes utilisées pour obtenir des informations de support dépendent de la collecte des données de support client pour un seul appareil Azure Sphere lors de l’utilisation du support Microsoft, ou de retourner 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 pour connaître les 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 rassembler 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 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 support. Vous pouvez fournir un chemin 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 du service de sécurité Azure Sphere 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 support. Vous pouvez fournir un chemin relatif ou absolu.