Partager via

product

  • Article

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).

Gère les produits.

Operation Description
create Crée un produit.
delete Supprime un produit existant.
device Affiche les appareils de ce produit.
device-group Gère les groupes d’appareils du produit.
list Liste tous les produits du locataire Azure Sphere.
show Affiche les détails d’un produit.
mise à jour Mises à jour des métadonnées spécifiées.

create

Crée un produit.

La commande azsphere product create ajoute automatiquement cinq groupes d’appareils par défaut au produit créé :

  • Le groupe d’appareils Development (Développement) désactive les mises à jour d’applications cloud et fournit le système d’exploitation du flux Distribution.
  • Le groupe d’appareils de test de champ active les mises à jour des applications cloud et fournit le système d’exploitation de vente au détail.
  • Le groupe d’appareils de production active les mises à jour des applications cloud et fournit le système d’exploitation retail.
  • Le groupe d’appareils Production OS Evaluation (Évaluation du système d’exploitation en production) active les mises à jour d’applications cloud et fournit le système d’exploitation du flux Évaluation de la distribution.
  • Le groupe d’appareils Field Test OS Evaluation (Évaluation du système d’exploitation en test réel) active les mises à jour d’applications cloud et fournit le système d’exploitation du flux Évaluation de la distribution.

Paramètres obligatoires

Paramètre Type Description
-n,--name Chaîne Spécifie un nom pour le produit. Le nom ne peut inclure que des caractères alphanumériques. Si le nom comprend des espaces, mettez-le entre guillemets. Le nom du produit ne peut pas dépasser 50 caractères, ne respecte pas la casse et doit être unique au sein d’un locataire.

Paramètres facultatifs

Paramètre Type Description
-g, --no-default-device-groups Boolean Spécifie un indicateur facultatif qui empêche la création des groupes d’appareils par défaut.
-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 produit. La longueur maximale est de 100 caractères. Si la description inclut des espaces, mettez-la entre guillemets.
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 product create --name DW100 --description "Contoso DW100 models"
Default device groups will been created for this product, use the 'azsphere product device-group list' command to see them.
 ------------------------------------ -------------------- ----- ------------------------------------
 TenantId                             Description          Name  Id
 ====================================================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb Contoso DW100 models DW100 6f52bead-700d-4289-bdc2-2f11f774270e
 ------------------------------------ -------------------- ----- ------------------------------------

delete

Supprime le produit spécifié dans votre locataire Azure Sphere.

Un produit ne peut être supprimé que lorsque :

Paramètres obligatoires

Paramètre Type Description
-p, --product GUID ou nom Spécifie le produit à supprimer. Vous pouvez spécifier l’ID ou le nom du produit 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

Exemple pour spécifier le produit par ID :

azsphere product delete --product 6f52bead-700d-4289-bdc2-2f11f774270e

Exemple pour spécifier le produit par nom :

azsphere product delete --product DW100

Un résultat similaire à ceci s’affiche normalement :

Successfully deleted the product

device

Affiche les appareils dans un produit.

Operation Description
list Affiche les appareils dans le produit spécifié.
show-count Retourne le nombre d’appareils dans le produit.

device list

Affiche les appareils dans le produit spécifié, listés par ID d’appareil.

Paramètres obligatoires

Paramètre Type Description
-p, --product GUID ou nom Spécifie le produit dans lequel répertorier les appareils. Vous pouvez spécifier l’ID ou le nom du produit 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

Exemple pour spécifier le produit par ID :

azsphere product device list --product 6f52bead-700d-4289-bdc2-2f11f774270e

Exemple pour spécifier le produit par nom :

azsphere product device list --product DW100

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

Retourne le nombre total des appareils dans tous les groupes d’appareils d’un produit.

Paramètres obligatoires

Paramètre Type Description
-p, --product GUID ou nom Spécifie le produit pour lequel le nombre d’appareils ciblés est affiché. Vous pouvez spécifier l’ID ou le nom du produit 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

Exemple pour spécifier le produit par ID :

azsphere product device show-count --product 6f52bead-700d-4289-bdc2-2f11f774270e

Exemple pour spécifier le produit par nom :

azsphere product device show-count --product DW100

Un résultat similaire à ceci s’affiche normalement :

------
Result
======
2
------

device-group

Gère les groupes d’appareils du produit.

Operation Description
create-defaults Crée les groupes d’appareils par défaut dans le produit spécifié.
list Affiche les groupes d’appareils dans le produit spécifié.

device-group create-defaults

Crée les groupes d’appareils par défaut dans un produit existant.

Paramètres obligatoires

Paramètre Type Description
-p, --product GUID ou nom Spécifie le produit à obtenir. Vous pouvez spécifier l’ID ou le nom du produit 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

Exemple pour spécifier le produit par ID :

azsphere product device-group create-defaults --product 6f52bead-700d-4289-bdc2-2f11f774270e

Exemple pour spécifier le produit par nom :

azsphere product device-group create-defaults --product  DW100

Un résultat similaire à ceci s’affiche normalement :

