az account management-group create |
Azure : Crée le groupe de gestion du compte |
|---|---|
| Azure CLI | |
Syntaxe
| az account management-group create --name [--display-name] [--parent] |
Paramètres
| Nom | Description |
|---|---|
| --debug | Ce paramètre permet d'augmenter la verbosité de la journalisation pour afficher tous les journaux de débogage. |
| --display-name | Ce paramètre permet de définir le nom d'affichage convivial qui apparaîtra pour le groupe de gestion dans le portail Azure et d'autres interfaces. Si non spécifié, il sera identique au --name. |
| -h | Ce paramètre permet d'afficher le message d'aide pour cette commande et de quitter. |
| --help | Ce paramètre permet d'afficher le message d'aide pour cette commande et de quitter. |
| --name | Ce paramètre permet de spécifier le nom unique (ID) du nouveau groupe de gestion que vous souhaitez créer. |
| -o | Ce paramètre permet de définir le format de sortie des résultats. Les valeurs acceptées incluent json, jsonc, none, table, tsv, yaml, et yamlc. Le format par défaut est json. |
| --only-show-errors | Ce paramètre permet d'afficher uniquement les messages d'erreur, en supprimant les avertissements pour une sortie plus concise. |
| --output | Ce paramètre permet de définir le format de sortie des résultats. Les valeurs acceptées incluent json, jsonc, none, table, tsv, yaml, et yamlc. Le format par défaut est json. |
| --parent | Ce paramètre permet de spécifier l'ID du groupe de gestion parent auquel le nouveau groupe de gestion sera rattaché, organisant ainsi la hiérarchie de vos groupes de gestion. |
| --query | Ce paramètre permet de spécifier une chaîne de requête JMESPath pour personnaliser la sortie de la commande. Vous pouvez trouver plus d'informations et d'exemples sur http://jmespath.org/. |
| --subscription | Ce paramètre permet de spécifier le nom ou l'ID de l'abonnement Azure sur lequel opérer. Vous pouvez configurer l'abonnement par défaut en utilisant az account set -s NAME_OR_ID. |
| --verbose | Ce paramètre permet d'augmenter le niveau de verbosité de la journalisation. Pour des journaux de débogage complets, utilisez --debug. |
Description
Cette commande permet de créer un nouveau groupe de gestion.
Remarques
- Création d'une hiérarchie organisationnelle personnalisée : La commande permet d'établir une structure de gouvernance claire en créant un groupe de gestion pouvant ensuite contenir d'autres groupes ou abonnements. Cela facilite le contrôle d'accès, l'application de politiques, et la gestion des coûts à grande échelle.
- Le paramètre --name définit l'identifiant technique unique : Le champ --name est obligatoire et représente l'identifiant du groupe dans les scripts et API. Il doit être unique au sein du tenant Azure, et ne peut pas contenir d'espaces ni de caractères spéciaux, car il sert d'ID dans les appels programmatiques.
- Nom d'affichage distinct via --display-name : Bien que --name soit technique, --display-name permet de donner un nom lisible, utile dans le portail Azure. Cela améliore l'expérience utilisateur pour les administrateurs, car un nom clair permet de comprendre immédiatement la fonction du groupe.
- Hiérarchisation facilitée avec le paramètre --parent : Grâce à --parent, on peut rattacher directement le nouveau groupe à un groupe existant. Cela permet de construire une arborescence logique, reflétant par exemple la structure d'une entreprise (exemple : société > département > projet).
- Souplesse de format avec --output pour intégration dans des scripts : La possibilité de choisir le format de sortie (comme json, yaml, table,...) permet d'adapter la commande selon le contexte : automatisation via script, affichage dans un terminal, ou intégration avec d'autres outils comme PowerShell ou Bash.
- Affichage allégé grâce à --only-show-errors : Le paramètre --only-show-errors est utile dans les pipelines CI/CD ou scripts automatisés, car il supprime les messages d'avertissement. On obtient ainsi une sortie plus propre et ciblée, centrée uniquement sur les erreurs à corriger.
- Support du débogage et de la verbosité pour un diagnostic avancé : En cas d'erreur ou de comportement inattendu, les options --debug et --verbose permettent d'examiner les échanges sous-jacents avec les API Azure. Cela est crucial lors du développement ou du déploiement dans des environnements complexes.
- Commandes compatibles avec des requêtes JMESPath via --query : On peut affiner les résultats de sortie grâce à des expressions --query JMESPath, ce qui est très utile pour extraire ou reformater des champs spécifiques dans les résultats JSON. Cela renforce l'automatisation et la lisibilité des rapports CLI.
Dernière mise à jour : Dimanche, le 4 Avril 2021