device

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).

Gère les appareils Azure Sphere.

Operation	Description
app	Change l’état des applications d’un appareil.
capability	Gère les fonctionnalités de l’appareil.
certificate	Gère le magasin de certificats d’appareil.
claim	Déclare un appareil précédemment non revendiqué sur le locataire Azure Sphere.
enable-cloud-test	Configure un appareil pour désactiver le débogage et recevoir des mises à jour.
enable-development	Configure un appareil pour le débogage local.
image	Gère les images d’un appareil.
list	Affiche tous les appareils du locataire.
list-attached	Répertorie les appareils attachés.
fabrication-état	Gère l’état de fabrication de l’appareil attaché.
network	Fournit des informations sur l’état des interfaces réseau sur l’appareil.
recover	Utilise un mode de récupération spécial pour charger un nouveau microprogramme sur l’appareil.
rescand	Réanalyse les appareils attachés comme aide à la résolution des problèmes (Windows uniquement).
restart	Redémarre l’appareil attaché.
show	Affiche des détails sur la configuration de mise à jour de l’appareil.
show-attached	Affiche des détails sur l’appareil attaché à partir de l’appareil lui-même.
show-count	Affiche le nombre total d’appareils d’un locataire.
show-deployment-status	Affiche l’état de la mise à jour de déploiement la plus récente.
show-os-version	Affiche la version du système d’exploitation d’appareil local.
chargement indépendant	Charge une image sur l’appareil attaché.
mise à jour	Met à jour un appareil en le plaçant dans un groupe d’appareils spécifique.
wifi	Gère la configuration Wi-Fi pour l’appareil.

application

Gère les applications sur l’appareil.

La plupart des options d’application nécessitent la fonctionnalité appDevelopment, qui peut être acquise à l’aide d’azsphere device enable-development. Pour démarrer, arrêter ou déboguer une applications signée par un SDK ou une application signée en production, l’appareil doit avoir la fonctionnalité appDevelopment.

Vous pouvez utiliser l’arrêt de l’application d’appareil azsphere et l’application d’appareil azsphere commence à redémarrer une application en temps réel en cours d’exécution pour déterminer le cœur en temps réel sur lequel il s’exécute.

Operation	Description
show-memory-stats	Affiche les statistiques de mémoire des applications sur l’appareil attaché.
show-quota	Affiche la quantité de stockage utilisée par l’application actuelle sur l’appareil.
show-status	Retourne l’état de l’application actuelle sur l’appareil.
start	Démarre l’application qui est chargée sur l’appareil.
stop	Arrête l’application qui s’exécute sur l’appareil.

app show-memory-stats

Affiche les statistiques de mémoire des applications sur l’appareil attaché. Cette commande est disponible uniquement si la fonctionnalité d’appareil appDevelopment est configurée. Des informations supplémentaires s’affichent si le suivi de l’allocation de mémoire du tas est configuré.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device app show-memory-stats
 -------------- -------------
 Name           Usage (bytes)
 ============================
 Total          434176
 User Mode      147456
 Peak User Mode 147456
 -------------- -------------

app show-quota

Affiche la quantité de stockage mutable alloué et en cours d’utilisation sur l’appareil connecté.

Vous définissez le quota de stockage mutable dans le manifeste de l’application, et le système d’exploitation Azure Sphere applique des quotas lorsqu’il alloue des secteurs pour le fichier. Par conséquent, si vous diminuez la valeur MutableStorage, la quantité de stockage en cours d’utilisation ne change pas, mais la valeur allouée signalée est différente. Par exemple, si l’application a déjà utilisé 16 Ko et que vous remplacez la MutableStorage valeur par 8 Ko, la commande signale que l’application utilise 16 Ko d’allocation de 8 Ko. Les données restent sur l’appareil.

Paramètres facultatifs

Paramètre	Type	Description
-i, --component-id	GUID	Spécifie l’ID du composant pour lequel obtenir des informations sur le quota. S’il est omis, affiche des informations de quota pour tous les composants.
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device app show-quota
ae4714aa-03aa-492b-9663-962f966a9cc3: 0KB out of 8KB of mutable storage used.

app show-status

Affiche l’état actuel des applications sur l’appareil.

Paramètres facultatifs

Paramètre	Type	Description
-i, --component-id	GUID	Spécifie l’ID du composant pour lequel afficher l’état. Si ce paramètre est omis, affiche l’état de tous les composants.
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device app show-status
9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
App state: running

app start

Démarre les applications sur l’appareil.

Paramètres facultatifs

Paramètre	Type	Description
--debug-mode	Boolean	Démarre l’application en vue du débogage. Doit --component-id être fourni.
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
-i, --component-id	GUID	Spécifie l’ID du composant à démarrer. Si ce paramètre est omis, démarre toutes les applications.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device app start
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: running
Core     : High-level

app stop

Arrête les applications sur l’appareil.

Paramètres facultatifs

Paramètre	Type	Description
-i, --component-id	GUID	Spécifie l’ID du composant à arrêter. Si ce paramètre est omis, arrête toutes les applications.
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device app stop
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: stopped

capability

Gère les fonctionnalités de l’appareil. Les fonctionnalités de l’appareil déterminent quelles opérations peuvent être effectuées sur un appareil Azure Sphere.

Les fonctionnalités de l’appareil sont téléchargées en tant que fichier à partir du service de sécurité Azure Sphere à l’aide de la commande azsphere device capability download . Vous pouvez appliquer la configuration des capacités d’appareil à l’appareil Azure Sphere attaché à l’aide de la commande azsphere device capability update et créer une session de maintenance à l’aide de la commande azsphere device capability select. Pour plus d’informations sur les fonctionnalités de l’appareil, consultez Fonctionnalités et communication de l’appareil.

Operation	Description
télécharger	Télécharge une configuration de fonctionnalité d’appareil à partir du service de sécurité Azure Sphere.
select	Sélectionne un fichier de capacité téléchargé à utiliser pour une session de maintenance.
show-attached	Affiche la configuration de la fonctionnalité pour l’appareil attaché.
mise à jour	Applique la configuration d’une fonctionnalité d’appareil à l’appareil attaché.

capability download

Télécharge une fonctionnalité d’appareil à partir du service de sécurité Azure Sphere.

Avec la fonctionnalité appDevelopment, vous pouvez charger indépendamment des applications signées par un SDK sur l’appareil, ainsi que démarrer, arrêter, déboguer ou supprimer n’importe quelle application sur l’appareil. Sans la fonctionnalité appDevelopment, seules les applications chargées par le cloud peuvent être chargées, et le démarrage, l’arrêt, le débogage et la suppression ne sont pas autorisés. La fonctionnalité appDevelopment est appliquée par le biais de la commande azsphere device enable-development.

Le téléchargement de la fonctionnalité fieldServicing génère un fichier qui contient la fonctionnalité pour un appareil Azure Sphere spécifique. Le fichier de la fonctionnalité fieldServicing est téléchargé sur votre ordinateur local et peut être utilisé en combinaison avec la commande azsphere device capability select.

Paramètres obligatoires

