Partager via

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.

 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

Exporte 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 simulation de déploiement dans l’étendue de l’abonnement.

 Core 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

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

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

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

Modifier

Exporte 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

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

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

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

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

Modifier

Exécutez une opération de simulation de 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 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 simulation de déploiement sur un abonnement.

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

Exécutez une opération What-If de déploiement 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 une opération What-If de déploiement 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 simulation de 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.