Partager via

az sphere device-group

Note

Cette référence fait partie de l’extension azure-sphere pour Azure CLI (version 2.45.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az sphere device-group. Apprenez-en davantage sur les extensions.

Gérez les groupes d’appareils dans votre groupe de ressources et votre catalogue.

Commandes

Nom Description Type État
az sphere device-group create

Créer un groupe d'appareils

 Extension GA
az sphere device-group create-defaults

Créez des groupes d’appareils par défaut ciblant un produit.

 Extension GA
az sphere device-group delete

Supprimez le groupe d’appareils spécifié.

 Extension GA
az sphere device-group list

Répertorier tous les groupes d’appareils dans un catalogue.

 Extension GA
az sphere device-group show

Afficher les détails d’un groupe d’appareils.

 Extension GA
az sphere device-group update

Mettez à jour les détails d’un groupe d’appareils.

 Extension GA

az sphere device-group create

Créer un groupe d'appareils

az sphere device-group create --catalog
                              --description
                              --name
                              --product
                              --resource-group
                              [--allow-crash-dumps-collection {Disabled, Enabled}]
                              [--application-update {No3rdPartyAppUpdates, UpdateAll}]
                              [--os-feed {Retail, RetailEval}]
                              [--regional-data-boundary {EU, None}]

Exemples

Créez un groupe d’appareils « MyDeviceGroup » dans le groupe de ressources « MyResourceGroup », catalogue « MyCatalog », produit « MyProduct », description « MyDescription » et limite de données régionales par défaut.

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --name MyDeviceGroup --description MyDescription

Créez un groupe d’appareils « MyDeviceGroup » dans le groupe de ressources « MyResourceGroup », catalogue « MyCatalog », produit « MyProduct », description « MyDescription » et spécifiez une limite de données régionale.

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --name MyDeviceGroup --description MyDescription --regional-data-boundary EU

Paramètres obligatoires

--catalog -c

Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.

--description -d

Description du groupe d’appareils.

--name -n

Nom alphanumérique du groupe d’appareils.

--product -p

Nom du produit.

Propriété Valeur
Valeur de: az sphere product list
--resource-group -g

Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--allow-crash-dumps-collection -cd

Fournissez le consentement pour la collecte de vidages sur incident par Microsoft pour ce groupe d’appareils. Pour plus d’informations, consultez https://aka.ms/AzureSphereCrashDumpsCollection.

Propriété Valeur
Valeur par défaut: Disabled
Valeurs acceptées: Disabled, Enabled
--application-update -a

Stratégie de mise à jour d’application pour ce groupe d’appareils.

Propriété Valeur
Valeur par défaut: UpdateAll
Valeurs acceptées: No3rdPartyAppUpdates, UpdateAll
--os-feed -f

Type de flux de système d’exploitation à utiliser pour les mises à jour du système d’exploitation.

Propriété Valeur
Valeur par défaut: Retail
Valeurs acceptées: Retail, RetailEval
--regional-data-boundary -r

Limite de données régionales pour ce groupe d’appareils.

Propriété Valeur
Valeur par défaut: None
Valeurs acceptées: EU, None
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sphere device-group create-defaults

Créez des groupes d’appareils par défaut ciblant un produit.

az sphere device-group create-defaults --catalog
                                       --product
                                       --resource-group

Exemples

Créez des groupes d’appareils par défaut dans le groupe de ressources « MyResourceGroup », le catalogue « MyCatalog » et le produit « MyProduct ».

az sphere device-group create-defaults --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

Paramètres obligatoires

--catalog -c

Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.

--product -p

Nom du produit.

Propriété Valeur
Valeur de: az sphere product list
--resource-group -g

Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sphere device-group delete

Supprimez le groupe d’appareils spécifié.

az sphere device-group delete --catalog
                              --device-group
                              --product
                              --resource-group

Exemples

Supprimez un groupe d’appareils à l’aide du groupe de ressources, du nom du catalogue, du nom du produit et du nom du groupe d’appareils.

az sphere device-group delete --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

Paramètres obligatoires

--catalog -c

Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.

--device-group -dg

Nom du groupe d’appareils.

Propriété Valeur
Valeur de: az sphere device-group list
--product -p

Produit pour lequel supprimer les groupes d’appareils.

Propriété Valeur
Valeur de: az sphere product list
--resource-group -g

Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sphere device-group list

Répertorier tous les groupes d’appareils dans un catalogue.

az sphere device-group list --catalog
                            --resource-group
                            [--device-group]
                            [--product]

Exemples

Répertorier tous les groupes d’appareils dans un groupe de ressources et un catalogue.

az sphere device-group list --resource-group MyResourceGroup --catalog MyCatalog

Répertorie tous les groupes d’appareils portant le nom spécifié dans un groupe de ressources et un catalogue.

az sphere device-group list --resource-group MyResourceGroup --catalog MyCatalog --device-group Development

Répertoriez tous les groupes d’appareils dans un groupe de ressources, un catalogue et un produit.

az sphere device-group list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

Paramètres obligatoires

--catalog -c

Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.

--resource-group -g

Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--device-group -dg

Répertorie tous les groupes d’appareils qui ont un nom spécifié.

--product -p

Répertorier tous les groupes d’appareils dans un produit.

Propriété Valeur
Valeur de: az sphere product list
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sphere device-group show

Afficher les détails d’un groupe d’appareils.

az sphere device-group show --catalog
                            --device-group
                            --product
                            --resource-group

Exemples

Afficher les détails d’un groupe d’appareils à l’aide du groupe de ressources, du nom du catalogue, du nom du produit et du nom du groupe d’appareils.

az sphere device-group show --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

Paramètres obligatoires

--catalog -c

Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.

--device-group -dg

Groupe d’appareils à afficher.

Propriété Valeur
Valeur de: az sphere device-group list
--product -p

Nom du produit pour lequel afficher le groupe d’appareils.

Propriété Valeur
Valeur de: az sphere product list
--resource-group -g

Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sphere device-group update

Mettez à jour les détails d’un groupe d’appareils.

az sphere device-group update --catalog
                              --device-group
                              --product
                              --resource-group
                              [--allow-crash-dumps-collection {Disabled, Enabled}]
                              [--application-update {No3rdPartyAppUpdates, UpdateAll}]
                              [--description]
                              [--os-feed {Retail, RetailEval}]
                              [--regional-data-boundary {EU, None}]

Exemples

Mettez à jour les propriétés d’un groupe d’appareils.

az sphere device-group update --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --description NewDescription

Paramètres obligatoires

--catalog -c

Catalogue Azure Sphere dans lequel effectuer cette opération. Spécifiez le nom du catalogue Azure Sphere. Vous pouvez configurer le catalogue Azure Sphere par défaut à l’aide de az config set defaults.sphere.catalog=<name>. Valeurs de : az sphere catalog list.

--device-group -dg

Nom du groupe d’appareils.

Propriété Valeur
Valeur de: az sphere device-group list
--product -p

Nom du produit.

Propriété Valeur
Valeur de: az sphere product list
--resource-group -g

Nom du groupe de ressources Azure. Vous pouvez configurer le groupe par défaut à l’aide de az config set defaults.group=<name>. Valeurs de : az group list.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--allow-crash-dumps-collection -cd

Fournissez le consentement pour la collecte de vidages sur incident par Microsoft pour ce groupe d’appareils. Pour plus d’informations, consultez https://aka.ms/AzureSphereCrashDumpsCollection.

Propriété Valeur
Valeurs acceptées: Disabled, Enabled
--application-update -a

Stratégie de mise à jour d’application pour ce groupe d’appareils.

Propriété Valeur
Valeurs acceptées: No3rdPartyAppUpdates, UpdateAll
--description -d

Nouvelle description du groupe d’appareils.

--os-feed -f

Type de flux de système d’exploitation à utiliser pour les mises à jour du système d’exploitation.

Propriété Valeur
Valeurs acceptées: Retail, RetailEval
--regional-data-boundary -r

Limite de données régionales pour ce groupe d’appareils.

Propriété Valeur
Valeurs acceptées: EU, None
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False