Paramètre	Type	Description
--type	Type de capacité	Spécifie le type de fonctionnalité d’appareil à télécharger. Les valeurs sont appDevelopment, fieldServicing ou none. Utilisez none pour supprimer la fonctionnalité appDevelopment ou la fonctionnalité fieldServicing.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande. Ce paramètre est requis lorsque plusieurs appareils sont attachés ou lorsqu’aucun appareil n’est attaché. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez fournir un ID d’appareil pour un appareil non attaché, ou spécifier l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
--destination	Chaîne	Spécifie le chemin et le nom de fichier à utiliser pour enregistrer la configuration de la fonctionnalité. Incluez un chemin absolu ou relatif. Si vous ne fournissez pas de chemin d’accès, la commande stocke le fichier dans le répertoire local à l’aide du type de capacité de convention <d’affectation de noms huit< premiers caractères de device ID.cap>.>
-t, --tenant	GUID ou nom	Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device capability download --type appDevelopment
The appdevelopment capability was saved as:
 --------------------------------------------
 Result
 ============================================
 C:\capability-file\appdevelopment-<first eight characters of device ID>.cap
 --------------------------------------------

capability select

Sélectionne un fichier de fonctionnalité à utiliser avec l’appareil Azure Sphere attaché.

La commande azsphere device capability select peut être utilisée avec n’importe quelle fonctionnalité, mais elle est principalement utilisée avec la fonctionnalité fieldServicing pour activer une session de maintenance. Tous les rôles d’utilisateur ont accès à la commande azsphere device capability select.

Quand vous utilisez la fonctionnalité fieldServicing, la communication est activée entre l’appareil Azure Sphere et l’ordinateur local contenant le fichier de la fonctionnalité. Le fichier de la fonctionnalité fieldServicing est utilisé durant une session entre l’ordinateur local et l’appareil Azure Sphere, et chaque commande dans la session est précédée d’un message indiquant le nom du fichier de fonctionnalité utilisé.

Pour mettre fin à une session de maintenance, utilisez azsphere device capability select --none.

Paramètres facultatifs

Paramètre	Type	Description
--capability-file	Chaîne	Spécifie le chemin d’accès et le nom de fichier du fichier de configuration de la fonctionnalité d’appareil à sélectionner. Vous pouvez fournir un chemin relatif ou absolu.
-n, --none	-	Efface toute configuration de fonctionnalité de l’appareil mobile précédemment sélectionnée.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device capability select --capability-file appdevcap
The capability session uses C:\capability-file\appdevcap.

capability show-attached

Affiche la configuration de la fonctionnalité enregistrée sur l’appareil attaché.

Remarque

La commande affiche les fonctionnalités configurées à l’aide d’un fichier de capacité et certaines fonctionnalités, mais pas toutes, présentes par défaut sur les tableaux.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device capability show-attached
 --------------------
 DeviceCapabilities
 ====================
 EnableFieldServicing
 --------------------

azsphere device capability show-attached
 --------------------
 DeviceCapabilities
 ====================
 EnableAppDevelopment
 --------------------

capability update

Applique la configuration d’une fonctionnalité d’appareil à l’appareil attaché.

Paramètres obligatoires

Paramètre	Type	Description
--capability-file	Chaîne	Spécifie le chemin d’accès et le nom de fichier de capacité de l’appareil à appliquer. Vous pouvez fournir un chemin relatif ou absolu.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande. Ce paramètre est requis lorsque plusieurs appareils sont attachés ou lorsqu’aucun appareil n’est attaché. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez fournir un ID d’appareil pour un appareil non attaché, ou spécifier l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device capability update --capability-file appdevcap.bin
Using selected capability file: C:\capability-file\appdevcap.bin
The capability file C:\capability-file\appdevcap.bin was added on the device. The device will restart.

certificate

Gère les certificats sur l’appareil attaché.

Operation	Description
add	Ajoute un certificat au magasin de certificats sur l’appareil attaché.
delete	Supprime un certificat du magasin de certificats de l’appareil attaché.
list	Répertorie les ID de certificat disponibles dans le magasin de certificats de l’appareil attaché.
show	Affiche les détails d’un certificat dans le magasin de certificats de l’appareil attaché.
show-quota	Affiche l’espace libre disponible dans le magasin de certificats de l’appareil attaché.

certificate add

Ajoute un certificat au magasin de certificats de l’appareil attaché.

L’autorité de certification racine et les certificats clients doivent être au format .pem pour être chargés sur l’appareil Azure Sphere. Vous devez acquérir le certificat d’autorité de certification racine à partir du serveur approprié, ainsi que le certificat client et la clé privée (et éventuellement un mot de passe pour votre clé privée) pour votre appareil. Chaque certificat doit être généré et signé par le serveur approprié de votre réseau EAP-TLS. Votre administrateur réseau ou votre équipe de sécurité peut vous fournir les informations dont vous avez besoin pour obtenir les certificats. Pour plus d’informations sur l’acquisition du certificat d’autorité de certification racine, consultez Acquérir et déployer des certificats pour les réseaux EAP-TLS.

Attention

Les ID de certificat étant à l’échelle du système pour les certificats d’autorité de certification racine et client, un appel de fonction ou une commande azsphere qui ajoute un nouveau certificat peut remplacer un certificat qui a été ajouté par un appel de fonction ou une commande antérieur, provoquant potentiellement des échecs de connexion réseau. Nous vous recommandons fortement de développer des procédures de mise à jour de certificats claires et de choisir les ID de certificat avec soin.

Pour plus d’informations, consultez ID de certificats.

Paramètres obligatoires

Paramètre	Type	Description
-i, --cert-id	Chaîne	Spécifie l’identificateur du certificat à ajouter. Identificateur de chaîne (jusqu’à 16 caractères). Les caractères valides incluent des lettres majuscules (A-Z), des lettres minuscules (a-z), des chiffres (0-9), un trait de soulignement (_), un point (.) et un trait d’union (-). Cet identificateur est également utilisé dans les configurations Wi-Fi pour les réseaux EAP-TLS.
--cert-type	Chaîne	Spécifie le type de certificat à ajouter, client ou rootca.
-p, --public-key-file	Chaîne	Spécifie le chemin d’accès à un fichier .pem de certificat de clé publique. Vous pouvez fournir un chemin relatif ou absolu.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
--private-key-file	Chaîne	Spécifie le chemin d’accès à un fichier .pem de certificat de clé privée client. Obligatoire lors de l’ajout d’un certificat de type client. Vous pouvez fournir un chemin relatif ou absolu.
-w, --private-key-password	Chaîne	Spécifie un mot de passe facultatif pour la clé privée du client. Le mot de passe est obligatoire lors de l’ajout d’une clé privée de certificat client chiffrée.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device certificate add --cert-id certroot --cert-type rootca --public-key-file publiccert.pem
Certificate 'certroot' successfully added.

azsphere device certificate add --cert-id certclient --cert-type client --private-key-file privatekey.pem --private-key-password 1234 --public-key-file publiccert.pem
Certificate 'certclient' successfully added.

certificate delete

Supprime un certificat du magasin de certificats de l’appareil attaché.

Paramètres obligatoires

Paramètre	Type	Description
-c, --certificate ou --cert-id [Retrait]	Chaîne	Spécifie l’identificateur du certificat à supprimer. L’argument --cert-id sera mis hors service et sera supprimé dans une prochaine version. Pour plus d’informations, consultez Modifications importantes (suppression des fonctionnalités) dans Azure Sphere CLI.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device certificate delete --certificate certclient

certificate list

