Gérer les groupes d’appareils
Cette rubrique explique comment gérer vos groupes d’appareils à l’aide de l’interface CLI ou d’Azure Sphere Explorer. Les étapes décrites dans cette rubrique supposent que vous êtes familiarisé avec 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 - Liste .
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>
Développez le nœud Locataire pour le locataire qui vous intéresse.
Développez le nœud Locataire pour le locataire qui vous intéresse.
Pour afficher les produits et les groupes d’appareils d’un locataire :
Développez le nœud Locataire pour le locataire qui vous intéresse.
Si aucun produit n’est répertorié, créez-en un.
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 les groupes d’appareils d’un locataire :
Développez le nœud Locataire pour le locataire qui vous intéresse.
Si aucun produit n’est répertorié, créez-en un.
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 .
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 comprend des espaces, placez-les 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.
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.
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 de l’API Groupe d’appareils - Correctif .
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 à application-update l’aide os-feed de la commande azsphere device-group update.
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 sa stratégie de mise à jour :
Pour renommer un groupe d’appareils, cliquez avec le bouton droit sur le nom du groupe d’appareils, 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, 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 Type de flux de système d’exploitation, sélectionnez Mettre à jour, puis choisissez Vente au détail ou DétailVal 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 la stratégie, sélectionnez Mettre à jour, puis choisissez No3rdPartyAppUpdates ou Mettre à jourToutes dans le menu. (La troisième option, NoUpdates, est actuellement réservée à un usage 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 Appareils - Déplacer .
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 sa stratégie de mise à jour :
Pour renommer un groupe d’appareils, sélectionnez le nom du groupe d’appareils et appuyez sur F2 ou cliquez avec le bouton droit sur le nom du groupe d’appareils, 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 et appuyez sur F2 ou cliquez avec le bouton droit sur Description , sélectionnez Modifier, 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 du système d’exploitation , appuyez sur F2 ou cliquez avec le bouton droit sur Type de flux de système d’exploitation , sélectionnez Modifier, choisissez Vente au détail ou Vente au détail 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 et appuyez sur F2 ou cliquez avec le bouton droit sur Mettre à jour la stratégie et sélectionnez Modifier, choisissez No3rdPartyAppUpdates ou Mettre à jourToutes dans le menu, puis appuyez sur Entrée ou cliquez sur Appliquer. (La troisième option, NoUpdates, est actuellement réservée à un usage 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 Appareils - Déplacer .
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 Appareils - Déplacer .
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 dans les cas suivants :
- L’utilisateur dispose d’autorisations d’administrateur sur 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>