device-group
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).
Crée et gère des groupes d’appareils.
Les groupes d’appareils sont traités par identificateur (ID) ou par une paire nom de produit et nom de groupe d’appareils.
| Operation | Description |
|---|---|
| create | Crée un groupe d’appareils. |
| list | Répertoriez tous les groupes d’appareils dans votre locataire Azure Sphere. |
| delete | Supprime un groupe d’appareils existant. |
| deployment | Gère les déploiements au sein d’un groupe d’appareils. |
| device | Répertorie les appareils d’un groupe d’appareils. |
| show | Affiche des informations sur un groupe d’appareils. |
| mise à jour | Modifie un groupe d’appareils existant. |
create
Crée un groupe d’appareils avec le nom défini pour le produit spécifié. Le groupe d’appareils organise les appareils qui ont le même produit et reçoivent les mêmes applications en provenance du cloud.
Paramètres obligatoires
| Paramètre | Type | Description |
|---|---|---|
| -p, --product | GUID ou nom | Spécifie le produit auquel ajouter ce groupe d’appareils. Vous pouvez spécifier l’ID ou le nom du produit Azure Sphere. |
| -n,--name | Chaîne | Spécifie un nom pour le groupe d’appareils. Le nom ne peut inclure que des caractères alphanumériques. Si le nom comprend des espaces, mettez-le entre guillemets. Le nom du groupe d’appareils ne peut pas dépasser 50 caractères, ne respecte pas la casse, doit être unique dans le produit. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -a, --application-update | Enum | Spécifie la stratégie de mise à jour d’application à appliquer pour ce groupe d’appareils. Valeurs acceptées : No3rdPartyAppUpdates, UpdateAllet NoUpdates. La valeur par défaut est UpdateAll. La NoUpdates stratégie est actuellement réservée uniquement pour une utilisation interne. |
| -f, --os-feed | Enum | Spécifie le type de flux de système d’exploitation à utiliser pour les mises à jour du système d’exploitation. Valeurs acceptées : Retail, RetailEval. |
| -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. |
| -d, --description | Chaîne | Spécifie le texte facultatif pour décrire le groupe d’appareils. La longueur maximale est de 100 caractères. Si la description inclut des espaces, mettez-la entre guillemets. |
| -r, --regional-data-boundary | Chaîne | Limite de données régionales pour cette image. Valeurs autorisées : EU, None. La valeur par défaut est None. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée. Pour plus d’informations, consultez Configurer les vidages sur incident - Considérations relatives à Pivacy |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --debug | Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes. |
| --only-show-errors | Affiche uniquement les erreurs, en supprimant les avertissements. |
| -o, --output | Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere. |
| --query | Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI. |
| --verbose | Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets. |
Remarque
Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device-group create --name Marketing --product DW100
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- ---------------------
Id TenantId OsFeedType ProductId Name UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
===================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
list
Répertoriez tous les groupes d’appareils dans votre locataire Azure Sphere.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -t, --tenant | GUID ou nom | Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --debug | Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes. |
| --only-show-errors | Affiche uniquement les erreurs, en supprimant les avertissements. |
| -o, --output | Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere. |
| --query | Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI. |
| --verbose | Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets. |
Remarque
Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device-group list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- ---------------------
Id Name Description ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
=====================================================================================================================================================================================================================================================================================
a3a49688-4601-4422-8b51-a0838ea84627 Development Default development device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept only system software updates. Don't accept application updates. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
7cb46b96-8c17-4afd-bd3f-614acad9d264 Field Test Default test device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
30c39bae-f525-4094-8008-d03705429ef0 Production Default production device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
cb5c9685-5dbe-470c-91a9-91dc129884d6 Production OS Evaluation Default Production OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
63e72035-3fcf-4fdc-b88a-05e30d1ba224 Field Test OS Evaluation Default Field Test OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
delete
Supprime le groupe d’appareils spécifié dans votre locataire Azure Sphere.
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.
Paramètres obligatoires
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | Chaîne | Spécifie le groupe d’appareils à supprimer. Vous pouvez spécifier l’ID du groupe d’appareils ou le nom du groupe d’appareils. Pour utiliser le nom du groupe d’appareils, vous devez fournir le nom du produit et le nom du <product-name/device-group-name> groupe d’appareils au format. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -t, --tenant | GUID ou nom | Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --debug | Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes. |
| --only-show-errors | Affiche uniquement les erreurs, en supprimant les avertissements. |
| -o, --output | Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere. |
| --query | Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI. |
| --verbose | Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets. |
Remarque
Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere device-group delete --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Successfully deleted the device group
azsphere device-group delete --device-group DW100/Development
Successfully deleted the device group
deployment
Gère les déploiements pour un groupe d’appareils.
| Operation | Description |
|---|---|
| create | Crée un déploiement pour le groupe d’appareils spécifié. |
| list | Affiche les déploiements pour un groupe d’appareils. |
deployment create
Crée un déploiement pour un groupe d’appareils avec les images fournies.
Vous pouvez identifier le groupe d’appareils par identificateur (ID) ou par une paire nom de produit et nom de groupe d’appareils.
Paramètres obligatoires
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | Chaîne | Spécifie le groupe d’appareils dans lequel créer le déploiement. Vous pouvez spécifier l’ID du groupe d’appareils ou le nom du groupe d’appareils. Pour utiliser le nom du groupe d’appareils, vous devez fournir le nom du produit et le nom du <product-name/device-group-name> groupe d’appareils au format. |
| -i, --images | Chaîne | Spécifie les ID d’image pour une ou plusieurs images à inclure dans le déploiement. Vous pouvez ajouter plusieurs images en ajoutant des paramètres supplémentaires, ou plusieurs ID d’image peuvent être combinés dans un seul paramètre d’une liste séparée par un espace. Exécutez la commande azsphere image add pour obtenir l’ID d’image. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -t, --tenant | GUID ou nom | Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --debug | Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes. |
| --only-show-errors | Affiche uniquement les erreurs, en supprimant les avertissements. |
| -o, --output | Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere. |
| --query | Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI. |
| --verbose | Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets. |
Remarque
Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
Le --device-group paramètre identifie le groupe d’appareils. L’ID de groupe d’appareils fournit un GUID, qui identifie de façon unique le groupe d’appareils sur tous les produits. Vous pouvez également utiliser le nom du produit et la <paire de noms de groupe d’appareils au format product-name>/<device-group-name> . Cette paire de noms identifie de façon univoque un groupe d’appareils pour un produit particulier.
Exemple pour spécifier le groupe d’appareils par ID :
azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Exemple pour spécifier le groupe d’appareils par nom :
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Exemple pour spécifier plusieurs ID d’image en fournissant une liste de valeurs séparées par des espaces :
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4
Un résultat similaire à ceci s’affiche normalement :
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb 5572509b-43a4-45b0-88c5-365cbf9732c1 2021-04-01T18:48:41.721662+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
deployment list
Affiche l’historique de déploiement d’un groupe d’appareils. Retourne l’ID de déploiement, l’horodatage et la liste des images incluses. La liste est triée en fonction des déploiements les plus récents.
Paramètres obligatoires
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | Chaîne | Spécifie le groupe d’appareils pour lequel afficher la liste d’historiques de déploiement. Vous pouvez spécifier l’ID du groupe d’appareils ou le nom du groupe d’appareils. Pour utiliser le nom du groupe d’appareils, vous devez fournir le nom du produit et le nom du <product-name/device-group-name> groupe d’appareils au format. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -t, --tenant | GUID ou nom | Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --debug | Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes. |
| --only-show-errors | Affiche uniquement les erreurs, en supprimant les avertissements. |
| -o, --output | Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere. |
| --query | Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI. |
| --verbose | Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets. |
Remarque
Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
Exemple pour spécifier le groupe d’appareils par ID :
azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Exemple pour spécifier le groupe d’appareils par nom :
azsphere device-group deployment list --device-group DW100/Development
Un résultat similaire à ceci s’affiche normalement :
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb e3769536-dc4b-48d9-afd4-22ed321ba4bc 2020-11-18T19:46:50.514429+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
device
Gère les appareils d’un groupe d’appareils.
| Operation | Description |
|---|---|
| list | Affiche les appareils contenus dans un groupe d’appareils. |
| show-count | Indique le nombre d’appareils qui se trouvent dans un groupe d’appareils. |
device list
Affiche les appareils contenus dans un groupe d’appareils.
Paramètres obligatoires
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | Chaîne | Spécifie le groupe d’appareils pour lequel afficher la liste des appareils. Vous pouvez spécifier l’ID du groupe d’appareils ou le nom du groupe d’appareils. Pour utiliser le nom du groupe d’appareils, vous devez fournir le nom du produit et le nom du <product-name/device-group-name> groupe d’appareils au format. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -t, --tenant | GUID ou nom | Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --debug | Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes. |
| --only-show-errors | Affiche uniquement les erreurs, en supprimant les avertissements. |
| -o, --output | Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere. |
| --query | Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI. |
| --verbose | Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets. |
Remarque
Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
Exemple pour spécifier le groupe d’appareils par ID :
azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Exemple pour spécifier le groupe d’appareils par nom :
azsphere device-group device list --device-group DW100/Marketing
Un résultat similaire à ceci s’affiche normalement :
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
device show-count
Affiche le nombre d’appareils qui se trouvent dans un groupe d’appareils.
Paramètres obligatoires
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | Chaîne | Spécifie le groupe d’appareils pour lequel afficher le nombre d’appareils. Vous pouvez spécifier l’ID du groupe d’appareils ou le nom du groupe d’appareils. Pour utiliser le nom du groupe d’appareils, vous devez fournir le nom du produit et le nom du <product-name/device-group-name> groupe d’appareils au format. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -t, --tenant | GUID ou nom | Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --debug | Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes. |
| --only-show-errors | Affiche uniquement les erreurs, en supprimant les avertissements. |
| -o, --output | Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere. |
| --query | Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI. |
| --verbose | Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets. |
Remarque
Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
Exemple pour spécifier le groupe d’appareils par ID :
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Exemple pour spécifier le groupe d’appareils par nom :
azsphere device-group device show-count --device-group DW100/Marketing
Un résultat similaire à ceci s’affiche normalement :
------
Result
======
1
------
show
Affiche les informations relatives à un groupe d’appareils.
Paramètres obligatoires
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | Chaîne | Spécifie le groupe d’appareils pour lequel afficher les détails. Vous pouvez spécifier l’ID du groupe d’appareils ou le nom du groupe d’appareils. Pour utiliser le nom du groupe d’appareils, vous devez fournir le nom du produit et le nom du <product-name/device-group-name> groupe d’appareils au format. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -t, --tenant | GUID ou nom | Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --debug | Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes. |
| --only-show-errors | Affiche uniquement les erreurs, en supprimant les avertissements. |
| -o, --output | Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere. |
| --query | Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI. |
| --verbose | Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets. |
Remarque
Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
Exemple pour spécifier le groupe d’appareils par ID :
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Exemple pour spécifier le groupe d’appareils par nom :
azsphere device-group show --device-group DW100/Marketing
Un résultat similaire à ceci s’affiche normalement :
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Id Name Description TenantId ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd Marketing Marketing device group 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
mise à jour
Met à jour un groupe d’appareils existant, identifié par l’ID ou par la paire nom de produit et nom de groupe d’appareils.
Paramètres obligatoires
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | Chaîne | Spécifie le groupe d’appareils pour lequel mettre à jour les détails. Vous pouvez spécifier l’ID du groupe d’appareils ou le nom du groupe d’appareils. Pour utiliser le nom du groupe d’appareils, vous devez fournir le nom du produit et le nom du <product-name/device-group-name> groupe d’appareils au format. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -c, --allow-crash-dumps-collection | Chaîne | Définissez le consentement pour la collecte des vidages sur incident par Microsoft pour le groupe d’appareils. La valeur par défaut est Off. Valeurs autorisées : Off et On. Utilisez le --regional-data-boundary paramètre pour spécifier où les fichiers de vidage sur incident doivent être stockés. Pour plus d’informations, consultez Configurer les vidages sur incident. |
| -a, --application-update | ApplicationUpdatePolicyType | Spécifie la stratégie de mise à jour d’application pour le groupe d’appareils. Valeurs autorisées : No3rdPartyAppUpdates, UpdateAll et NoUpdates. La valeur par défaut est UpdateAll. La NoUpdates stratégie est actuellement réservée uniquement pour une utilisation interne. |
| -d, --new-description | Chaîne | Spécifie le texte facultatif pour décrire le groupe d’appareils. La longueur maximale est de 100 caractères. |
| -n, --new-name | Chaîne | Spécifie un nouveau nom pour le groupe d’appareils. Le nom ne peut inclure que des caractères alphanumériques. Si le nom comprend des espaces, mettez-le entre guillemets. Le nom du groupe d’appareils ne peut pas dépasser 50 caractères, ne respecte pas la casse et doit être unique dans le produit. |
| -f, --os-feed | Chaîne | Spécifie le flux du système d’exploitation pour le groupe d’appareils. Les valeurs possibles sont Retail et RetailEval. |
| -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. |
| -r, --regional-data-boundary | Chaîne | Limite de données régionales pour cette image. Valeurs autorisées : EU, None. La valeur par défaut est None. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée. Pour plus d’informations, consultez Configurer les vidages sur incident - Considérations relatives à Pivacy |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --debug | Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes. |
| --only-show-errors | Affiche uniquement les erreurs, en supprimant les avertissements. |
| -o, --output | Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere. |
| --query | Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI. |
| --verbose | Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets. |
Remarque
Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
Exemple pour spécifier le groupe d’appareils par ID :
azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"
Exemple pour spécifier le groupe d’appareils par nom :
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
Un résultat similaire à ceci s’affiche normalement :
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
Id TenantId OsFeedType ProductId Name Description UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Marketing device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------