Répertorie les certificats disponibles dans le magasin de certificats de l’appareil.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device certificate list
 -----------
 Identifiers
 ===========
 rootCert
 -----------

certificate show

Affiche les détails d’un certificat individuel dans le magasin de certificats de l’appareil.

Paramètres obligatoires

Paramètre	Type	Description
-c, --certificate ou --cert-id [Retrait]	Chaîne	Spécifie l’identificateur du certificat pour lequel afficher les détails. L’argument --cert-id sera mis hors service et sera supprimé dans une prochaine version. Pour plus d’informations, consultez Modifications importantes (suppression des fonctionnalités) dans Azure Sphere CLI.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device certificate show --certificate certclient
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
 Id         StartDate           EndDate             SubjectName                         IssuerName
 ==========================================================================================================================
 certclient 06/08/2019 19:15:48 06/08/2069 19:25:44 /DC=local/DC=azsphere/CN=azsphereca /DC=local/DC=azsphere/CN=azsphereca
 ---------- ------------------- ------------------- ----------------------------------- -----------------------------------

certificate show-quota

Affiche l’espace libre disponible dans le magasin de certificats de l’appareil attaché.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device certificate show-quota
--------------
Available space (bytes)
==============
24514
--------------

claim

Revendique un appareil non encore revendiqué pour le locataire Azure Sphere actuel.

Important

Avant de revendiquer l’appareil, vérifiez que vous êtes connecté au bon locataire Azure Sphere. Un appareil peut être revendiqué une seule fois. Une fois qu’il a été revendiqué, un appareil ne peut plus être déplacé vers un autre locataire.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande. Ce paramètre est requis lorsque plusieurs appareils sont attachés ou lorsqu’aucun appareil n’est attaché. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez fournir un ID d’appareil pour un appareil non attaché, ou spécifier l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
-t, --tenant	GUID ou nom	Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire.
--force	Boolean	Force la revendication d’un appareil dans le locataire Azure Sphere sélectionné par l’utilisateur actuel.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device claim
warn: You are claiming a device to the following tenant:
warn: a323c263-2aa3-2559-aabb-a3fc32631900 (Tenant1)
warn: Do you want to claim the device ID 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968 to this tenant?
warn: You cannot change the Azure Sphere tenant this device is claimed to once this action has completed.
Enter 'yes' to continue. Enter anything else to exit.
> yes
Claiming device.
Successfully claimed device ID '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968' into tenant 'Tenant1' with ID 'a323c263-2aa3-2559-aabb-a3fc32631900'.

enable-cloud-test

Prépare l’appareil attaché pour tester le chargement cloud en désactivant le développement d’application, en supprimant les applications existantes et en activant les mises à jour d’applications chargées par le cloud.

Cette commande nécessite qu’un appareil soit attaché à l’ordinateur et s’applique uniquement à l’appareil attaché.

Plus particulièrement, enable-cloud-test :

• Supprime la fonctionnalité appDevelopment de l’appareil attaché.
• Affecte l’appareil à un groupe d’appareils qui active les mises à jour d’application chargées dans le cloud.
• Redémarre l’appareil.

enable-cloud-test effectue des tâches différentes selon qu’un produit et un groupe d’appareils ont ou non déjà été assignés à cet appareil.

Si azsphere device enable-cloud-test est exécuté sans paramètres, l’appareil est placé dans le groupe d’appareils Field Test du produit actuel de l’appareil. Il s’agit de l’un des groupes d’appareils par défaut créés automatiquement pour chaque produit, qui autorise les mises à jour d’applications. Une erreur est retournée si l’appareil n’a pas de produit, ou qu’un groupe d’appareils Test de champ n’existe pas dans celui-ci.

Si un produit est spécifié, l’appareil est placé dans le groupe d’appareils Test de champ de ce produit. Une erreur est retournée si ce groupe d’appareils n’existe pas.

Si un groupe d’appareils est spécifié, l’appareil est placé dans celui-ci. Une erreur est retournée si le groupe d’appareils cible n’active pas les mises à jour d’application.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
-p, --product	GUID ou nom	Spécifie le produit cible. Lorsqu’il est spécifié, l’appareil est déplacé vers le groupe d’appareils test de champ par défaut de ce produit, sauf s’il --device-group est également spécifié. Vous pouvez spécifier l’ID ou le nom du produit Azure Sphere.
-t, --tenant	GUID ou nom	Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire.
-g, --device-group	GUID ou nom	Spécifie le groupe d’appareils vers lequel l’appareil sera déplacé. Vous pouvez spécifier l’ID du groupe d’appareils ou le nom du groupe d’appareils. Pour utiliser le nom du groupe d’appareils, vous devez fournir le nom du produit et le nom du <product-name/device-group-name> groupe d’appareils au format. Par défaut, il s’agit du groupe d’appareils Field Test du produit.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemples

Exemple 1. Assigner un appareil à un groupe d’appareils existant par son ID

Cet exemple assigne l’appareil attaché à un produit et un groupe d’appareils existants.

azsphere device enable-cloud-test --device-group '3548b179-m16f-4f64-6dme-d3c643662e76'
Your internal capabilities will be retained, including the Enable App development capability. Sideloaded images may be removed by over-the-air application updates.
Getting device group by ID '3548b179-m16f-4f64-6dme-d3c643662e76'.
Leaving any existing applications on the device.
Setting device group to 'Field Test' with ID '3548b179-m16f-4f64-6dme-d3c643662e76')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: 'ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD')

Exemple 2. Assigner un appareil à un autre groupe d’appareils

Cet exemple est similaire à l’exemple précédent, mais il conserve le produit existant pour l’appareil. Ici, l’opération enable-cloud-test change le groupe d’appareils auquel appartient l’appareil et supprime la fonctionnalité appDevelopment. Cette commande permet de déplacer un appareil d’un environnement de développement où les mises à jour d’applications ne sont pas possibles vers un environnement de production qui les autorise.

azsphere device enable-cloud-test --device-group "Marketing/Field Test"

Exemple 3. Assigner un appareil par nom de produit

Cet exemple autorise le chargement cloud et assigne l’appareil à un produit par nom.

azsphere device enable-cloud-test --product DW100

enable-development

Active un appareil pour le développement en activant le chargement indépendant et le débogage sur l’appareil, et en l’affectant à un groupe d’appareils qui désactive les mises à jour d’application à partir du cloud. Par défaut, il s’agit du groupe d’appareils de développement du produit de l’appareil, mais d’autres groupes d’appareils peuvent être spécifiés. N’utilisez pas dans les scénarios de fabrication. Pour plus d’informations, consultez Fabrication d’appareils connectés .

Plus particulièrement, enable-development :

• Télécharge et applique la fonctionnalité appDevelopment pour l’appareil attaché.
• Affecte l’appareil à un groupe d’appareils qui n’active pas les mises à jour d’application chargées dans le cloud.
• Redémarre l’appareil.

Si vous exécutez la commande azsphere device enable-development sans paramètres :

• Si l’appareil ne dispose pas déjà d’un produit ou d’un groupe d’appareils, la commande télécharge et applique la fonctionnalité appDevelopment pour l’appareil attaché, puis redémarre l’appareil. Toutes les applications existantes restent sur l’appareil et le système d’exploitation est mis à jour. Le processus d’installation pour revendiquer votre appareil et le démarrage rapide pour générer une application de haut niveau n’est pas affecté.
• Si l’appareil a déjà un produit, la commande déplace l’appareil dans le groupe d’appareils Development du produit. Par défaut, les mises à jour d’application sont désactivées pour ce groupe, ce qui garantit que les applications chargées de manière indépendante ne sont pas remplacées.

