Partage via


az sphere device

Gérer les appareils Azure Sphere.

Opération Description
az sphere device rescan-attached Afficher le nombre d’appareils attachés.
az sphere device list-attached Répertorier tous les appareils attachés.
az sphere device show-attached Afficher les détails de l’appareil attaché.
az sphere device list Répertoriez tous les appareils de votre catalogue, produit ou groupe d’appareils.
az sphere device show-count Afficher le nombre d’appareils dans votre catalogue, produit ou groupe d’appareils.
az sphere device show Afficher les détails d’un appareil existant dans votre groupe de ressources et catalogue.
az sphere device assign Affectez un appareil à un groupe d’appareils dans votre groupe de ressources et catalogue.
az sphere device unassign Annuler l’affectation d’un appareil d’un groupe d’appareils dans votre groupe de ressources et votre catalogue.
az sphere device restart Redémarrez l’appareil attaché.
az sphere device claim Revendiquer un appareil dans votre groupe de ressources et catalogue.
az sphere device recover Utilisez le mode de récupération pour charger le nouveau microprogramme sur l’appareil attaché.
az sphere device show-os-version Afficher la version du système d’exploitation sur l’appareil attaché.
az sphere device show-deployment-status Afficher le status de déploiement du système d’exploitation sur un appareil.
az sphere device enable-development « Activez un appareil pour le développement en activant le chargement indépendant et le débogage sur l’appareil attaché, 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. Non utilisé dans les scénarios de fabrication
az sphere device enable-cloud-test « Activez un appareil pour tester le chargement cloud en désactivant le développement et le débogage sur l’appareil attaché et en l’affectant à un groupe d’appareils qui active les mises à jour des applications à partir du cloud. Par défaut, il s’agit du groupe d’appareils Test sur le terrain du produit de l’appareil, mais d’autres groupes d’appareils peuvent être spécifiés. Non utilisé dans les scénarios de fabrication

Commandes

az sphere device rescan-attached

Afficher le nombre d’appareils attachés.

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Exemples

Afficher le nombre d’appareils attachés.

az sphere device rescan-attached

az sphere device list-attached

Répertorier tous les appareils attachés.

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Exemples

Répertorier tous les appareils attachés.

az sphere device list-attached

az sphere device show-attached

Afficher les détails de l’appareil attaché.

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Paramètre Description
--device -d Appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Spécifiez l’ID, l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Valeurs de : az sphere device list

Exemples

Afficher les détails de l’appareil attaché.

az sphere device show-attached

Afficher les détails de l’appareil spécifié.

az sphere device show-attached --device <DeviceIdValue>

az sphere device list

Répertoriez tous les appareils de votre catalogue, produit ou groupe d’appareils.

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Paramètre Description
--product -p Nom du produit. Valeurs de : az sphere product list
--device-group -dg Groupe d’appareils à afficher. Valeurs de : az sphere device

Exemples

Répertorier tous les appareils d’un groupe de ressources et d’un catalogue.

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog

Répertorier tous les appareils d’un groupe de ressources, d’un catalogue et d’un produit.

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

Répertorier tous les appareils d’un groupe de ressources, d’un catalogue, d’un produit et d’un groupe d’appareils.

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

az sphere device show-count

Afficher le nombre d’appareils dans votre catalogue, produit ou groupe d’appareils.

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Paramètre Description
--product -p Nom du produit. Valeurs de : az sphere product list
--device-group -dg Groupe d’appareils à afficher. Valeurs de : az sphere device

Exemples

Afficher le nombre d’appareils dans un groupe de ressources et un catalogue.

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog

Afficher le nombre d’appareils dans un groupe de ressources, un catalogue et un produit.

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

Afficher le nombre d’appareils dans un groupe de ressources, un catalogue, un produit et un groupe d’appareils.

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

az sphere device show

Afficher les détails d’un appareil existant dans votre groupe de ressources et catalogue.

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Paramètre Description
--device -d Appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Spécifiez l’ID, l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Valeurs de : az sphere device list

Exemples

Afficher les détails d’un appareil à l’aide du groupe de ressources, du nom du catalogue et de l’ID de l’appareil.

az sphere device show --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device assign

Affectez un appareil à un groupe d’appareils dans votre groupe de ressources et catalogue.

Paramètres requis

Paramètre Description
--device -d Appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Spécifiez l’ID, l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Valeurs de : az sphere device list
--target-product Nom du produit cible. Valeurs de : az sphere product list
--target-device-group Nom du groupe d’appareils cible. Valeurs de : az sphere device
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Exemples

Affectez un appareil à l’aide du groupe de ressources, du nom du catalogue, du nom du produit cible, du nom du groupe d’appareils cible et de l’ID de l’appareil.

az sphere device assign --resource-group MyResourceGroup --catalog MyCatalog --target-product MyProduct --target-device-group MyCurrentDeviceGroup --device <DeviceIdValue>

az sphere device unassign

Annuler l’affectation d’un appareil d’un groupe d’appareils dans votre groupe de ressources et votre catalogue.

Paramètres requis

