az deployment mg

  • Référence

Gérer le déploiement de modèles Azure Resource Manager au niveau du groupe d’administration.

Commandes

Nom Description Type Statut
az deployment mg cancel

Annulez un déploiement au niveau du groupe d’administration.

 Core GA
az deployment mg create

Démarrez un déploiement au niveau du groupe d’administration.

 Core GA
az deployment mg delete

Supprimez un déploiement au niveau du groupe d’administration.

 Core GA
az deployment mg export

Exporte le modèle utilisé pour un déploiement.

 Core GA
az deployment mg list

Répertorier les déploiements au niveau du groupe d’administration.

 Core GA
az deployment mg show

Afficher un déploiement au niveau du groupe d’administration.

 Core GA
az deployment mg validate

Vérifiez si un modèle est valide au niveau du groupe d’administration.

 Core GA
az deployment mg wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de déploiement soit remplie.

 Core GA
az deployment mg what-if

Exécutez une opération de déploiement dans l’étendue du groupe d’administration.

 Core GA

az deployment mg cancel

Modifier

Annulez un déploiement au niveau du groupe d’administration.

az deployment mg cancel --management-group-id
                        --name

Exemples

Annulez un déploiement au niveau du groupe d’administration.

az deployment mg cancel -m testmg -n deployment01

Paramètres obligatoires

--management-group-id -m

ID du groupe d’administration.

--name -n

Le nom du déploiement.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az deployment mg create

Modifier

Démarrez un déploiement au niveau du groupe d’administration.

Spécifiez un seul fichier --template-file | --template-uri URI | --template-spec pour entrer le modèle ARM.

