groupe d’appareils
Crée et gère des groupes d’appareils.
Les groupes d’appareils sont traités par un identificateur (ID) ou par une paire nom de produit et nom de groupe d’appareils.
| Opération | Description |
|---|---|
| Créer | Crée un groupe d’appareils. |
| Liste | Répertoriez tous les groupes d’appareils dans votre locataire Azure Sphere. |
| Supprimer | Supprime un groupe d’appareils existant. |
| Déploiement | Gère les déploiements au sein d’un groupe d’appareils. |
| Appareil | Répertorie les appareils d’un groupe d’appareils. |
| Montrer | Affiche des informations sur un groupe d’appareils. |
| mettre à jour | Modifie un groupe d’appareils existant. |
Créer
Crée un groupe d’appareils avec le nom spécifié 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 à partir du cloud.
Paramètres requis
| 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 | String | 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, placez-le entre guillemets. Le nom du groupe d’appareils ne peut pas dépasser 50 caractères. Il ne respecte pas la casse et doit être unique au sein du 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 à un usage interne uniquement. |
| -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 | String | Spécifie le texte facultatif pour décrire le groupe d’appareils. La longueur maximale est de 100 caractères. Si la description comprend des espaces, placez-la entre guillemets. |
| -r, --regional-data-boundary | String | Limite de données régionale 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 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-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
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Liste
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 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-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
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
Supprimer
Supprime le groupe d’appareils spécifié dans votre locataire Azure Sphere.
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.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | String | 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 groupe d’appareils <product-name/device-group-name> 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 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-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
Déploiement
Gère les déploiements pour un groupe d’appareils.
| Opération | Description |
|---|---|
| Créer | Crée un déploiement pour le groupe d’appareils spécifié. |
| Liste | Affiche les déploiements d’un groupe d’appareils. |
création de déploiement
Crée un déploiement pour un groupe d’appareils avec les images fournies.
Vous pouvez identifier le groupe d’appareils à l’aide d’un identificateur (ID) ou d’une paire nom de produit et nom de groupe d’appareils.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | String | 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 groupe d’appareils <product-name/device-group-name> au format . |
| -i, --images | String | 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 dans une liste séparée par des espaces. 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 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
Le --device-group paramètre identifie le groupe d’appareils. L’ID du groupe d’appareils fournit un GUID, qui identifie de manière unique le groupe d’appareils sur tous les produits. Vous pouvez également utiliser la paire nom du produit et nom du groupe d’appareils au <format product-name>/<device-group-name> . Cette paire de noms identifie de façon unique un groupe d’appareils pour un produit particulier.
Exemple pour spécifier un 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 un 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
Vous devriez voir une sortie semblable à celle-ci :
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
liste de déploiement
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 par déploiements les plus récents.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | String | Spécifie le groupe d’appareils pour lequel afficher la liste de l’historique 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 groupe d’appareils <product-name/device-group-name> 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 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 pour spécifier un groupe d’appareils par ID :
azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Exemple pour spécifier un groupe d’appareils par nom :
azsphere device-group deployment list --device-group DW100/Development
Vous devriez voir une sortie semblable à celle-ci :
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Appareil
Gère les appareils d’un groupe d’appareils.
| Opération | Description |
|---|---|
| Liste | Affiche les appareils d’un groupe d’appareils. |
| show-count | Affiche le nombre d’appareils dans un groupe d’appareils. |
liste des appareils
Affiche les appareils d’un groupe d’appareils.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | String | 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 groupe d’appareils <product-name/device-group-name> 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 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 pour spécifier un groupe d’appareils par ID :
azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Exemple pour spécifier un groupe d’appareils par nom :
azsphere device-group device list --device-group DW100/Marketing
Vous devriez voir une sortie semblable à celle-ci :
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
nombre d’affichages des appareils
Affiche le nombre d’appareils dans un groupe d’appareils.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | String | 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 groupe d’appareils <product-name/device-group-name> 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 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 pour spécifier un groupe d’appareils par ID :
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Exemple pour spécifier un groupe d’appareils par nom :
azsphere device-group device show-count --device-group DW100/Marketing
Vous devriez voir une sortie semblable à celle-ci :
------
Result
======
1
------
Montrer
Retourne des informations sur un groupe d’appareils.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | String | 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 groupe d’appareils <product-name/device-group-name> 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 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 pour spécifier un groupe d’appareils par ID :
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Exemple pour spécifier un groupe d’appareils par nom :
azsphere device-group show --device-group DW100/Marketing
Vous devriez voir une sortie semblable à celle-ci :
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
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
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
mettre à jour
Mises à jour un groupe d’appareils existant, identifié par id ou par nom de produit et paire de noms de groupe d’appareils.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -g, --device-group | String | 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 groupe d’appareils <product-name/device-group-name> au format . |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -c, --allow-crash-dumps-collection | String | Définissez le consentement pour la collecte de 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 des vidages sur incident. |
| -a, --application-update | ApplicationUpdatePolicyType | Spécifie la stratégie de mise à jour de l’application pour le groupe d’appareils. Valeurs autorisées : No3rdPartyAppUpdates, UpdateAllet NoUpdates. La valeur par défaut est UpdateAll. La NoUpdates stratégie est actuellement réservée à un usage interne uniquement. |
| -d, --new-description | String | Spécifie le texte facultatif pour décrire le groupe d’appareils. La longueur maximale est de 100 caractères. |
| -n, --new-name | String | 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, placez-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 au sein du produit. |
| -f, --os-feed | String | 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 | String | Limite de données régionale 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 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 pour spécifier un 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 un groupe d’appareils par nom :
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
Vous devriez voir une sortie semblable à celle-ci :
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------