az deployment sub

Référence

Gérer le déploiement de modèles Azure Resource Manager dans l’étendue de l’abonnement.

Commandes

Nom	Description	Type	État
az deployment sub cancel	Annulez un déploiement dans l’étendue de l’abonnement.	Noyau	GA
az deployment sub create	Démarrez un déploiement dans l’étendue de l’abonnement.	Noyau	GA
az deployment sub delete	Supprimez un déploiement dans l’étendue de l’abonnement.	Noyau	GA
az deployment sub export	Exportez le modèle utilisé pour un déploiement.	Noyau	GA
az deployment sub list	Répertorier les déploiements dans l’étendue de l’abonnement.	Noyau	GA
az deployment sub show	Afficher un déploiement dans l’étendue de l’abonnement.	Noyau	GA
az deployment sub validate	Vérifiez si un modèle est valide dans l’étendue de l’abonnement.	Noyau	GA
az deployment sub wait	Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de déploiement soit remplie.	Noyau	GA
az deployment sub what-if	Exécutez une opération de déploiement What-If dans l’étendue de l’abonnement.	Noyau	GA

az deployment sub cancel

Modifier

Annulez un déploiement dans l’étendue de l’abonnement.

az deployment sub cancel --name

Exemples

Annulez un déploiement dans l’étendue de l’abonnement.

az deployment sub cancel -n deployment01

Paramètres obligatoires

--name -n

Nom du déploiement.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs 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ê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.

az deployment sub create

Modifier

Démarrez un déploiement dans l’étendue de l’abonnement.

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

az deployment sub create --location
                         [--confirm-with-what-if]
                         [--handle-extended-json-format]
                         [--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 de l’étendue de l’abonnement à partir d’un fichier de modèle distant, à l’aide de paramètres à partir d’un fichier JSON local.

az deployment sub create --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az deployment sub create --location WestUS --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Créez un déploiement au niveau de l’étendue de l’abonnement à 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 de paires clé/valeur.

az deployment sub create --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.

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.

--name -n

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.

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 syntaxe @{path}, 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 modification des ressources à 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 lorsque --confirm-with-what-if est défini.

Valeurs acceptées: FullResourcePayloads, ResourceIdOnly

Valeur par défaut: FullResourcePayloads

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs 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ê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.

az deployment sub delete

Modifier

Supprimez un déploiement dans l’étendue de l’abonnement.

az deployment sub delete --name
                         [--no-wait]

Exemples

Supprimez un déploiement dans l’étendue de l’abonnement.

az deployment sub delete -n deployment01

Paramètres obligatoires

--name -n

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 la verbosité de la journalisation pour afficher tous les logs 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ê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.

az deployment sub export

Modifier

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

az deployment sub export --name

Exemples

Exportez le modèle utilisé pour un déploiement dans l’étendue de l’abonnement.

az deployment sub export --name MyDeployment

Paramètres obligatoires

--name -n

Nom du déploiement.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs 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ê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.

az deployment sub list

Modifier

Répertorier les déploiements dans l’étendue de l’abonnement.

az deployment sub list [--filter]

Exemples

Répertorier les déploiements dans l’étendue de l’abonnement.

az deployment sub list

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, visitez https://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs 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ê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.

az deployment sub show

Modifier

Afficher un déploiement dans l’étendue de l’abonnement.

az deployment sub show --name

Exemples

Afficher un déploiement dans l’étendue de l’abonnement.

az deployment sub show -n deployment01

Paramètres obligatoires

--name -n

Nom du déploiement.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs 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ê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.

az deployment sub validate

Modifier

Vérifiez si un modèle est valide dans l’étendue de l’abonnement.

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

az deployment sub validate --location
                           [--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 dans l’étendue de l’abonnement.

az deployment sub validate --location westus2 --template-file {template-file}

Vérifiez si un modèle est valide dans l’étendue de l’abonnement. (généré automatiquement)

az deployment sub validate --location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json

Paramètres obligatoires

--location -l

Emplacement où stocker les métadonnées de 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

Nom du déploiement.

--no-prompt

Valeurs acceptées: false, true

Valeur par défaut: False

--parameters -p

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

--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 la verbosité de la journalisation pour afficher tous les logs 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ê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.

az deployment sub wait

Modifier

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

az deployment sub wait --name
                       [--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 deployment sub wait --created --name MyDeployment

Paramètres obligatoires

--name -n

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 la verbosité de la journalisation pour afficher tous les logs 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ê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.

az deployment sub what-if

Modifier

Exécutez une opération de déploiement What-If dans l’étendue de l’abonnement.

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

az deployment sub what-if --location
                          [--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 déploiement What-If sur un abonnement.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Exécutez un déploiement What-If opération sur un abonnement sans imprimer le résultat.

az deployment sub what-if --location WestUS --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 l’opération de déploiement What-If.

Paramètres facultatifs

--exclude-change-types -x

Liste séparée par l’espace des types de modification des ressources à exclure des résultats What-If.

Valeurs acceptées: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported

--name -n

Nom du déploiement.

--no-pretty-print

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

--no-prompt

Valeurs acceptées: false, true

Valeur par défaut: False

--parameters -p

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

--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 la verbosité de la journalisation pour afficher tous les logs 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ê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.

Partager via

az deployment sub

Commandes

az deployment sub cancel

Exemples

Paramètres obligatoires

az deployment sub create

Exemples

Paramètres obligatoires

Paramètres facultatifs

az deployment sub delete

Exemples

Paramètres obligatoires

Paramètres facultatifs

az deployment sub export

Exemples

Paramètres obligatoires

az deployment sub list

Exemples

Paramètres facultatifs

az deployment sub show

Exemples

Paramètres obligatoires

az deployment sub validate

Exemples

Paramètres obligatoires

Paramètres facultatifs

az deployment sub wait

Exemples

Paramètres obligatoires

Paramètres facultatifs

az deployment sub what-if

Exemples

Paramètres obligatoires

Paramètres facultatifs