Si vous exécutez la commande azsphere device enable-development avec le --product paramètre :

• Place l’appareil dans le groupe d’appareils de développement du produit. Une erreur est retournée si ce groupe d’appareils n’existe pas.

Si vous exécutez la commande azsphere device enable-development avec le --device-group paramètre :

• Place l’appareil dans le groupe d’appareils spécifié. Le groupe d’appareils cible ne doit pas activer les mises à jour de l’application ou une erreur est retournée.

Dans certains cas, azsphere device enable-development signale une erreur et vous suggère de revendiquer l’appareil. Si vous avez déjà revendiqué l’appareil, utilisez azsphere tenant show-selected pour vérifier que vous êtes connecté au locataire dans lequel vous avez effectué cette revendication. Sinon, utilisez azsphere login pour vous connecter au bon locataire. Lorsque vous êtes sûr que vous êtes connecté au locataire approprié, utilisez la revendication d’appareil azsphere pour revendiquer l’appareil.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
-g, --device-group	GUID ou nom	Spécifie le groupe d’appareils vers lequel l’appareil sera déplacé. Si ce paramètre est omis, attribue l’appareil à un groupe par défaut. Vous pouvez spécifier l’ID du groupe d’appareils ou le nom du groupe d’appareils. Pour utiliser le nom du groupe d’appareils, vous devez fournir le nom du produit et le nom du <product-name/device-group-name> groupe d’appareils au format.
-r, --enable-rt-core-débogage	Boolean	Installe les pilotes requis pour déboguer des applications s’exécutant sur un cœur en temps réel. Cette option nécessite des autorisations d’administrateur.
-p, --product	GUID ou nom	Spécifie le produit cible. Lorsque vous spécifiez cette valeur, l’appareil est déplacé vers le groupe d’appareils de développement par défaut de ce produit, sauf s’il --device-group est également spécifié. Vous pouvez spécifier l’ID ou le nom du produit Azure Sphere.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device enable-development
Capability configuration has been successfully cleared.
PS C:\Users\v-shypr> azsphere device enable-development
Getting device group 'Development' for product 'DW100'.
The device already has the 'Enable App development' capability. No changes will be applied to its existing capabilities.
Setting device group to 'Development' with ID '7f860cc1-4949-4000-a541-9a988ba4c3cd'.
Successfully disabled application updates.
Installing debugging server to device.
Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
Previous device capabilities retained. Ensure that you have the correct development capabilities installed before continuing.
Successfully set up device for application development, and disabled application updates.
(Device ID: '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968')

image

Retourne les informations sur les images qui sont installées sur l’appareil attaché, ou qui le ciblent.

Operation	Description
list-installed	Fournit des détails sur les images actuellement installées sur l’appareil attaché.
list-targeted	Fournit les détails des images qui ciblent l’appareil attaché.

image list-installed

Répertorie toutes les images installées sur l’appareil attaché. Les informations affichées incluent les ID d’image et de composant.

Remarque

Les noms d’images longs sont tronqués à 31 caractères.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
-f, --full	Boolean	Répertorie toutes les images logicielles installées sur l’appareil. Par défaut, liste uniquement les images d’applications, débogueurs et images de configuration de carte.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device image list-installed
Installed images:
 --> gdbserver
   --> Image type:   Application
   --> Component ID: 8548b129-b16f-4f84-8dbe-d2c847862e78
   --> Image ID:     dc6205bd-4478-4c9b-81ad-5e41ac23ed68
 --> CrashApplicatio
   --> Image type:   Application
   --> Component ID: 9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
   --> Image ID:     cc77124e-6447-4c0f-9f99-fc0ad5ef46ef

image list-targeted

Répertorie les images qui ont été chargées dans le service de sécurité Azure Sphere et seront installées lorsque l’appareil est mis à jour. Pour plus d’informations sur la façon dont votre appareil Azure Sphere est prêt à accepter les mises à jour d’applications cloud, consultez Activer le déploiement basé sur le cloud pour votre appareil.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande. Ce paramètre est requis lorsque plusieurs appareils sont attachés ou lorsqu’aucun appareil n’est attaché. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez fournir un ID d’appareil pour un appareil non attaché, ou spécifier l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
-t, --tenant	GUID ou nom	Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire.
-f, --full	Boolean	Répertorie toutes les images de votre locataire Azure Sphere.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device image list-targeted
 ----------------------- ------------------------------------ ------------------------------------ ---------------- --------------------
 Name                    ComponentId                          ImageId                              ImageType       RegionalDataBoundary 
 =======================================================================================================================================
 HelloWorld_HighLevelApp 1689d8b2-c835-2e27-27ad-e894d6d15fa9 50419cb6-a33b-4cbe-8bd0-425048664b6f Applications    None   
 ----------------------- ------------------------------------ ------------------------------------ -------------------------------------   

list

Liste tous les appareils d’un locataire. La liste tronque après les 500 premiers appareils.

Paramètres facultatifs

Paramètre	Type	Description
-t, --tenant	GUID ou nom	Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device list
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                                                         TenantId                             ChipSku  ProductId                            DeviceGroupId
 ========================================================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------

Vous pouvez utiliser le --query paramètre pour personnaliser la sortie affichée pour cette commande. Pour plus d’informations, consultez la sortie de la commande CLI de requête.

L’exemple suivant montre comment sélectionner uniquement l’ID d’appareil et l’ID de produit :

azsphere device list --query '[].{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 4f48d618-09f7-45dc-a5a4-1433cabbee91
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD 4f48d618-09f7-45dc-a5a4-1433cabbee91
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

Conseil

Exécutez le produit azsphere product show --product-ID>< pour afficher le nom du produit ou l’azsphere device-group show --device-group <devicegroup-ID> pour afficher le nom du groupe d’appareils.

list-attached

Liste les appareils attachés au PC local.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device list-attached
1 device attached:
--> Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
  --> Is responsive: yes
  --> IP address: 192.128.48.1
  --> Connection path: 21143

fabrication-état

Gère l’état de fabrication de l’appareil attaché.

Operation	Description
show	Affiche l’état de fabrication de l’appareil attaché.
mise à jour	Met à jour l’état de fabrication de l’appareil attaché.

Attention

Les changements d’état de fabrication sont définitifs et irréversibles.

manufacturing-state show

Affiche l’état de fabrication de l’appareil attaché.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device manufacturing-state show
------------------
ManufacturingState
==================
Module1Complete
------------------

manufacturing-state update

Met à jour l’état de fabrication de l’appareil attaché. Pour plus d’informations, consultez Définir l’état de fabrication de l’appareil.

Attention

Les changements d’état de fabrication sont définitifs et irréversibles.

Paramètres obligatoires

Paramètre	Type	Description
-s, --state	États de fabrication	Spécifie l’état de fabrication à définir pour l’appareil. Les états possibles incluent DeviceComplete et Module1Complete.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device manufacturing-state update --state Module1Complete
Updating manufacturing state to Module1Complete.
Restarting device for changes to take effect.
The device was successfully restarted.

réseau

Fournit des informations sur l’état des interfaces réseau sur l’appareil attaché.