az deployment mg create --location
                        --management-group-id
                        [--confirm-with-what-if]
                        [--handle-extended-json-format]
                        [--mode {Complete, Incremental}]
                        [--name]
                        [--no-prompt {false, true}]
                        [--no-wait]
                        [--parameters]
                        [--proceed-if-no-change]
                        [--query-string]
                        [--template-file]
                        [--template-spec]
                        [--template-uri]
                        [--what-if]
                        [--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                        [--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]

Exemples

Créez un déploiement au niveau du groupe d’administration à partir d’un fichier de modèle distant, à l’aide de paramètres à partir d’un fichier JSON local.

az deployment mg create --management-group-id testrg --name rollout01 --location WestUS \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Créez un déploiement au niveau du groupe d’administration à partir d’un fichier de modèle local, à l’aide de paramètres à partir d’une chaîne JSON.

az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
    --template-file azuredeploy.json \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Créez un déploiement au niveau du groupe d’administration à partir d’un modèle local, à l’aide d’un fichier de paramètres, d’un fichier de paramètres distant et de substitution sélective des paires clé/valeur.

az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
    --template-file azuredeploy.json --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Paramètres obligatoires

--location -l

Emplacement où stocker les métadonnées de déploiement.

--management-group-id -m

ID du groupe d’administration auquel créer le déploiement.

Paramètres facultatifs

--confirm-with-what-if -c

Indiquez à la commande d’exécuter le déploiement What-If avant d’exécuter le déploiement. Il vous invite ensuite à accuser réception des modifications des ressources avant de continuer.

--handle-extended-json-format -j
Déprécié

L’option '--handle-extended-json-format/-j’a été déconseillée et sera supprimée dans une prochaine version.

Prise en charge de la gestion du contenu de modèle étendu, y compris le multiligne et les commentaires dans le déploiement.

--mode

Mode utilisé pour déployer des ressources. Cette valeur peut être incrémentielle ou terminée. En mode incrémentiel, les ressources sont déployées sans supprimer les ressources existantes qui ne sont pas incluses dans le modèle. En mode Complet, les ressources sont déployées et les ressources existantes dans le groupe de ressources qui ne sont pas incluses dans le modèle sont supprimées. Veillez à utiliser le mode Complet, car vous pouvez supprimer involontairement des ressources.

valeurs acceptées: Complete, Incremental
valeur par défaut: Incremental
--name -n

Le nom du déploiement.

--no-prompt

Option permettant de désactiver l’invite de paramètres manquants pour le modèle ARM. Lorsque la valeur est true, l’invite demandant aux utilisateurs de fournir un paramètre manquant est ignorée. La valeur par défaut est false (Faux).

valeurs acceptées: false, true
valeur par défaut: False
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--parameters -p

Fournissez les valeurs des paramètres de déploiement.

Les paramètres peuvent être fournis à partir d’un fichier à l’aide de la @{path} syntaxe, d’une chaîne JSON ou de <paires KEY=VALUE> . Les paramètres sont évalués dans l’ordre. Par conséquent, lorsqu’une valeur est affectée deux fois, la dernière valeur sera utilisée. Il est recommandé de fournir d’abord votre fichier de paramètres, puis de remplacer de manière sélective à l’aide de la syntaxe KEY=VALUE.

--proceed-if-no-change

Indiquez à la commande d’exécuter le déploiement si le résultat What-If ne contient aucune modification des ressources. Applicable lorsque --confirm-with-what-if est défini.

--query-string -q

Chaîne de requête (jeton SAP) à utiliser avec l’URI de modèle dans le cas de modèles liés.

--template-file -f

Chemin d’accès au fichier de modèle ou au fichier Bicep.

--template-spec -s

ID de ressource de spécification du modèle.

--template-uri -u

URI du fichier de modèle.

--what-if -w

Indiquez à la commande d’exécuter le déploiement What-If.

--what-if-exclude-change-types -x

Liste séparée par l’espace des types de modifications de ressource à exclure des résultats what-If. Applicable lorsque --confirm-with-what-if est défini.

valeurs acceptées: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

Format des résultats what-if. Applicable quand --confirm-with-what-if est défini.

valeurs acceptées: FullResourcePayloads, ResourceIdOnly
valeur par défaut: FullResourcePayloads
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az deployment mg delete

Modifier

Supprimez un déploiement au niveau du groupe d’administration.

az deployment mg delete --management-group-id
                        --name
                        [--no-wait]

Exemples

Supprimez un déploiement au niveau du groupe d’administration.

az deployment mg delete -m testmg -n deployment01

Paramètres obligatoires

--management-group-id -m

ID du groupe d’administration.

--name -n

Le nom du déploiement.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az deployment mg export

Modifier

Exporte le modèle utilisé pour un déploiement.

az deployment mg export --management-group-id
                        --name

Exemples

Exportez le modèle utilisé pour un déploiement au niveau du groupe d’administration.

az deployment mg export --management-group-id testmg --name MyDeployment

Paramètres obligatoires

--management-group-id -m

ID du groupe d’administration.

--name -n

Le nom du déploiement.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az deployment mg list

Modifier

Répertorier les déploiements au niveau du groupe d’administration.

az deployment mg list --management-group-id
                      [--filter]

Exemples

Répertorier les déploiements au niveau du groupe d’administration.

az deployment mg list -m testmg

Paramètres obligatoires

--management-group-id -m

ID du groupe d’administration.

Paramètres facultatifs

--filter
Préversion

Expression de filtre à l’aide de la notation OData. Vous pouvez utiliser --filter « provisioningState eq ' {state} » pour filtrer provisioningState. Pour obtenir plus d’informations, veuillez consulter https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az deployment mg show

Modifier

Afficher un déploiement au niveau du groupe d’administration.

az deployment mg show --management-group-id
                      --name

Exemples

Afficher un déploiement au niveau du groupe d’administration.

az deployment mg show -m testmg -n deployment01

Paramètres obligatoires

--management-group-id -m

ID du groupe d’administration.

--name -n

Le nom du déploiement.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az deployment mg validate

Modifier

Vérifiez si un modèle est valide au niveau du groupe d’administration.

Spécifiez un seul fichier --template-file | --template-uri URI | --template-spec pour entrer le modèle ARM.

az deployment mg validate --location
                          --management-group-id
                          [--handle-extended-json-format]
                          [--name]
                          [--no-prompt {false, true}]
                          [--parameters]
                          [--query-string]
                          [--template-file]
                          [--template-spec]
                          [--template-uri]

Exemples

Vérifiez si un modèle est valide au niveau du groupe d’administration.

az deployment mg validate --management-group-id testmg --location WestUS --template-file {template-file}

Vérifiez si un modèle est valide au niveau du groupe d’administration. (généré automatiquement)

az deployment mg validate --location WestUS --management-group-id testmg --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json

Paramètres obligatoires

--location -l

Emplacement où stocker les métadonnées de déploiement.

--management-group-id -m

ID du groupe d’administration auquel créer le déploiement.

Paramètres facultatifs

--handle-extended-json-format -j
Déprécié

L’option '--handle-extended-json-format/-j’a été déconseillée et sera supprimée dans une prochaine version.

Prise en charge de la gestion du contenu de modèle étendu, y compris le multiligne et les commentaires dans le déploiement.

--name -n

Le nom du déploiement.

--no-prompt

Option permettant de désactiver l’invite de paramètres manquants pour le modèle ARM. Lorsque la valeur est true, l’invite demandant aux utilisateurs de fournir un paramètre manquant est ignorée. La valeur par défaut est false (Faux).

valeurs acceptées: false, true
valeur par défaut: False
--parameters -p

Fournissez les valeurs des paramètres de déploiement.

Les paramètres peuvent être fournis à partir d’un fichier à l’aide de la @{path} syntaxe, d’une chaîne JSON ou de <paires KEY=VALUE> . Les paramètres sont évalués dans l’ordre. Par conséquent, lorsqu’une valeur est affectée deux fois, la dernière valeur sera utilisée. Il est recommandé de fournir d’abord votre fichier de paramètres, puis de remplacer de manière sélective à l’aide de la syntaxe KEY=VALUE.

--query-string -q

Chaîne de requête (jeton SAP) à utiliser avec l’URI de modèle dans le cas de modèles liés.

--template-file -f

Chemin d’accès au fichier de modèle ou au fichier Bicep.

--template-spec -s

ID de ressource de spécification du modèle.

--template-uri -u

URI du fichier de modèle.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az deployment mg wait

Modifier

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de déploiement soit remplie.

az deployment mg wait --management-group-id
                      --name
                      [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--interval]
                      [--timeout]
                      [--updated]

Paramètres obligatoires

--management-group-id -m

ID du groupe d’administration.

--name -n

Le nom du déploiement.

Paramètres facultatifs

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendez la suppression.

valeur par défaut: False
--exists

Attendez que la ressource existe.

valeur par défaut: False
--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30
--timeout

Délai maximal d’attente en secondes.

valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az deployment mg what-if

Modifier

Exécutez une opération de déploiement dans l’étendue du groupe d’administration.

Spécifiez un seul fichier --template-file | --template-uri URI | --template-spec pour entrer le modèle ARM.

az deployment mg what-if --location
                         --management-group-id
                         [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                         [--name]
                         [--no-pretty-print]
                         [--no-prompt {false, true}]
                         [--parameters]
                         [--query-string]
                         [--result-format {FullResourcePayloads, ResourceIdOnly}]
                         [--template-file]
                         [--template-spec]
                         [--template-uri]

Exemples

Exécutez une opération de simulation de déploiement sur un groupe d’administration.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Exécutez une opération What-If de déploiement dans un groupe d’administration au format ResourceIdOnly.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Exécutez une opération de simulation de déploiement sur un groupe d’administration sans imprimer le résultat.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Paramètres obligatoires

--location -l

Emplacement où stocker les métadonnées de déploiement.

--management-group-id -m

ID du groupe d’administration auquel créer le déploiement.

Paramètres facultatifs

--exclude-change-types -x

Liste séparée par l’espace des types de modifications de ressource à exclure des résultats what-If.

valeurs acceptées: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--name -n

Le nom du déploiement.

--no-pretty-print

Désactivez pretty-print pour les résultats What-If. Lorsqu’il est défini, le type de format de sortie est utilisé.

--no-prompt

Option permettant de désactiver l’invite de paramètres manquants pour le modèle ARM. Lorsque la valeur est true, l’invite demandant aux utilisateurs de fournir un paramètre manquant est ignorée. La valeur par défaut est false (Faux).

valeurs acceptées: false, true
valeur par défaut: False
--parameters -p

Fournissez les valeurs des paramètres de déploiement.

Les paramètres peuvent être fournis à partir d’un fichier à l’aide de la @{path} syntaxe, d’une chaîne JSON ou de <paires KEY=VALUE> . Les paramètres sont évalués dans l’ordre. Par conséquent, lorsqu’une valeur est affectée deux fois, la dernière valeur sera utilisée. Il est recommandé de fournir d’abord votre fichier de paramètres, puis de remplacer de manière sélective à l’aide de la syntaxe KEY=VALUE.

--query-string -q

Chaîne de requête (jeton SAP) à utiliser avec l’URI de modèle dans le cas de modèles liés.

--result-format -r

Format des résultats what-if.

valeurs acceptées: FullResourcePayloads, ResourceIdOnly
valeur par défaut: FullResourcePayloads
--template-file -f

Chemin d’accès au fichier de modèle ou au fichier Bicep.

--template-spec -s

ID de ressource de spécification du modèle.

--template-uri -u

URI du fichier de modèle.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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