------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- -------------------------
Id                                   Name                     Description                                   ProductId                            OsFeedType UpdatePolicy                                                           AllowCrashDumpsCollection     RegionalDataBoundary
=====================================================================================================================================================================================================================================================================================
6406868c-19bb-4bea-b4cf-fd80608ee5cb Development              Default development device group              ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail     Accept only system software updates. Don't accept application updates. False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
d2e2b2e7-e219-4af8-8876-f8d10624778b Field Test               Default test device group                     ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail     Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
822f1bda-32d7-404a-bf37-9f90aad09509 Production               Default production device group               ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail     Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
3fafc0e1-f336-4a8a-9be4-fb275322d2cc Production OS Evaluation Default Production OS Evaluation device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 RetailEval Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
b9b7f388-2ad4-4a7e-a4dc-6559fb80741d Field Test OS Evaluation Default Field Test OS Evaluation device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 RetailEval Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------

device-group list

Répertorie tous les groupes d’appareils d’un produit.

Paramètres obligatoires

Paramètre Type Description
-p, --product GUID ou nom Spécifie le produit pour lequel répertorier les groupes d’appareils. Vous pouvez spécifier l’ID ou le nom du produit 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

Exemple pour spécifier le produit par ID :

azsphere product device-group list --product 6f52bead-700d-4289-bdc2-2f11f774270e

Exemple pour spécifier le produit par nom :

azsphere product device-group list --product DW100

Un résultat similaire à ceci s’affiche normalement :

------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- -------------------------
Id                                   TenantId                             OsFeedType ProductId                            Name                     Description                                   UpdatePolicy                                                           AllowCrashDumpsCollection     RegionalDataBoundary
==========================================================================================================================================================================================================================================================================================================================
6406868c-19bb-4bea-b4cf-fd80608ee5cb 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     4f48d618-09f7-45dc-a5a4-1433cabbee91 Development              Default development device group              Accept only system software updates. Don't accept application updates. False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
d2e2b2e7-e219-4af8-8876-f8d10624778b 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     4f48d618-09f7-45dc-a5a4-1433cabbee91 Field Test               Default test device group                     Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
822f1bda-32d7-404a-bf37-9f90aad09509 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     4f48d618-09f7-45dc-a5a4-1433cabbee91 Production               Default production device group               Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
a6c64cda-4ff0-48bb-8a30-6ffab322b846 143adbc9-1bf0-4be2-84a2-084a331d81cb RetailEval 4f48d618-09f7-45dc-a5a4-1433cabbee91 Production OS Evaluation Default Production OS Evaluation device group Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
3fafc0e1-f336-4a8a-9be4-fb275322d2cc 143adbc9-1bf0-4be2-84a2-084a331d81cb RetailEval 4f48d618-09f7-45dc-a5a4-1433cabbee91 Field Test OS Evaluation Default Field Test OS Evaluation device group Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
b9b7f388-2ad4-4a7e-a4dc-6559fb80741d 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     4f48d618-09f7-45dc-a5a4-1433cabbee91 Marketing                Default Marketing device group                Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------

list

Liste tous les produits du 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 product list
------------------------------------ ------------------------------------ --------- --------------------
Id                                   TenantId                             Name      Description
========================================================================================================
6f52bead-700d-4289-bdc2-2f11f774270e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW100     Contoso DW100 models
------------------------------------ ------------------------------------ --------- --------------------
6a82518f-8965-4bd6-ba79-43aa3fcafe5e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW200     Contoso DW200 models
------------------------------------ ------------------------------------ --------- --------------------

show

Affiche les détails d’un produit.

Paramètres obligatoires

Paramètre Type Description
-p, --product GUID ou nom Spécifie le produit à obtenir. Vous pouvez spécifier l’ID ou le nom du produit 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

Exemple pour spécifier le produit et le locataire par ID :

azsphere product show --product 6f52bead-700d-4289-bdc2-2f11f774270e --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb

Exemple pour spécifier le produit et le locataire par nom :

azsphere product show --product DW100 --tenant MyTenant

Un résultat similaire à ceci s’affiche normalement :

------------------------------------ ------------------------------------ ----- --------------------
Id                                   TenantId                             Name  Description
====================================================================================================
6f52bead-700d-4289-bdc2-2f11f774270e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW100 Contoso DW100 models
------------------------------------ ------------------------------------ ----- --------------------

mise à jour

Met à jour les métadonnées du produit spécifié.

Au moins un paramètre facultatif doit être fourni, soit --newname --newdescription. Les deux paramètres peuvent être spécifiés dans une même commande.

Paramètres obligatoires

Paramètre Type Description
-p, --product GUID ou nom Spécifie le produit à mettre à jour. Vous pouvez spécifier l’ID ou le nom du produit Azure Sphere.

Paramètres facultatifs

Paramètre Type Description
-n, --new-name Chaîne Spécifie un nouveau nom pour le produit. Le nom ne peut inclure que des caractères alphanumériques. Si le nom comprend des espaces, mettez-le entre guillemets. Le nom du produit ne peut pas dépasser 50 caractères, ne respecte pas la casse et doit être unique au sein d’un locataire.
-d, --new-description Chaîne Spécifie le texte facultatif pour décrire le produit. La longueur maximale est de 100 caractères.
-t, --tenant Chaîne 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 produit par ID :

azsphere product update --product 6f52bead-700d-4289-bdc2-2f11f774270e --new-description Contoso DW100 models

Exemple pour spécifier le produit par nom :

azsphere product update --product DW100 --new-description Contoso DW100 models

Un résultat similaire à ceci s’affiche normalement :

------------------------------------ ------------------------------------ ----- ------------------
Id                                   TenantId                             Name  Description
==================================================================================================
6a82518f-8965-4bd6-ba79-43aa3fcafe5e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW200 Contoso DW200 models
------------------------------------ ------------------------------------ ----- ------------------