Operation	Description
enable	Active une interface réseau sur l’appareil attaché.
disable	Désactive une interface réseau sur l’appareil attaché.
list-firewall-rules	Répertorie les règles de pare-feu pour l’appareil attaché.
list-interfaces	Répertorie les interfaces réseau de l’appareil attaché.
proxy	Gère les paramètres du proxy de mise en réseau.
show-diagnostics	Affiche les diagnostics réseau pour un ou tous les réseaux sans fil sur l’appareil attaché.
show-status	Affiche l’état réseau de l’appareil attaché.
update-interface	Met à jour une configuration d’interface réseau pour l’appareil.

activer le réseau

Active une interface réseau sur l’appareil attaché.

Remarque

Cette commande est prise en charge pour la configuration d’Ethernet eth0 et wlan0 de connexions. Une erreur est retournée si vous configurez lo ou azspheresvc.

Paramètres obligatoires

Paramètre	Type	Description
--interface	string	Spécifie l’interface à activer.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device network enable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.

désactivation du réseau

Désactive une interface réseau sur l’appareil attaché.

Remarque

Cette commande est prise en charge pour la configuration d’Ethernet eth0 et wlan0 de connexions. Une erreur est retournée si vous configurez lo ou azspheresvc.

Paramètres obligatoires

Paramètre	Type	Description
--interface	string	Spécifie l’interface à activer.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device network disable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.

network list-firewall-rules

Répertorie les règles de pare-feu pour l’appareil attaché.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Les règles suivantes sont affichées :

• Nom de l’ensemble de règles de pare-feu : affiche le nom du bloc de jeu de règles de pare-feu.
  • Les valeurs sont PREROUTING, POSTROUTING, INPUT, FORWARD et OUTPUT.
• Ensemble de règles valide : affiche l’état du jeu de règles. Les valeurs sont True ou False.
• Règles de jeu de règles de pare-feu : affiche les valeurs des règles suivantes :
  • Adresse IP source : affiche l’adresse IP de la machine d’envoi.
  • Masque source : affiche le masque réseau de la machine d’envoi.
  • Adresse IP de destination : affiche l’adresse IP de l’ordinateur de destination.
  • Masque de destination : affiche le masque réseau de la machine de déstomation.
  • UID : affiche l’identification de l’utilisateur appliquée à la règle. 4294967295 (0xFFFFFFFF) signifie qu’aucun UID n’a été appliqué et s’applique donc à tout le monde.
  • Action : affiche l’action à entreprendre. Les valeurs peuvent être acceptée ou supprimées.
  • Nom de l’interface IN : affiche le nom de l’interface d’entrée. Par exemple, wlan0.
  • Nom out de l’interface : affiche le nom de l’interface de sortie. Par exemple, wlan0.
  • État : affiche l’état de connexion. Les valeurs ne sont pas, établies ou associées.
  • Masque TCP : affiche le tableau de masques TCP. Les valeurs sont fin, syn, rst, psh, ack et urg.
  • TCP Cmp : affiche le tableau d’indicateurs TCP. Les valeurs sont urg, ack, psh, rst, syb et fin.
  • TCP Inv : Boolean indique que le sens des indicateurs TCP doit être inversé. Les valeurs sont True ou False.
  • Protocole : affiche le protocole de la règle de pare-feu. Les valeurs sont icmp, igmp, tcp, udp.
  • Plage de ports source : affiche la plage de ports de la source qui envoie le trafic. La valeur peut être comprise entre 0 et 65535.
  • Plage de ports de destination : affiche la plage de ports sur la destination qui reçoit le trafic. La valeur peut être comprise entre 0 et 65535.
  • Paquets : affiche le nombre de paquets.
  • Octets : affiche le nombre d’octets.

Un bref résumé des indicateurs est répertorié comme suit :

• URG : Champ pointeur urgent significatif
• ACK : Champ d’accusé de réception significatif
• PSH : Fonction Push
• RST : Réinitialiser la connexion
• SYN : Synchroniser des numéros de séquence
• FIN : Aucune autre donnée de l’expéditeur

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device network list-firewall-rules
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 Ruleset     IsValid SourceIp     SourceMask      DestinationIp   DestinationMask UID        Action InterfaceInName TcpInv Protocol SourcePortRange DestinationPortRange Packets Bytes  TcpMask TcpCmp
 =====================================================================================================================================================================================================
 PREROUTING  False   None         None            None            None            None       None   None            None   None     None            None                 None    None   None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  any      0-65535         0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 True   tcp      0-65535         0-65535              823     394754 syn,ack syn
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    192.168.35.1 <value>         <value>         <value>         <value>     accept azspheresvc     False  any      0-65535         0-65535              15      780    None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------

network list-interfaces

Répertorie les interfaces réseau de l’appareil attaché.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device network list-interfaces
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 InterfaceName InterfaceUp ConnectedToNetwork IpAcquired IpAddresses   ConnectedToInternet IpAssignment HardwareAddress
 ========================================================================================================================
 azspheresvc   True        False              False      <value>       False               None         None
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 eth0          True        True               True       <value>       True                dynamic      <value>
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 lo            True        False              False      <value>       False               None         None
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 wlan0         True        True               True       <value>       True                dynamic      <value>
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------

proxy réseau

Gère l’utilisation de l’adresse proxy pour la connexion réseau. Pour plus d’informations sur la configuration d’un appareil Azure Sphere pour se connecter à Internet via un serveur proxy, consultez Se connecter via un serveur proxy.

Remarque

Seuls les proxys HTTP sont actuellement pris en charge.

Operation	Description
proxy apply	Configure le proxy réseau sur l’appareil attaché.
suppression de proxy	Supprime la connexion proxy sur l’appareil attaché.
proxy show	Affiche la connexion proxy sur l’appareil attaché.

proxy apply

Configure le proxy réseau sur l’appareil attaché.

Paramètres obligatoires

Paramètre	Type	Description
-a, --address	Chaîne	Spécifie l’adresse réseau du proxy à utiliser.
-t, --authentication	Chaîne	Spécifie le type d’authentification à utiliser. Valeurs autorisées : anonymous ou basic. Si le proxy requiert un nom d’utilisateur et un mot de passe, définissez-le basicsur , sinon utilisez anonymous.
-r, --port	Integer	Spécifie le port sur l’adresse réseau à utiliser. La valeur doit être égale ou inférieure à 65535.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
--Activer	Chaîne	Spécifie si le proxy doit être activé. Vous devez définir l’une ou l’autre --enable .--disable
--désactiver	Chaîne	Spécifie si le proxy doit être désactivé. Vous devez définir l’une ou l’autre --enable .--disable
-n, --no-proxy-addresses	Chaîne	Spécifie un tableau d’adresses réseau séparées par l’espace que l’appareil doit éviter pour la connexion proxy.
-p, --password	Chaîne	Spécifie le mot de passe pour l’authentification proxy uniquement utilisé pour l’authentification de base. Longueur maximale : 64 caractères.
-u, --username	Chaîne	Spécifie le nom d’utilisateur pour l’authentification proxy. Utilisé uniquement pour l’authentification de base. Longueur maximale : 64 caractères.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device network proxy apply --address contoso.com --authentication anonymous --port 8080 --enable
 ----------- ------- ----- ------------------ ----------------
 Address     Enabled Port  AuthenticationType NoProxyAddresses
 =============================================================
 contoso.com True   8080  anonymous
 ----------- ------- ----- ------------------ ----------------

