Partager via


az deployment sub

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.

Core GA
az deployment sub create

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

Core GA
az deployment sub delete

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

Core GA
az deployment sub export

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

Core GA
az deployment sub list

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

Core GA
az deployment sub show

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

Core GA
az deployment sub validate

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

Core GA
az deployment sub wait

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

Core GA
az deployment sub what-if

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

Core GA

az deployment sub cancel

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.

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

Output format.

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Propriété Valeur
Valeur par défaut: False
Valeurs acceptées: false, true
--no-wait

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

Propriété Valeur
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.

Propriété Valeur
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.

Propriété Valeur
Valeur par défaut: FullResourcePayloads
Valeurs acceptées: FullResourcePayloads, ResourceIdOnly
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

Output format.

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

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

Propriété Valeur
Valeur par défaut: False
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

Output format.

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

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.

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

Output format.

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

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

Output format.

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

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.

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

Output format.

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

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. (autogenerated)

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Propriété Valeur
Valeur par défaut: False
Valeurs acceptées: false, true
--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.

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

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

Output format.

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

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. (autogenerated)

az deployment sub wait --created --name MyDeployment

Paramètres obligatoires

--name -n

Nom du déploiement.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

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

Propriété Valeur
Parameter group: Wait Condition Arguments
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'].

Propriété Valeur
Parameter group: Wait Condition Arguments
--deleted

Attendez la suppression.

Propriété Valeur
Parameter group: Wait Condition Arguments
Valeur par défaut: False
--exists

Attendez que la ressource existe.

Propriété Valeur
Parameter group: Wait Condition Arguments
Valeur par défaut: False
--interval

Intervalle d’interrogation en secondes.

Propriété Valeur
Parameter group: Wait Condition Arguments
Valeur par défaut: 30
--timeout

Délai maximal d’attente en secondes.

Propriété Valeur
Parameter group: Wait Condition Arguments
Valeur par défaut: 3600
--updated

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

Propriété Valeur
Parameter group: Wait Condition Arguments
Valeur par défaut: False
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

Output format.

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 deployment sub what-if

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--exclude-change-types -x

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

Propriété Valeur
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

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.

Propriété Valeur
Valeur par défaut: False
Valeurs acceptées: false, true
--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.

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

Propriété Valeur
Valeur par défaut: FullResourcePayloads
Valeurs acceptées: FullResourcePayloads, ResourceIdOnly
--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.

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

Output format.

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