Partager via

az group deployment

  • Déprécié
  • Référence

Ce groupe de commandes a été déconseillé et sera supprimé dans une prochaine version. Utilisez plutôt « groupe de déploiement ».

Gérer les déploiements Azure Resource Manager.

Commandes

Nom Description Type État
az group deployment cancel

Annule un déploiement de modèle en cours d’exécution.

 Core Déprécié
az group deployment create

Démarre un déploiement.

 Core Déprécié
az group deployment delete

Supprime un déploiement de l’historique de déploiement.

 Core Déprécié
az group deployment export

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

 Core Déprécié
az group deployment list

Répertorie tous les déploiements d’un groupe de ressources.

 Core Déprécié
az group deployment operation

Gérer les opérations de déploiement.

 Core Déprécié
az group deployment operation list

Obtient toutes les opérations de déploiement pour un déploiement.

 Core Déprécié
az group deployment operation show

Obtenir l’opération d’un déploiement.

 Core Déprécié
az group deployment show

Obtient un déploiement.

 Core Déprécié
az group deployment validate

Vérifiez si un modèle est correctement synchronisé.

 Core Déprécié
az group deployment wait

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

 Core Déprécié

az group deployment cancel

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « déploiement de groupe » est déconseillé et sera supprimé dans une prochaine version. Utilisez plutôt « groupe de déploiement ».

Annule un déploiement de modèle en cours d’exécution.

Vous pouvez annuler un déploiement uniquement si provisioningState est accepté ou en cours d’exécution. Une fois le déploiement annulé, l’état d’approvisionnement est défini sur Canceled. L’annulation d’un déploiement de modèle arrête le déploiement de modèle en cours d’exécution et laisse le groupe de ressources partiellement déployé.

az group deployment cancel --name
                           --resource-group

Paramètres obligatoires

--name -n

Le nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

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 group deployment create

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « déploiement de groupe » est déconseillé et sera supprimé dans une prochaine version. Utilisez plutôt « groupe de déploiement ».

Démarre un déploiement.

az group deployment create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-uri]

Exemples

Créez un déploiement à partir d’un fichier de modèle distant à l’aide de paramètres à partir d’un fichier JSON local.

az group deployment create -g MyResourceGroup --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters "{ \"location\": { \"value\": \"westus\" } }"

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

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--aux-subs
Déprécié

L’option « --aux-subs » a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « --aux-tenants ».

Abonnements auxiliaires qui seront utilisés pendant le déploiement entre les locataires.

--aux-tenants

Locataires auxiliaires qui seront utilisés pendant le déploiement entre les locataires.

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

Incrémentiel (ajouter uniquement des ressources au groupe de ressources) ou Terminer (supprimer des ressources supplémentaires du groupe de ressources).

Valeurs acceptées: Complete, Incremental
Valeur par défaut: Incremental
--name -n

Le nom du déploiement. Valeur par défaut pour le nom de base du fichier de modèle.

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

--rollback-on-error

Nom d’un déploiement à restaurer en cas d’erreur ou utiliser comme indicateur pour revenir au dernier déploiement réussi.

--template-file -f

Chemin d’accès à un fichier de modèle ou un fichier Bicep dans le système de fichiers.

--template-uri -u

Uri d’un fichier de modèle distant.

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 group deployment delete

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « déploiement de groupe » est déconseillé et sera supprimé dans une prochaine version. Utilisez plutôt « groupe de déploiement ».

Supprime un déploiement de l’historique de déploiement.

Impossible de supprimer un déploiement de modèle en cours d’exécution. La suppression d’un déploiement de modèle supprime les opérations de déploiement associées. La suppression d’un déploiement de modèle n’affecte pas l’état du groupe de ressources. Il s’agit d’une opération asynchrone qui retourne un état 202 jusqu’à ce que le déploiement du modèle soit correctement supprimé. L’en-tête de réponse Location contient l’URI utilisé pour obtenir l’état du processus. Pendant l’exécution du processus, un appel à l’URI dans l’en-tête Location retourne l’état 202. Une fois le processus terminé, l’URI dans l’en-tête Emplacement retourne l’état 204 en cas de réussite. Si la requête asynchrone a échoué, l’URI dans l’en-tête Location retourne un code d’état au niveau de l’erreur.

az group deployment delete --name
                           --resource-group
                           [--no-wait]

Paramètres obligatoires

--name -n

Le nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

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 group deployment export

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « déploiement de groupe » est déconseillé et sera supprimé dans une prochaine version. Utilisez plutôt « groupe de déploiement ».

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

az group deployment export --name
                           --resource-group

Exemples

Exporte le modèle utilisé pour un déploiement. (généré automatiquement)

az group deployment export --name MyDeployment --resource-group MyResourceGroup

Paramètres obligatoires

--name -n

Le nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

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 group deployment list

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « déploiement de groupe » est déconseillé et sera supprimé dans une prochaine version. Utilisez plutôt « groupe de déploiement ».

Répertorie tous les déploiements d’un groupe de ressources.

az group deployment list --resource-group
                         [--filter]
                         [--top]

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--filter

Filtre à appliquer à l'opération. Par exemple, vous pouvez utiliser $filter=provisioningState eq '{state}'. La valeur par défaut est None.

--top

Nombre de résultats à obtenir. Si la valeur null est passée, retourne tous les déploiements. La valeur par défaut est None.

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 group deployment show

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « déploiement de groupe » est déconseillé et sera supprimé dans une prochaine version. Utilisez plutôt « groupe de déploiement ».

Obtient un déploiement.

az group deployment show --name
                         --resource-group

Paramètres obligatoires

--name -n

Le nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

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 group deployment validate

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « déploiement de groupe » est déconseillé et sera supprimé dans une prochaine version. Utilisez plutôt « groupe de déploiement ».

Vérifiez si un modèle est correctement synchronisé.

az group deployment validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--rollback-on-error]
                             [--template-file]
                             [--template-uri]

Exemples

Vérifiez si un modèle est correctement synchronisé. (généré automatiquement)

az group deployment validate --parameters "{ \"location\": { \"value\": \"westus\" } }" \
    --resource-group MyResourceGroup --template-file storage.json

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

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.

--mode

Incrémentiel (ajouter uniquement des ressources au groupe de ressources) ou Terminer (supprimer des ressources supplémentaires du groupe de ressources).

Valeurs acceptées: Complete, Incremental
Valeur par défaut: Incremental
--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.

--rollback-on-error

Nom d’un déploiement à restaurer en cas d’erreur ou utiliser comme indicateur pour revenir au dernier déploiement réussi.

--template-file -f

Chemin d’accès à un fichier de modèle ou un fichier Bicep dans le système de fichiers.

--template-uri -u

Uri d’un fichier de modèle distant.

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 group deployment wait

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « déploiement de groupe » est déconseillé et sera supprimé dans une prochaine version. Utilisez plutôt « groupe de déploiement ».

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

az group deployment wait --name
                         --resource-group
                         [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--interval]
                         [--timeout]
                         [--updated]

Exemples

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de déploiement soit remplie. (généré automatiquement)

az group deployment wait --name MyDeployment --resource-group MyResourceGroup --updated

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de déploiement soit remplie. (généré automatiquement)

az group deployment wait --created --name MyDeployment --resource-group MyResourceGroup

Paramètres obligatoires

--name -n

Le nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

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.