Appareil
Gère les appareils Azure Sphere.
| Opération | Description |
|---|---|
| Application | Modifie la status des applications sur un appareil. |
| Capacité | Gère les fonctionnalités de l’appareil. |
| Certificat | Gère le magasin de certificats d’appareil. |
| Réclamation | Revendique un appareil précédemment non revendiqué au locataire Azure Sphere. |
| enable-cloud-test | Configure un appareil pour désactiver le débogage et recevoir les mises à jour. |
| enable-development | Configure un appareil pour le débogage local. |
| Image | Gère les images d’un appareil. |
| Liste | Affiche tous les appareils du locataire. |
| list-attached | Listes les appareils attachés. |
| manufacturing-state | Gère l’état de fabrication de l’appareil attaché. |
| Réseau | Fournit des informations sur la status des interfaces réseau sur l’appareil. |
| Récupérer | Utilise le mode de récupération spécial pour charger le nouveau microprogramme sur l’appareil. |
| rescan-attached | Réanalyse les appareils attachés comme aide à la résolution des problèmes (Windows uniquement). |
| Redémarrer | Redémarre l’appareil attaché. |
| Montrer | Affiche des détails sur la configuration des mises à 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 dans un locataire. |
| show-deployment-status | Affiche la status de la mise à jour de déploiement la plus récente. |
| show-os-version | Affiche la version du système d’exploitation de l’appareil local. |
| chargement indépendant | Charge une image sur l’appareil attaché. |
| mettre à jour | Mises à 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 application signée par un SDK ou une application signée en production, l’appareil doit disposer de la fonctionnalité appDevelopment .
Vous pouvez utiliser azsphere device app stop et azsphere device app start pour redémarrer une application en temps réel en cours d’exécution afin de déterminer le cœur en temps réel sur lequel elle s’exécute.
| Opération | Description |
|---|---|
| show-memory-stats | Affiche les statistiques de mémoire pour les applications sur l’appareil attaché. |
| show-quota | Affiche la quantité de stockage utilisée par l’application actuelle sur l’appareil. |
| show-status | Retourne le status de l’application actuelle sur l’appareil. |
| Commencer | Démarre l’application chargée sur l’appareil. |
| Arrêter | Arrête l’application qui s’exécute sur l’appareil. |
application show-memory-stats
Affiche les statistiques de mémoire pour les applications sur l’appareil attaché. Cette commande est disponible uniquement si la fonctionnalité de l’appareil appDevelopment est configurée. Des informations supplémentaires sont affichées si le suivi de l’allocation de mémoire du tas est configuré.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
-------------- -------------
application show-quota
Affiche la quantité de stockage mutable allouée et en cours d’utilisation sur l’appareil attaché.
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 MutableStorage valeur, la quantité de stockage en cours d’utilisation ne change pas, mais la valeur allouée signalée sera 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 sur 8 Ko alloués. 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 de quota. En cas d’omission, affiche les informations de quota pour tous les composants. |
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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.
application show-status
Affiche la status actuelle 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 status. En cas d’omission, affiche status de tous les composants. |
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
démarrage de l’application
Démarre les applications sur l’appareil.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| --debug-mode | Boolean | Démarre l’application pour le débogage. Doit --component-id être fourni. |
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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. En cas d’omission, 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
arrêt de l’application
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. En cas d’omission, arrête toutes les applications. |
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device app stop
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: stopped
Capacité
Gère les fonctionnalités de l’appareil. Les fonctionnalités de l’appareil déterminent les opérations qui peuvent être effectuées sur un appareil Azure Sphere individuel.
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 fonctionnalités d’appareil à l’appareil Azure Sphere attaché à l’aide de la commande azsphere device capability update et vous pouvez créer une session de maintenance à l’aide de la commande azsphere device capability select . Pour plus d’informations sur les fonctionnalités des appareils, consultez Fonctionnalités et communication de l’appareil.
| Opération | Description |
|---|---|
| Télécharger | Télécharge une configuration de capacité d’appareil à partir du service de sécurité Azure Sphere. |
| Sélectionnez | 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é. |
| mettre à jour | Applique une configuration de capacité d’appareil à l’appareil attaché. |
téléchargement de fonctionnalité
Télécharge une fonctionnalité d’appareil à partir du service de sécurité Azure Sphere.
La fonctionnalité appDevelopment vous permet de charger une version test des applications signées par le SDK et de démarrer, d’arrêter, de déboguer ou de supprimer n’importe quelle application sur l’appareil. Sans la fonctionnalité appDevelopment , seules les applications chargées dans le cloud peuvent être chargées et démarrer, arrêter, déboguer et supprimer sont interdites. La fonctionnalité appDevelopment est appliquée dans le cadre de la commande azsphere device enable-development .
Le téléchargement de la fonctionnalité fieldServicing génère un fichier contenant la fonctionnalité pour un seul appareil Azure Sphere. Le fichier de capacité fieldServicing est téléchargé sur votre ordinateur local et peut être utilisé conjointement avec la commande azsphere device capability select .
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| --Type | Type de capacité | Spécifie le type de capacité d’appareil à télécharger. Les valeurs sont appDevelopment, fieldServicing ou none. Utilisez aucun pour supprimer la fonctionnalité appDevelopment ou la fonctionnalité fieldServicing . |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | 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 vous pouvez 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 | String | Spécifie le chemin d’accès et le nom de fichier au niveau desquels 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 de la fonctionnalité de convention <de nommage de type> premier huit< caractères de l’ID> d’appareil.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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
--------------------------------------------
sélection de fonctionnalité
Sélectionne un fichier de capacité à 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 le plus souvent utilisée avec la fonctionnalité fieldServicing pour activer une session de maintenance. Tout rôle d’utilisateur a accès à la commande azsphere device capability select .
Lorsque vous utilisez la fonctionnalité fieldServicing , la communication est activée entre l’appareil Azure Sphere et l’ordinateur local contenant le fichier de capacité. Le fichier de capacité fieldServicing est utilisé pour une session entre l’ordinateur local et l’appareil Azure Sphere, et chaque commande de la session est précédée d’un message indiquant le fichier de capacité en cours d’utilisation.
Pour mettre fin à une session de maintenance, utilisez azsphere device capability select --none.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| --capability-file | String | Spécifie le chemin d’accès et le nom du fichier de configuration de capacité de l’appareil à sélectionner. Vous pouvez fournir un chemin d’accès relatif ou absolu. |
| -n, --none | - | Efface toute configuration de fonctionnalité d’appareil 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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.
fonctionnalité show-attached
Affiche la configuration de capacité stockée sur l’appareil attaché.
Note
La commande affiche les fonctionnalités configurées à l’aide d’un fichier de fonctionnalités et certaines, mais pas toutes, les fonctionnalités présentes par défaut sur les tableaux.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
--------------------
mise à jour des fonctionnalités
Applique une configuration de capacité d’appareil à l’appareil attaché.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| --capability-file | String | Spécifie le chemin d’accès et le nom du fichier de capacité de l’appareil à appliquer. Vous pouvez fournir un chemin d’accès relatif ou absolu. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | 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 vous pouvez 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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.
Certificat
Gère les certificats sur l’appareil attaché.
| Opération | Description |
|---|---|
| Ajouter | Ajoute un certificat au magasin de certificats sur l’appareil attaché. |
| Supprimer | Supprime un certificat du magasin de certificats de l’appareil attaché. |
| Liste | Listes les ID de certificat disponibles dans le magasin de certificats de l’appareil attaché. |
| Montrer | 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é. |
ajouter un certificat
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 auprès 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é dans votre réseau EAP-TLS. Votre administrateur réseau ou votre équipe de sécurité peut fournir les détails 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
Étant donné que les ID de certificat sont à l’échelle du système pour les certificats client et d’autorité de certification racine, une commande azsphere ou un appel de fonction qui ajoute un nouveau certificat peut remplacer un certificat qui a été ajouté par une commande ou un appel de fonction antérieur, ce qui peut entraîner des échecs de connexion réseau. Nous vous recommandons vivement de développer des procédures de mise à jour de certificat claires et de choisir soigneusement les ID de certificat.
Pour plus d’informations , consultez ID de certificat.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -i, --cert-id | String | Spécifie l’identificateur du certificat à ajouter. Identificateur de chaîne (jusqu’à 16 caractères). Les caractères valides incluent des 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 | String | Spécifie le type de certificat à ajouter, client ou rootca. |
| -p, --public-key-file | String | Spécifie le chemin d’accès à un fichier .pem de certificat de clé publique. Vous pouvez fournir un chemin d’accès relatif ou absolu. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 | String | 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 d’accès relatif ou absolu. |
| -w, --private-key-password | String | Spécifie un mot de passe facultatif pour la clé privée du client. Le mot de passe est requis 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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.
suppression de certificat
Supprime un certificat du magasin de certificats de l’appareil attaché.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -c, --certificate Ou --cert-id [Mise hors service] |
String | Spécifie l’identificateur du certificat à supprimer. L’argument --cert-id sera mis hors service et sera supprimé dans une version ultérieure. Pour plus d’informations, consultez Modifications importantes (fonctionnalités de mise hors service) dans Azure Sphere CLI. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device certificate delete --certificate certclient
liste de certificats
Listes les certificats disponibles dans le magasin de certificats de l’appareil.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 requis
| Paramètre | Type | Description |
|---|---|---|
| -c, --certificate Ou --cert-id [Mise hors service] |
String | 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 version ultérieure. Pour plus d’informations, consultez Modifications importantes (fonctionnalités de mise hors service) dans Azure Sphere CLI. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
certificat 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 | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device certificate show-quota
--------------
Available space (bytes)
==============
24514
--------------
Réclamation
Revendique un appareil précédemment non revendiqué pour le locataire Azure Sphere actuel.
Important
Avant de revendiquer l’appareil, vérifiez que vous êtes connecté au locataire Azure Sphere approprié. Un appareil ne peut être revendiqué qu’une seule fois. Une fois revendiqué, un appareil ne peut pas être déplacé vers un autre locataire.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | 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 vous pouvez 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é de l’utilisateur actuel. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --Debug | Augmente le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
Lit l’appareil attaché pour tester le chargement cloud en désactivant le développement d’applications, en supprimant toutes les applications existantes et en activant les mises à jour des applications chargées dans le cloud.
Il nécessite qu’un appareil soit attaché au PC et fonctionne uniquement sur l’appareil attaché.
Plus précisément, enable-cloud-test :
- Supprime la fonctionnalité appDevelopment pour l’appareil attaché.
- Affecte l’appareil à un groupe d’appareils qui active les mises à jour des applications chargées dans le cloud.
- Redémarre l’appareil.
Les tâches spécifiques effectuées par enable-cloud-test varient selon qu’un produit et un groupe d’appareils ont déjà été affectés pour cet appareil.
Si azsphere device enable-cloud-test est exécuté sans paramètres, l’appareil est placé dans le groupe d’appareils Test sur le terrain 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, ce qui permet de mettre à jour les applications. Une erreur est retournée si l’appareil n’a pas de produit ou s’il n’existe pas de groupe d’appareils test sur le terrain.
Si un produit est spécifié, l’appareil est placé dans le groupe d’appareils Test sur le terrain 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 y est placé. Une erreur est retournée si le groupe d’appareils cible n’active pas les mises à jour de l’application.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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. Lorsque cette valeur est spécifiée, l’appareil est déplacé vers le groupe d’appareils test sur le terrain par défaut de ce produit, sauf si --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 groupe d’appareils <product-name/device-group-name> au format . Par défaut, il s’agit du groupe d’appareils Test sur le terrain du produit. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --Debug | Augmente le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemples
Exemple 1. Attribuer un appareil à un groupe d’appareils existant par son ID
Cet exemple montre comment affecter 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. Affecter un appareil à un autre groupe d’appareils
Cet exemple est similaire à l’exemple précédent, mais conserve le produit existant pour l’appareil. Ici, l’opération enable-cloud-test modifie le groupe d’appareils auquel appartient l’appareil et supprime la fonctionnalité appDevelopment. Cette commande est utile pour déplacer un appareil d’un environnement de développement qui n’active pas les mises à jour d’application vers un environnement de production qui le fait.
azsphere device enable-cloud-test --device-group "Marketing/Field Test"
Exemple 3. Attribuer l’appareil par nom de produit
Cet exemple active le chargement cloud et affecte l’appareil à un produit par son 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 des applications à 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. Ne pas utiliser dans les scénarios de fabrication. Pour plus d’informations, consultez Fabrication d’appareils connectés .
Plus précisément, 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 des applications 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 n’a pas encore de produit ou de 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 créer une application de haut niveau n’est pas affecté.
- Si l’appareil dispose déjà d’un produit, la commande déplace l’appareil vers le groupe d’appareils développement du produit. Par défaut, les mises à jour des applications 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 :
- Places l’appareil dans le groupe d’appareils de développement pour le 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 :
- Places l’appareil du groupe d’appareils spécifié est 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 vous assurer que vous êtes connecté au locataire dans lequel vous avez revendiqué l’appareil. Si ce n’est pas le cas, utilisez azsphere login pour vous connecter au locataire approprié. Lorsque vous êtes sûr d’être connecté au locataire approprié, utilisez la revendication d’appareil azsphere pour revendiquer l’appareil.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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é. En cas d’omission, affecte 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 groupe d’appareils <product-name/device-group-name> au format . |
| -r, --enable-rt-core-debugging | Boolean | Installe les pilotes requis pour déboguer les 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 si --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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 des informations sur les images installées ou ciblées sur l’appareil attaché.
| Opération | Description |
|---|---|
| list-installed | Fournit des détails sur les images actuellement installées sur l’appareil attaché. |
| list-targeted | Fournit des détails sur les images ciblées sur l’appareil attaché. |
image list-installed
Listes les images installées sur l’appareil attaché. La liste des informations inclut les ID de composant et d’image.
Note
Les noms d’image longs sont tronqués à 31 caractères.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 | Listes toutes les images logicielles installées sur l’appareil. Par défaut, répertorie uniquement les images d’application, les débogueurs et les 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
liste d’images ciblée
Listes les images qui ont été chargées sur le service de sécurité Azure Sphere et qui seront installées lors de la mise à jour de l’appareil. Pour plus d’informations sur la façon de garantir que votre appareil Azure Sphere est prêt à accepter les mises à jour d’applications cloud, consultez Activer le déploiement cloud pour votre appareil.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | 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 vous pouvez 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 | Listes 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
----------------------- ------------------------------------ ------------------------------------ -------------------------------------
Liste
Listes 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 Interroger la sortie de la commande CLI.
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
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
Pointe
Exécutez azsphere product show --product-ID <> pour afficher le nom du produit ou azsphere device-group show --device-group <devicegroup-ID> pour afficher le nom du groupe d’appareils.
list-attached
Listes 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
manufacturing-state
Gère l’état de fabrication de l’appareil attaché.
| Opération | Description |
|---|---|
| Montrer | Affiche l’état de fabrication de l’appareil attaché. |
| mettre à jour | Mises à jour l’état de fabrication de l’appareil attaché. |
Attention
Les changements d’état de fabrication sont permanents et irréversibles.
manufacturing-state show
Affiche l’état de fabrication de l’appareil attaché.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device manufacturing-state show
------------------
ManufacturingState
==================
Module1Complete
------------------
mise à jour de l’état de fabrication
Mises à 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 permanents et irréversibles.
Paramètres requis
| 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 | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 la status des interfaces réseau sur l’appareil attaché.
| Opération | Description |
|---|---|
| Activer | Active une interface réseau sur l’appareil attaché. |
| Désactiver | Désactive une interface réseau sur l’appareil attaché. |
| list-firewall-rules | Listes les règles de pare-feu pour l’appareil attaché. |
| list-interfaces | Listes les interfaces réseau de l’appareil attaché. |
| Proxy | Gère les paramètres du proxy 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 le status réseau pour l’appareil attaché. |
| update-interface | Mises à jour une configuration d’interface réseau pour l’appareil. |
activation réseau
Active une interface réseau sur l’appareil attaché.
Note
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 requis
| Paramètre | Type | Description |
|---|---|---|
| --Interface | String | Spécifie l’interface à activer. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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é.
Note
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 requis
| Paramètre | Type | Description |
|---|---|---|
| --Interface | String | Spécifie l’interface à activer. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
Listes les règles de pare-feu pour l’appareil attaché.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 s’affichent :
- Nom de l’ensemble de règles de pare-feu : affiche le nom du bloc d’ensemble de règles de pare-feu.
- Les valeurs sont PREROUTING, POSTROUTING, INPUT, FORWARD et OUTPUT.
- L’ensemble de règles est valide : affiche la status de l’ensemble de règles. Les valeurs sont True ou False.
- Règles d’ensemble 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 l’ordinateur de destomation.
- UID : affiche l’identification de l’utilisateur appliquée à la règle. 4294967295 (0xFFFFFFFF) signifie qu’aucun UID n’a été appliqué et qu’il s’applique donc à tout le monde.
- Action : affiche l’action à entreprendre. Les valeurs peuvent être accept ou drop.
- Nom de l’interface IN : affiche le nom de l’interface d’entrée. Par exemple, wlan0.
- Nom de l’interface OUT : affiche le nom de l’interface de sortie. Par exemple, wlan0.
- État : affiche l’état de la connexion. Les valeurs sont none, établies ou associées.
- Masque TCP : affiche le tableau des masques TCP. Les valeurs sont fin, syn, rst, psh, ack et urg.
- TCP Cmp : affiche le tableau des indicateurs TCP. Les valeurs sont urg, ack, psh, rst, syb et fin.
- TCP Inv : booléen indique que la sensation des indicateurs TCP doit être inversée. 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 de pointeur urgent significatif
- ACK : Champ d’accusé de réception significatif
- PSH : fonction Push
- RST : Réinitialiser la connexion
- SYN : Synchroniser les numéros de séquence
- FIN : Plus de données 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
Listes les interfaces réseau de l’appareil attaché.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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.
Note
Seuls les proxys HTTP sont actuellement pris en charge.
| Opération | Description |
|---|---|
| proxy apply | Configure le proxy réseau sur l’appareil attaché. |
| suppression du 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 requis
| Paramètre | Type | Description |
|---|---|---|
| -a, --address | String | Spécifie l’adresse réseau du proxy à utiliser. |
| -t, --authentication | String | Spécifie le type d’authentification à utiliser. Valeurs autorisées : anonymous ou basic. Si le proxy nécessite un nom d’utilisateur et un mot de passe, définissez-le sur basic, sinon utilisez anonymous. |
| -r, --port | Entier | 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 | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 | String | Spécifie si le proxy doit être activé. Vous devez définir ou --enable--disable. |
| --Désactiver | String | Spécifie si le proxy doit être désactivé. Vous devez définir ou --enable--disable. |
| -n, --no-proxy-addresses | String | Spécifie un tableau d’adresses réseau séparées par des espaces que l’appareil doit éviter pour la connexion proxy. |
| -p, --password | String | Spécifie le mot de passe pour l’authentification proxy uniquement utilisé pour l’authentification de base. Longueur maximale : 64 caractères. |
| -u, --username | String | 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 du proxy
Supprime la connexion proxy sur l’appareil attaché.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 diagnostics pour un ou tous les réseaux Wi-Fi sur l’appareil attaché.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 | Entier | Spécifie l’ID du réseau Wi-Fi pour lequel afficher diagnostics. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --Debug | Augmente le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 le status réseau pour l’appareil attaché.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device network show-status
--------------------------- --------------- -----
DeviceAuthenticationIsReady NetworkTimeSync Proxy
=================================================
True complete ready
--------------------------- --------------- -----
network update-interface
Mises à jour l’interface réseau Ethernet de l’appareil. Pour plus d’informations sur la définition de l’adresse MAC de l’appareil, consultez Configurer l’appareil pour Ethernet.
Note
Cette commande est prise en charge pour la configuration des connexions Ethernet eth0 . Une erreur est retournée si vous configurez loou wlan0azspheresvc .
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| --hardware-address | String | 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 [Mise hors service] |
String | Spécifie le nom de l’interface à configurer. Exécutez azsphere device network list-interfaces pour afficher les détails des interfaces réseau de l’appareil attaché. L’argument --interface-name sera mis hors service et sera supprimé dans une version ultérieure. Pour plus d’informations, consultez Modifications importantes (fonctionnalités de mise hors service) dans Azure Sphere CLI. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
Récupérer
Remplace le logiciel système sur l’appareil.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | 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 | String | Spécifie l’image de capacité de l’appareil à appliquer à l’appareil pendant la récupération. |
| -i, --images | String | Spécifie le chemin d’accès à un dossier qui contient les packages d’images à écrire sur l’appareil. Par défaut, la récupération utilise les images du Kit de développement logiciel (SDK), sauf si un autre chemin d’accès 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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.
rescan-attached
Réanalyse les appareils attachés en mettant en marche tous leurs ports FTDI et affiche le nombre total d’appareils attachés. Utilisez cette commande pour résoudre les 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device rescan-attached
-----------
Count
===========
2
-----------
Redémarrer
Redémarre l’appareil attaché.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device restart
Restarting device.
Device restarted successfully.
Montrer
Affiche les détails d’un appareil attaché dans votre locataire Azure Sphere.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | 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 vous pouvez 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 Interroger la sortie de la commande CLI.
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 des informations sur 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 | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 les status de déploiement des mises à jour de l’application et du système d’exploitation pour l’appareil.
Utilisez cette commande pour déterminer la version du système d’exploitation Azure Sphere que votre appareil exécute ou si la mise à jour de déploiement actuelle est terminée.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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, <numéro de> version représente la version actuelle du système d’exploitation.
show-count
Affiche le nombre d’appareils dans le locataire actuel.
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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 sur l’appareil attaché.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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, <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 temporaires signées en production et de déployer des images permanentes signées en production. La fonctionnalité appDevelopment vous permet de déployer et de supprimer des images signées en production et signées par le SDK.
| Opération | Description |
|---|---|
| Supprimer | Supprime l’application actuelle de l’appareil. |
| Déployer | Charge une application sur l’appareil. |
| set-deployment-timeout | Définit le délai d’attente du déploiement en secondes. |
| show-deployment-timeout | Affiche le délai d’attente du déploiement en secondes. |
Notez que les paramètres de start, stop, show-statuset show-quota ont été déplacés vers la commande azsphere device app .
chargement indépendant de la suppression
Supprime des applications de l’appareil.
Cette commande est disponible uniquement si la fonctionnalité de l’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. En cas d’omission, supprime toutes les applications. |
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device sideload delete
Component '54acba7c-7719-461a-89db-49c807e0fa4d' deleted.
charger une version test du déploiement
Charge une application sur l’appareil attaché et démarre l’application.
Cette commande échoue si le manifeste d’application demande une ressource utilisée par une application qui se trouve déjà sur l’appareil. Dans ce cas, utilisez azsphere device sideload delete pour supprimer l’application existante, puis réessayez de charger une version test. 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 est utilisée pour déployer à la fois des applications de haut niveau et des applications compatibles en temps réel.
Note
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 configuration périphérique.
Si un redémarrage de l’appareil est lancé, attendez que le redémarrage soit terminé et que l’appareil devienne réactif.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -p, --image-package | String | Spécifie le chemin d’accès et le nom de fichier du package d’image à charger sur l’appareil. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 qui peut ne 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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.
chargement indépendant set-deployment-timeout
Définit la valeur du délai d’attente de déploiement en secondes pour le chargement indépendant d’images sur l’appareil.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -v, --value | Entier | 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 actuelle du délai d’attente de déploiement 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device sideload show-deployment-timeout
------------------
Deployment timeout
==================
60
------------------
mettre à jour
Déplace l’appareil dans un autre groupe d’appareils dans votre locataire Azure Sphere.
En plus des groupes d’appareils que vous créez dans un produit, cinq groupes d’appareils par défaut sont ajoutés lors de la création d’un produit :
- Développement : accepte uniquement les mises à jour logicielles système. N’accepte pas les mises à jour de l’application.
- Test sur le terrain : 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 sur le terrain : 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 Principes 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 groupe d’appareils <product-name/device-group-name> au format . |
| -d, --device | String | 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 vous pouvez 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 Interroger la sortie de la commande CLI.
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 Wi-Fi configurations 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. Bien que vous puissiez entrer des caractères non-ASCII dans les SSID, 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 .
| Opération | Description |
|---|---|
| Ajouter | Ajoute les détails d’un réseau sans fil à l’appareil. |
| Désactiver | Désactive un réseau sans fil sur l’appareil. |
| Activer | Active un réseau sans fil sur l’appareil. |
| Oublier | Supprime les détails d’un réseau sans fil de l’appareil. |
| Liste | Listes la configuration Wi-Fi actuelle de l’appareil. |
| reload-config | Recharge la configuration de l’appareil Wi-Fi. |
| numériser | Recherche les réseaux disponibles. |
| Montrer | Affiche les détails d’une configuration Wi-Fi. |
| show-status | Affiche le status de l’interface sans fil. |
wifi add
Ajoute les détails d’un réseau Wi-Fi à l’appareil attaché.
Un appareil peut avoir plusieurs connexions Wi-Fi. Bien que vous puissiez entrer des caractères non-ASCII dans les SSID, azsphere ne les affiche pas correctement.
Vous pouvez inclure le --targeted-scan paramètre pour vous connecter à des SSID masqués. Pour plus d’informations, consultez Connecter Azure Sphere au Wi-Fi.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -s, --ssid | String | Spécifie le SSID du réseau. Les SSID réseau respectent la casse. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| --client-cert-id | String | [EAP-TLS] Spécifie l’identificateur (jusqu’à 16 caractères) qui identifie le certificat client (contenant à la fois la clé publique et la clé privée). Requis pour configurer un réseau EAP-TLS. |
| --client-id <user@domain> | String | [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 | String | Spécifie une chaîne (jusqu’à 16 caractères) qui spécifie le nom de la configuration réseau. |
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 | String | [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 s’il n’est pas diffusé ou est masqué par une congestion du réseau. |
| -p, --psk | String | Spécifie la clé WPA/WPA2 pour le nouveau réseau. Omettez d’ajouter le SSID en tant que réseau ouvert. Si votre 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 la clé ou le SSID réseau comporte des espaces incorporés ou une esperluette, placez le SSID ou la clé entre guillemets simples. Si le SSID ou la clé inclut un guillemet, utilisez une barre oblique inverse pour échapper le guillemet. Les barres obliques inverses n’ont pas besoin d’être placées dans une séquence d’échappement 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"
désactivation du wifi
Désactive un réseau Wi-Fi sur l’appareil attaché.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -i, --id | Entier | Spécifie l’ID du réseau à désactiver. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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
----- -------- ------------------ --------------- ------------- ------------
wi-fi activé
Active un réseau Wi-Fi sur l’appareil attaché.
Pour passer d’un réseau à l’autre si les deux sont dans la plage, désactivez le réseau actuellement connecté avant d’activer le nouveau réseau.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -i, --id | Entier | Spécifie l’ID du réseau à activer. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 requis
| Paramètre | Type | Description |
|---|---|---|
| -i, --id | Entier | Spécifie l’ID du réseau à supprimer. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device wifi forget --id 0
Successfully forgotten network.
liste wifi
Listes la configuration Wi-Fi actuelle pour l’appareil attaché.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 requis
| Paramètre | Type | Description |
|---|---|---|
| -i, --id | Entier | Spécifie l’ID de la configuration réseau à afficher. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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 la status de l’interface Wi-Fi sur l’appareil attaché.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez 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>
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------