suppression de proxy

Supprime la connexion proxy sur l’appareil attaché.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device network proxy delete

proxy show

Affiche la connexion proxy sur l’appareil attaché.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device network proxy show
 ----------- ------- ----- ------------------ ----------------
 Address     Enabled Port  AuthenticationType NoProxyAddresses
 =============================================================
 contoso.com True   8080  anonymous
 ----------- ------- ----- ------------------ ----------------

network show-diagnostics

Affiche les diagnostics d’un ou de tous les réseaux Wi-Fi sur l’appareil attaché.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
-n, --network	Integer	Spécifie l’ID du réseau Wi-Fi pour lequel afficher les diagnostics.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device network show-diagnostics
 ------------------------- --------- ----- ------------- --------------- --------
 Timestamp                 NetworkId Ssid  ConfigState   ConnectionState Error
 ================================================================================
 2021-06-16T20:51:29+00:00 0         <value> temp-disabled disconnected    WrongKey
 ------------------------- --------- ----- ------------- --------------- --------

network show-status

Affiche l’état réseau de l’appareil attaché.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device network show-status
 --------------------------- --------------- -----
 DeviceAuthenticationIsReady NetworkTimeSync Proxy
 =================================================
 True                        complete        ready
 --------------------------- --------------- -----

interface de mise à jour réseau

Met à jour l’interface réseau Ethernet de l’appareil. Pour plus d’informations sur la définition de l’adresse MAC pour l’appareil, consultez Configurer l’appareil pour Ethernet.

Remarque

Cette commande est prise en charge pour la configuration des connexions Ethernet eth0 . Une erreur est retournée si vous configurez lo, azspheresvc ou wlan0.

Paramètres obligatoires

Paramètre	Type	Description
--hardware-address	Chaîne	Spécifie l’adresse matérielle à définir pour l’appareil dans l’un des formats suivants : AA:BB:33:DD:EE:FF ou aa:bb:33:dd:ee:ff.
--interface ou --interface-name [Retrait]	Chaîne	Spécifie le nom de l’interface à configurer. Exécutez azsphere device network list-interfaces pour afficher les détails des interfaces réseau pour l’appareil attaché. L’argument --interface-name sera mis hors service et sera supprimé dans une prochaine version. Pour plus d’informations, consultez Modifications importantes (suppression des fonctionnalités) dans Azure Sphere CLI.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device network update-interface --interface eth0 --hardware-address ba:98:76:54:32:10

recover

Remplace le logiciel système sur l’appareil.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Spécifiez l’ID, l’adresse IP ou l’ID de connexion locale de l’appareil.
-c, --capability	Chaîne	Spécifie l’image de capacité de l’appareil à appliquer à l’appareil pendant la récupération.
-i, --images	Chaîne	Spécifie le chemin d’un dossier qui contient les packages d’image à installer sur l’appareil. Par défaut, la récupération utilise les images figurant dans le kit SDK, sauf si un autre chemin est fourni avec cet indicateur.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

Exemple 1 :