Paramètre Description
--device -d Appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Spécifiez l’ID, l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Valeurs de : az sphere device list
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Exemples

Annuler l’affectation d’un appareil à l’aide du groupe de ressources, du nom du catalogue et de l’ID d’appareil.

az sphere device unassign --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device restart

Redémarrez l’appareil attaché.

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Paramètre Description
--device -d Appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Spécifiez l’ID, l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Valeurs de : az sphere device list

Exemples

Redémarrez l’appareil attaché.

az sphere device restart

Redémarrez un appareil spécifié.

az sphere device restart --device <DeviceIdValue>

az sphere device claim

Revendiquer un appareil dans votre groupe de ressources et catalogue.

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Paramètre Description
--device -d Appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Spécifiez l’ID, l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Valeurs de : az sphere device list
--product -p Nom du produit. Valeurs de : az sphere product list
--device-group -dg Groupe d’appareils à afficher. Valeurs de : az sphere device

Exemples

Revendiquer un appareil à l’aide du groupe de ressources, du nom du catalogue et de l’ID d’appareil.

az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

Revendiquer un appareil à l’aide du groupe de ressources, du nom du catalogue, du nom du produit, du nom du groupe d’appareils et de l’ID d’appareil.

az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

az sphere device recover

Utilisez le mode de récupération pour charger le nouveau microprogramme sur l’appareil attaché.

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Paramètre Description
--device -d Appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Spécifiez l’ID, l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Valeurs de : az sphere device list
--Capacité Nom de fichier d’une image de capacité d’appareil à appliquer à l’appareil lors de la récupération. (Chemin d’accès).
--Images Dossier contenant les packages d’image à écrire sur l’appareil. S’il n’est pas spécifié, les dernières images de système d’exploitation sont téléchargées et utilisées. (Chemin d’accès).

Exemples

Récupérer un appareil attaché.

az sphere device recover

Récupérer un appareil attaché avec des fonctionnalités et des images spécifiques.

az sphere device recover --capability myCapability.cap --images myImagesFolder

az sphere device show-os-version

Afficher la version du système d’exploitation sur l’appareil attaché.

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Paramètre Description
--device -d Appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Spécifiez l’ID, l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Valeurs de : az sphere device list

Exemples

Afficher la version du système d’exploitation sur l’appareil attaché.

az sphere device show-os-version

Afficher la version du système d’exploitation sur un appareil spécifié.

az sphere device show-os-version --device <DeviceIdValue>

az sphere device show-deployment-status

Afficher le status de déploiement du système d’exploitation sur un appareil.

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Paramètre Description
--device -d Appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Spécifiez l’ID, l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Valeurs de : az sphere device list

Exemples

Affichez le status de déploiement du système d’exploitation à l’aide du groupe de ressources, du nom du catalogue et de l’ID d’appareil.

az sphere device show-deployment-status --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device enable-development

« Activez un appareil pour le développement en activant le chargement indépendant et le débogage sur l’appareil attaché, 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. Non utilisé dans les scénarios de fabrication

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Paramètre Description
--device -d Appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Spécifiez l’ID, l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Valeurs de : az sphere device list
--enable-rt-core-debugging -r Installez les pilotes requis pour déboguer les applications s’exécutant sur un cœur en temps réel. Nécessite des autorisations d’administrateur.
--product -p Nom du produit. Valeurs de : az sphere product list
--device-group -dg Groupe d’appareils à afficher. Valeurs de : az sphere device

Exemples

Activez un appareil pour le développement en activant le chargement indépendant et le débogage à l’aide d’un groupe de ressources, d’un nom de catalogue, d’un ID d’appareil et d’un groupe d’appareils de développement par défaut.

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

Activez un appareil pour le développement en activant le chargement indépendant et le débogage à l’aide du groupe de ressources, du nom du catalogue, du nom du produit, du nom du groupe d’appareils et de l’ID d’appareil.

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

az sphere device enable-cloud-test

« Activez un appareil pour tester le chargement cloud en désactivant le développement et le débogage sur l’appareil attaché et en l’affectant à un groupe d’appareils qui active les mises à jour des applications à partir du cloud. Par défaut, il s’agit du groupe d’appareils Test sur le terrain du produit de l’appareil, mais d’autres groupes d’appareils peuvent être spécifiés. Non utilisé dans les scénarios de fabrication

Paramètres requis

Paramètre Description
--catalog -c Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.
--resource-group -r Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Paramètre Description
--device -d Appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Spécifiez l’ID, l’adresse IP ou l’ID de connexion locale d’un appareil attaché. Valeurs de : az sphere device list
--product -p Nom du produit. Valeurs de : az sphere product list
--device-group -dg Groupe d’appareils à afficher. Valeurs de : az sphere device

Exemples

Activez un appareil pour tester le cloud à l’aide d’un groupe de ressources, d’un nom de catalogue, d’un ID d’appareil et d’un groupe d’appareils test sur le terrain par défaut.

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

Activez un appareil pour tester le cloud à l’aide du groupe de ressources, du nom du catalogue, du nom du produit, du nom du groupe d’appareils et de l’ID d’appareil.

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>