Gérer les groupes d’appareils
Important
Il s’agit de la documentation Azure Sphere (héritée). Azure Sphere (hérité) prend sa retraite le 27 septembre 2027 et les utilisateurs doivent migrer vers Azure Sphere (intégré) pour l’instant. Utilisez le sélecteur de version situé au-dessus du TOC pour afficher la documentation Azure Sphere (intégrée).
Cette rubrique explique comment gérer vos groupes d’appareils à l’aide de l’interface CLI ou de l’Explorateur Azure Sphere. Les étapes décrites dans cette rubrique supposent que vous connaissez les concepts des locataires, produits et groupes d’appareils Azure Sphere.
Répertorier les groupes d’appareils
Répertoriez tous les groupes d’appareils dans votre locataire Azure Sphere à l’aide de la commande azsphere device-group list ou à l’aide de l’API Groupe d’appareils - Répertorier.
Pour répertorier tous les groupes d’appareils :
azsphere device-group list
Répertoriez les groupes d’appareils dans un produit spécifique à l’aide de la commande azsphere product device-group list ou à l’aide de l’API Product - List Groups.
azsphere product device-group list --product <product-name>
Ouvrez l’Explorateur Azure Sphere.
Développez le nœud Client pour le locataire qui vous intéresse.
Ouvrez l’Explorateur Azure Sphere.
Développez le nœud Client pour le locataire qui vous intéresse.
Pour afficher les produits et groupes d’appareils d’un locataire :
Ouvrez l’Explorateur Azure Sphere.
Développez le nœud Client pour le locataire qui vous intéresse.
Si aucun produit n’est répertorié, créez un produit.
Si l’appareil est déjà associé à un produit et affecté à un groupe, vous pouvez mettre à jour son groupe d’appareils à tout moment.
Pour afficher les produits et groupes d’appareils d’un locataire :
Ouvrez l’Explorateur Azure Sphere.
Développez le nœud Client pour le locataire qui vous intéresse.
Si aucun produit n’est répertorié, créez un produit.
Si l’appareil est déjà associé à un produit et affecté à un groupe, vous pouvez mettre à jour son groupe d’appareils à tout moment.
Créer un groupe d’appareils
Créez un groupe d’appareils à l’aide de la commande azsphere device-group create ou à l’aide de l’API Groupe d’appareils - Créer une API.
Pour créer un groupe d’appareils :
azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>
Les noms des groupes d’appareils peuvent contenir uniquement des caractères alphanumériques et des espaces. Ils ne peuvent pas dépasser 50 caractères. Si le nom ou la description inclut des espaces, placez-le entre guillemets.
Vous pouvez inclure les paramètres facultatifs suivants :
--os-feedspécifie le type de flux de système d’exploitation à utiliser pour les mises à jour du système d’exploitation.--application-updatedéfinit la stratégie de mise à jour d’application pour ce groupe d’appareils.
Ouvrez l’Explorateur Azure Sphere.
Pour le locataire qui vous intéresse, développez le nœud Product.
Pour le produit qui vous intéresse, cliquez avec le bouton droit et sélectionnez Nouveau groupe d’appareils.
Spécifiez un nom pour le groupe d’appareils, puis appuyez sur Entrée. Les noms des groupes d’appareils peuvent contenir uniquement des caractères alphanumériques et des espaces. Ils ne peuvent pas dépasser 50 caractères. Si vous spécifiez un nom non valide, une erreur est signalée dans la fenêtre Sortie .
Vous pouvez créer un groupe d’appareils dans Visual Studio Code, mais pas le supprimer. Pour supprimer un groupe d’appareils, utilisez la commande azsphere device-group delete ou l’API publique Azure Sphere.
Ouvrez l’Explorateur Azure Sphere.
Pour le locataire qui vous intéresse, développez le nœud Product.
Pour le produit qui vous intéresse, cliquez avec le bouton droit et sélectionnez Nouveau groupe d’appareils.
Spécifiez un nom pour le groupe d’appareils, puis appuyez sur Entrée ou cliquez sur Appliquer. Les noms des groupes d’appareils peuvent contenir uniquement des caractères alphanumériques et des espaces. Ils ne peuvent pas dépasser 50 caractères. Si vous spécifiez un nom non valide, une erreur est signalée dans la fenêtre Sortie .
Vous pouvez créer un groupe d’appareils dans Visual Studio, mais pas le supprimer. Pour supprimer des produits, utilisez la commande azsphere device-group delete ou l’API publique Azure Sphere.
Mettre à jour le groupe d’appareils
Vous pouvez modifier le nom ou la description d’un groupe d’appareils à l’aide de la commande azsphere device-group update ou à l’aide de l’API Device Group - Patch.
Pour mettre à jour le nom et la description d’un groupe d’appareils :
azsphere device-group update --device-group <device group ID or product-name/device-group-name> --new-name <new-device-group-name> --new-description <new-device-group-description>
Vous pouvez également mettre à jour les paramètres et les os-feed paramètres à l’aide de la commande azsphere device-group update.application-update
Ouvrez l’Explorateur Azure Sphere.
Pour le locataire qui vous intéresse, développez le nœud Product.
Pour le produit qui vous intéresse, développez le nœud produit pour afficher ses groupes d’appareils inclus. Vous pouvez renommer le groupe d’appareils ou mettre à jour sa description, son type de flux de système d’exploitation ou la stratégie de mise à jour :
Pour renommer un groupe d’appareils, cliquez avec le bouton droit sur le nom du groupe d’appareils, puis sélectionnez Renommer, tapez un nouveau nom, puis appuyez sur Entrée. Les noms des groupes d’appareils peuvent contenir uniquement des caractères alphanumériques et des espaces. Ils ne peuvent pas dépasser 50 caractères. Si vous spécifiez un nom non valide, une erreur est signalée dans la fenêtre Sortie .
Pour mettre à jour la description du groupe d’appareils, cliquez avec le bouton droit sur le nom du groupe d’appareils, puis sélectionnez Mettre à jour la description, tapez une nouvelle description, puis appuyez sur Entrée.
Pour mettre à jour le type de flux de système d’exploitation, développez le groupe d’appareils, cliquez avec le bouton droit sur Le type de flux du système d’exploitation, sélectionnez Mettre à jour, puis choisissez Retail ou RetailEval dans le menu.
Pour modifier la stratégie de mise à jour, développez le groupe d’appareils, cliquez avec le bouton droit sur Mettre à jour, sélectionnez Mettre à jour, puis choisissez No3rdPartyAppUpdates ou UpdateAll dans le menu. (La troisième option, NoUpdates est actuellement réservé à une utilisation interne. Si vous choisissez cette option, une erreur est signalée dans la fenêtre Sortie .)
Déplacez un appareil vers un autre groupe d’appareils à l’aide de la commande azsphere device update ou à l’aide de l’API Devices - Move.
Ouvrez l’Explorateur Azure Sphere.
Pour le locataire qui vous intéresse, développez le nœud Product.
Pour le produit qui vous intéresse, développez le nœud produit pour afficher ses groupes d’appareils inclus. Vous pouvez renommer le groupe d’appareils ou mettre à jour sa description, son type de flux de système d’exploitation ou la stratégie de mise à jour :
Pour renommer un groupe d’appareils, sélectionnez le nom du groupe d’appareils, puis appuyez sur F2 ou cliquez avec le bouton droit sur le nom du groupe d’appareils, puis sélectionnez Renommer, tapez un nouveau nom, puis appuyez sur Entrée ou cliquez sur Appliquer. Les noms des groupes d’appareils peuvent contenir uniquement des caractères alphanumériques et des espaces. Ils ne peuvent pas dépasser 50 caractères. Si vous spécifiez un nom non valide, une erreur est signalée dans la fenêtre Sortie .
Pour mettre à jour la description du groupe d’appareils, développez le groupe d’appareils, sélectionnez Description, appuyez sur F2 ou cliquez avec le bouton droit sur Description, puis tapez une nouvelle description, puis appuyez sur Entrée ou cliquez sur Appliquer.
Pour mettre à jour le type de flux de système d’exploitation, développez le groupe d’appareils, sélectionnez type de flux de système d’exploitation, appuyez sur F2 ou cliquez avec le bouton droit sur Le flux du système d’exploitation, puis sélectionnez Modifier, choisissez Retail ou RetailEval dans le menu, puis appuyez sur Entrée ou cliquez sur Appliquer.
Pour modifier la stratégie de mise à jour, développez le groupe d’appareils, sélectionnez Mettre à jour la stratégie, puis appuyez sur F2 ou cliquez avec le bouton droit sur Mettre à jour , puis sélectionnez Modifier, choisissez No3rdPartyAppUpdates ou UpdateAll dans le menu, puis appuyez sur Entrée ou cliquez sur Appliquer. (La troisième option, NoUpdates est actuellement réservé à une utilisation interne. Si vous choisissez cette option, une erreur est signalée dans la fenêtre Sortie ).
Déplacez un appareil vers un autre groupe d’appareils à l’aide de la commande azsphere device update ou à l’aide de l’API Devices - Move.
Déplacer un appareil vers un autre groupe d’appareils
Déplacez un appareil vers un autre groupe d’appareils à l’aide de la commande azsphere device update ou à l’aide de l’API Devices - Move.
Spécifiez l’ID du groupe d’appareils ou une combinaison du nom du produit et du <nom du groupe d’appareils au format product-name/<device-group-name>> :
azsphere device update --device-group <device-group-id>
azsphere device update --device-group <product-name/device-group-name>
Supprimer un groupe d’appareils
Supprimez un groupe d’appareils spécifié dans votre locataire Azure Sphere à l’aide de la commande azsphere device-group delete ou à l’aide de l’API Groupe d’appareils - Supprimer.
Un groupe d’appareils ne peut être supprimé que lorsque :
- L’utilisateur dispose des autorisations d’administrateur pour le locataire.
- Le groupe d’appareils est vide et ne contient aucun appareil. La commande azsphere device-group device list répertorie tous les appareils d’un groupe d’appareils. Exécutez azsphere device update --device-group pour déplacer l’appareil vers un autre groupe d’appareils.
Spécifiez l’ID du groupe d’appareils ou une combinaison du nom du produit et du <nom du groupe d’appareils au format product-name/<device-group-name>> :
azsphere device-group delete --device-group <device-group-id>
azsphere device-group delete --device-group <product-name/device-group-name>