azsphere device recover
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 17 images. (5443272 bytes to send)
Sent 1 of 17 images. (5440896 of 5443272 bytes remaining)
Sent 2 of 17 images. (5414844 of 5443272 bytes remaining)
Sent 3 of 17 images. (5311892 of 5443272 bytes remaining)
Sent 4 of 17 images. (5311500 of 5443272 bytes remaining)
Sent 5 of 17 images. (5041520 of 5443272 bytes remaining)
Sent 6 of 17 images. (5024908 of 5443272 bytes remaining)
Sent 7 of 17 images. (4994856 of 5443272 bytes remaining)
Sent 8 of 17 images. (2397456 of 5443272 bytes remaining)
Sent 9 of 17 images. (885796 of 5443272 bytes remaining)
Sent 10 of 17 images. (861220 of 5443272 bytes remaining)
Sent 11 of 17 images. (758608 of 5443272 bytes remaining)
Sent 12 of 17 images. (135796 of 5443272 bytes remaining)
Sent 13 of 17 images. (70048 of 5443272 bytes remaining)
Sent 14 of 17 images. (41164 of 5443272 bytes remaining)
Sent 15 of 17 images. (32768 of 5443272 bytes remaining)
Sent 16 of 17 images. (16384 of 5443272 bytes remaining)
Sent 17 of 17 images. (0 of 5443272 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.

Exemple 2 :

azsphere device recover --capability "C:\Users\capability file\capability_352FE1F_5.bin"
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 16 images. (5474668 bytes to send)
Sent 1 of 16 images. (5447384 of 5474668 bytes remaining)
Sent 2 of 16 images. (5343788 of 5474668 bytes remaining)
Sent 3 of 16 images. (5343396 of 5474668 bytes remaining)
Sent 4 of 16 images. (5073416 of 5474668 bytes remaining)
Sent 5 of 16 images. (5056612 of 5474668 bytes remaining)
Sent 6 of 16 images. (5026240 of 5474668 bytes remaining)
Sent 7 of 16 images. (2479376 of 5474668 bytes remaining)
Sent 8 of 16 images. (889892 of 5474668 bytes remaining)
Sent 9 of 16 images. (865316 of 5474668 bytes remaining)
Sent 10 of 16 images. (754512 of 5474668 bytes remaining)
Sent 11 of 16 images. (135796 of 5474668 bytes remaining)
Sent 12 of 16 images. (70048 of 5474668 bytes remaining)
Sent 13 of 16 images. (41164 of 5474668 bytes remaining)
Sent 14 of 16 images. (32768 of 5474668 bytes remaining)
Sent 15 of 16 images. (16384 of 5474668 bytes remaining)
Sent 16 of 16 images. (0 of 5474668 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.

rescand

Réanalyse les appareils attachés en effectuant un cycle d’alimentation sur tous leurs ports FTDI et affiche le nombre total d’appareils attachés. Utilisez cette commande lors de la résolution des problèmes de connexion d’appareil sur Windows. Cette commande s’exécute uniquement sur Windows.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

 azsphere device rescan-attached
 -----------
 Count
 ===========
 2
 -----------

restart

Redémarre l’appareil attaché.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device restart
Restarting device.
Device restarted successfully.

show

Affiche les détails d’un appareil attaché dans votre locataire Azure Sphere.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande. Ce paramètre est requis lorsque plusieurs appareils sont attachés ou lorsqu’aucun appareil n’est attaché. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez fournir un ID d’appareil pour un appareil non attaché, ou spécifier l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
-t, --tenant	GUID ou nom	Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device show
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                                                         TenantId                             ChipSku  ProductId                            DeviceGroupId
 ========================================================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------

Vous pouvez utiliser le --query paramètre pour personnaliser la sortie affichée pour cette commande. Pour plus d’informations, consultez la sortie de la commande CLI de requête.

L’exemple suivant montre comment sélectionner uniquement l’ID d’appareil et l’ID de produit :

azsphere device show --device 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968  --query '{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

show-attached

Affiche les détails de l’appareil attaché à partir de l’appareil lui-même. Ces détails diffèrent de ceux que le service de sécurité Azure Sphere stocke pour l’appareil.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device show-attached
Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
IP address: 192.128.48.1
Connection path: 21143

show-deployment-status

Affiche l’état de déploiement des mises à jour d’applications et du système d’exploitation de l’appareil.

Utilisez cette commande pour déterminer quelle version du système d’exploitation Azure Sphere est exécutée sur votre appareil ou pour savoir si la mise à jour de déploiement actuelle a abouti.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
-t, --tenant	GUID ou nom	Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device show-deployment-status
Your device is running Azure Sphere OS version <version-number>.
The Azure Sphere Security Service is targeting this device with Azure Sphere OS version <version-number>.
Your device has the expected version of the Azure Sphere OS: <version-number>.

Dans cet exemple, <le numéro> de version représente la version actuelle du système d’exploitation.

show-count

Affiche le nombre d’appareils du locataire actif.

Paramètres facultatifs

Paramètre	Type	Description
-t, --tenant	GUID ou nom	Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

 azsphere device show-count
 ------
 Result
 ======
 2
 ------

show-os-version

Affiche la version actuelle du système d’exploitation de l’appareil attaché.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device show-os-version
Your device is running Azure Sphere OS version <version-number>

Dans cet exemple, <le numéro> de version représente la version actuelle du système d’exploitation.

chargement indépendant

Gère l’application sur l’appareil.

Certaines options de chargement indépendant nécessitent des fonctionnalités supplémentaires une fois que l’appareil est dans l’état de fabrication DeviceComplete. La fonctionnalité fieldServicing vous permet de déployer et de supprimer des images signées de production temporaires et de déployer des images signées de production permanentes. La fonctionnalité appDevelopment vous permet de déployer et de supprimer des images signées en production et signées par le SDK.

Operation	Description
delete	Supprime l’application actuelle de l’appareil.
deploy	Charge une application sur l’appareil.
set-deployment-timeout	Définit le délai d’expiration du déploiement en secondes.
show-deployment-timeout	Affiche le délai d’expiration du déploiement en secondes.

Notez que les paramètres vers , , et show-quota ont été déplacés vers la commande azsphere device app. show-statusstopstart

sideload delete

Supprime des applications de l’appareil.

Cette commande est disponible uniquement si la fonctionnalité d’appareil appDevelopment est configurée.

Paramètres facultatifs

Paramètre	Type	Description
-i, --component-id	GUID	Spécifie l’ID de l’application à supprimer de l’appareil. Si ce paramètre est omis, supprime toutes les applications.
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device sideload delete
Component '54acba7c-7719-461a-89db-49c807e0fa4d' deleted.

sideload deploy

Charge une application sur l’appareil attaché et démarre l’application.

Cette commande échoue si le manifeste d’application demande une ressource qui est utilisée par une autre application se trouvant déjà sur l’appareil. Dans ce cas, utilisez azsphere device sideload delete pour supprimer l’application existante, puis réessayez le chargement indépendant. La commande azsphere device sideload delete supprime les applications de haut niveau et les applications en temps réel. Pour supprimer une application et laisser l’autre, spécifiez l’ID de composant de l’application à supprimer.

La même commande permet de déployer les applications tant générales qu’en temps réel.

Remarque

Un redémarrage de l’appareil est déclenché lorsqu’une nouvelle application qui utilise des périphériques est installée et que les conditions suivantes sont remplies :

• L’état de fabrication de l’appareil est défini sur DeviceComplete.
• La fonctionnalité appDevelopment n’est pas présente sur l’appareil. Pour plus d’informations, consultez Verrouillage de la configuration périphérique.

Si un redémarrage de l’appareil est lancé, attendez que le redémarrage soit terminé et que l’appareil soit réactif.

Paramètres obligatoires

Paramètre	Type	Description
-p, --image-package	Chaîne	Spécifie le chemin et le nom de fichier du package d’image à charger sur l’appareil.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
-m, --manual-start	Boolean	Spécifie de ne pas démarrer automatiquement l’application après son chargement.
--force	Boolean	Force le déploiement d’une image qui utilise une API bêta ne pouvant plus être prise en charge.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device sideload deploy --image-package C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
Deploying 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' to the attached device.
Image package 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' has been deployed to the attached device.

set-deployment-timeout de chargement indépendant

Définit la valeur du délai d’expiration du déploiement en secondes pour le chargement indépendant d’images sur l’appareil.

Paramètres obligatoires

Paramètre	Type	Description
-v, --value	Integer	Spécifie la durée en secondes avant l’expiration d’une commande de chargement indépendant. La valeur doit être un entier positif.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device sideload set-deployment-timeout --value 60
 ------------------
 Deployment timeout
 ==================
 60
 ------------------

chargement indépendant show-deployment-timeout

Affiche la valeur de délai d’attente de déploiement actuelle en secondes pour le chargement indépendant d’images sur l’appareil.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device sideload show-deployment-timeout
 ------------------
 Deployment timeout
 ==================
 60
 ------------------

mise à jour

Déplace l’appareil vers un autre groupe d’appareils dans votre client Azure Sphere.

Outre les groupes d’appareils que vous créez dans un produit, cinq groupes d’appareils par défaut sont ajoutés quand un produit est créé :

• Développement : accepte uniquement les mises à jour logicielles système. N’accepte pas les mises à jour d’application.
• Test de champ : accepte toutes les mises à jour du service de sécurité Azure Sphere.
• Production : accepte toutes les mises à jour du service de sécurité Azure Sphere.
• Évaluation du système d’exploitation de production : accepte toutes les mises à jour du service de sécurité Azure Sphere.
• Évaluation du système d’exploitation de test de champ : accepte toutes les mises à jour du service de sécurité Azure Sphere.

Pour plus d’informations sur les éléments fondamentaux impliqués dans le déploiement, consultez Concepts de base du déploiement.

Paramètres facultatifs

Paramètre	Type	Description
-g, --device-group	GUID ou nom	Spécifie le groupe d’appareils dans lequel déplacer l’appareil. Vous pouvez spécifier l’ID du groupe d’appareils ou le nom du groupe d’appareils. Pour utiliser le nom du groupe d’appareils, vous devez fournir le nom du produit et le nom du <product-name/device-group-name> groupe d’appareils au format.
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande. Ce paramètre est requis lorsque plusieurs appareils sont attachés ou lorsqu’aucun appareil n’est attaché. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez fournir un ID d’appareil pour un appareil non attaché, ou spécifier l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
-t, --tenant	GUID ou nom	Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device update --device-group AW100/Marketing
 ------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                               TenantId                             ChipSku  ProductId                            DeviceGroupId
 ==============================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
 427D205E46A166B7E41135EB968
 ------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------

Vous pouvez utiliser le --query paramètre pour personnaliser la sortie affichée pour cette commande. Pour plus d’informations, consultez la sortie de la commande CLI de requête.

L’exemple suivant montre comment sélectionner uniquement l’ID d’appareil et l’ID de produit :

azsphere device update --device-group AW100/Marketing  --query '{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

wifi

Gère les configurations Wi-Fi pour l’appareil attaché.

Pour utiliser l’appareil sur un réseau Wi-Fi, vous devez ajouter des informations sur le réseau et activer le réseau sur l’appareil. Vous pouvez inclure des caractères non ASCII dans les SSID, mais azsphere ne les affiche pas correctement.

Si votre application utilise l’API de configuration Wi-Fi, vous devez également inclure la fonctionnalité WifiConfig dans le fichier app_manifest.json de l’application.

Operation	Description
add	Ajoute les informations d’un réseau sans fil à l’appareil.
disable	Désactive un réseau sans fil sur l’appareil.
enable	Active un réseau sans fil sur l’appareil.
forget	Supprime les informations d’un réseau sans fil sur l’appareil.
list	Répertorie la configuration actuelle du WiFi sur l’appareil.
reload-config	Recharge la configuration Wi-Fi de l’appareil.
scan	Recherche les réseaux disponibles.
show	Affiche les détails d’une configuration Wi-Fi.
show-status	Affiche l’état de l’interface sans fil.

wifi add

Ajoute des détails d’un réseau Wi-Fi à l’appareil attaché.

Un appareil peut avoir plusieurs connexions WiFi. Vous pouvez inclure des caractères non ASCII dans les SSID, mais azsphere ne les affiche pas correctement. Vous pouvez inclure le --targeted-scan paramètre pour vous connecter aux disques SSD masqués. Pour plus d’informations, consultez Connecter Azure Sphere au Wi-Fi.

Paramètres obligatoires

Paramètre	Type	Description
-s, --ssid	Chaîne	Spécifie le SSID du réseau. Les SSID de réseau sont sensibles à la casse.

Paramètres facultatifs

Paramètre	Type	Description
--client-cert-id	Chaîne	[EAP-TLS] Spécifie l’identificateur (jusqu’à 16 caractères) qui identifie le certificat client (contenant à la fois la clé publique et privée). Obligatoire pour configurer un réseau EAP-TLS.
--client-id <user@domain>	Chaîne	[EAP-TLS] Spécifie l’ID reconnu pour l’authentification par le serveur RADIUS du réseau. Obligatoire pour certains réseaux EAP-TLS.
--config-name	Chaîne	Spécifie une chaîne (jusqu’à 16 caractères) qui spécifie le nom de la configuration réseau.
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.
--root-ca-cert-id	Chaîne	[EAP-tLS] Spécifie l’identificateur (jusqu’à 16 caractères) qui identifie le certificat d’autorité de certification racine du serveur pour les réseaux EAP-TLS où l’appareil authentifie le serveur.
--targeted-scan	Boolean	Tente de se connecter à un réseau même quand il n’est pas diffusé ou quand il est masqué par une congestion du réseau.
-p, --psk	Chaîne	Spécifie la clé WPA/WPA2 pour le nouveau réseau. Omettez ce paramètre pour ajouter le SSID en tant que réseau ouvert. Si la clé contient une esperluette (&), placez la clé entre guillemets.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device wifi add --ssid MyNetwork --psk MyPassword
Successfully added network:
 ----- -------- ------------------ --------------- ------------- ------------
 ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
 ============================================================================
 1     MyNetwork enabled            unknown         psk           False
 ----- -------- ------------------ --------------- ------------- ------------

Si le SSID réseau ou la clé a des espaces incorporés ou un ampersand, placez le SSID ou la clé entre guillemets simples. Si la clé ou le SSID contient déjà un guillemet, ajoutez une barre oblique inverse comme caractère d’échappement devant le guillemet. Les barres obliques inverses ne doivent pas être échappées si elles font partie d’une valeur. Pour plus d’informations, consultez Guillemets et caractères d’échappement. Par exemple :

azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"

wifi disable

Désactive un réseau Wi-Fi sur l’appareil attaché.

Paramètres obligatoires

Paramètre	Type	Description
-i, --id	Integer	Spécifie l’ID du réseau à désactiver.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device wifi disable --id 0
Successfully disabled network:
----- -------- ------------------ --------------- ------------- ------------
ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0     MyNetwork disabled           disconnected    psk           False
----- -------- ------------------ --------------- ------------- ------------

wifi enable

Active un réseau Wi-Fi sur l’appareil attaché.

Pour passer d’un réseau à un autre réseau, tous deux à portée de l’appareil, désactivez le réseau actuellement connecté avant d’activer le nouveau réseau.

Paramètres obligatoires

Paramètre	Type	Description
-i, --id	Integer	Spécifie l’ID du réseau à activer.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device wifi enable --id 0
Successfully enabled network:
 ----- -------- ------------------ --------------- ------------- ------------
 ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
 ============================================================================
 0     MyNetwork enabled            disconnected    psk           False
 ----- -------- ------------------ --------------- ------------- ------------

wifi forget

Supprime les détails d’un réseau Wi-Fi de l’appareil attaché.

Paramètres obligatoires

Paramètre	Type	Description
-i, --id	Integer	Spécifie l’ID du réseau à supprimer.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device wifi forget --id 0
Successfully forgotten network.

wifi list

Répertorie la configuration Wi-Fi actuelle pour l’appareil attaché.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device wifi list
 ----- --------- ------------------ --------------- ------------- ------------
 ID    SSID      ConfigurationState ConnectionState SecurityState TargetedScan
 =============================================================================
 0     MyNetwork1 enabled            connected       psk           False
 ----- ---------  ------------------ --------------- ------------- ------------
 1     MyNetwork2 enabled            disconnected    psk           False
 ----- ---------  ------------------ --------------- ------------- ------------
 2     MyNetwork3 enabled            disconnected    eaptls        False
 ----- ---------  ------------------ --------------- ------------- ------------

wifi reload-config

Recharge la configuration réseau Wi-Fi sur l’appareil attaché. Utilisez cette commande après avoir ajouté ou supprimé un certificat (certificat d’appareil azsphere) pour vous assurer que les réseaux EAP-TLS utilisent le contenu le plus récent du magasin de certificats.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device wifi reload-config
Wi-Fi configuration was successfully reloaded.

wifi scan

Recherchez les réseaux Wi-Fi disponibles visibles par l’appareil attaché. La commande retourne jusqu’à 64 réseaux Wi-Fi, mais le nombre de réseaux Wi-Fi affichés peut être limité par des facteurs environnementaux tels que la densité des points d’accès dans la plage.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device wifi scan
----------------- ------------- ----------------- ----------- ---------
SSID              SecurityState BSSID             SignalLevel Frequency
=======================================================================
MyNetwork0        psk           <value>           -66         2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork1        psk           <value>           -75         2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork2        psk           <value>           -86         2412
----------------- ------------- ----------------- ----------- ---------

wifi show

Affiche les détails d’un réseau Wi-Fi sur l’appareil attaché.

Paramètres obligatoires

Paramètre	Type	Description
-i, --id	Integer	Spécifie l’ID de la configuration réseau à afficher.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere device wifi show --id 0
 ----- --------- ------------------ --------------- ------------- ------------
 ID    SSID      ConfigurationState ConnectionState SecurityState TargetedScan
 =============================================================================
 0     MyNetwork enabled            disconnected    psk           False
 ----- --------- ------------------ --------------- ------------- ------------

wifi show-status

Affiche l’état de l’interface Wi-Fi sur l’appareil attaché.

Paramètres facultatifs

Paramètre	Type	Description
-d, --device	Chaîne	Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est requis lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux.

Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre	Description
--debug	Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help	Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors	Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output	Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query	Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose	Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

 azsphere device wifi show-status
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
 SSID  ConfigurationState ConnectionState SecurityState Frequency Mode    KeyManagement WpaState  IpAddress     MacAddress
 ================================================================================================================================
<value> enabled            connected       psk           2412      station WPA2-PSK      COMPLETED <value>      <value>
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------