Partager via

az stack sub

  • Référence

Gérer les piles de déploiement au niveau de l’abonnement.

Commandes

Nom Description Type Statut
az stack sub create

Créez ou mettez à jour une pile de déploiement dans l’étendue de l’abonnement.

 Core GA
az stack sub delete

Supprimez la pile de déploiement spécifiée de l’étendue de l’abonnement.

 Core GA
az stack sub export

Exportez le modèle utilisé pour créer la pile de déploiement.

 Core GA
az stack sub list

Répertorier toutes les piles de déploiement dans l’abonnement.

 Core GA
az stack sub show

Obtenir la pile de déploiement spécifiée à partir de l’étendue de l’abonnement.

 Core GA
az stack sub validate

Valider une pile de déploiement dans l’étendue de l’abonnement.

 Core GA

az stack sub create

Créez ou mettez à jour une pile de déploiement dans l’étendue de l’abonnement.

az stack sub create --action-on-unmanage {deleteAll, deleteResources, detachAll}
                    --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                    --location
                    --name
                    [--bse {false, true}]
                    [--cs]
                    [--deny-settings-excluded-actions]
                    [--deny-settings-excluded-principals]
                    [--deployment-resource-group]
                    [--description]
                    [--no-wait]
                    [--parameters]
                    [--query-string]
                    [--tags]
                    [--template-file]
                    [--template-spec]
                    [--template-uri]
                    [--yes]

Exemples

Créez une pile de déploiement à l’aide d’un fichier de modèle et détachez toutes les ressources sur unmanage.

az stack sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll

Créez une pile de déploiement avec un fichier de paramètres et supprimez des ressources sur unmanage.

az stack sub create --name StackName --action-on-unmanage deleteResources --template-file simpleTemplate.json --parameters simpleTemplateParams.json --location westus2 --description description --deny-settings-mode None

Créez une pile de déploiement avec des spécifications de modèle.

az stack sub create --name StackName --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources

Créez une pile de déploiement à l’aide du fichier bicep et supprimez toutes les ressources sur unmanage non managé.

az stack sub create --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

Créez une pile de déploiement à un autre abonnement.

az stack sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources

Créez une pile de déploiement et déployez au niveau de l’étendue du groupe de ressources.

az stack sub create --name StackName --template-file simpleTemplate.json --location westus --deployment-resource-group ResourceGroup --description description --deny-settings-mode None --action-on-unmanage deleteResources

Créez une pile de déploiement à l’aide de paramètres à partir de paires clé/valeur.

az stack sub create --name StackName --template-file simpleTemplate.json --location westus --description description --parameters simpleTemplateParams.json value1=foo value2=bar --deny-settings-mode None --action-on-unmanage deleteResources

Créez une pile de déploiement à 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 stack sub create --name StackName --template-file azuredeploy.json --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json --location westus --deny-settings-mode None --action-on-unmanage deleteResources

Créez une pile de déploiement à partir d’un modèle local à l’aide de paramètres de refus.

az stack sub create --name StackName --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-excluded-principals "test1 test2" --location westus --action-on-unmanage deleteResources

Créez une pile de déploiement à partir d’un modèle local, appliquez des paramètres de refus aux étendues enfants.

az stack sub create --name StackName --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-apply-to-child-scopes --location westus --action-on-unmanage deleteResources

Paramètres obligatoires

--action-on-unmanage --aou

Définit ce qui se passe pour les ressources qui ne sont plus gérées après la mise à jour ou la suppression de la pile.

valeurs acceptées: deleteAll, deleteResources, detachAll
--deny-settings-mode --dm

Définissez les opérations refusées sur les ressources gérées par la pile.

valeurs acceptées: denyDelete, denyWriteAndDelete, none
--location -l

Emplacement pour stocker la pile de déploiement.

--name -n

Nom de la pile de déploiement.

Paramètres facultatifs

--bse --bypass-stack-out-of-sync-error

Indicateur pour contourner les erreurs de service qui indiquent que la liste des ressources de pile n’est pas correctement synchronisée.

valeurs acceptées: false, true
valeur par défaut: False
--cs --deny-settings-apply-to-child-scopes

Refuser Paramètres sera appliqué aux étendues enfants.

valeur par défaut: False
--deny-settings-excluded-actions --ea

Liste des opérations de gestion basées sur les rôles qui sont exclues du refus Paramètres. Jusqu’à 200 actions sont autorisées.

--deny-settings-excluded-principals --ep

Liste des ID de principal AAD exclus du verrou. Jusqu’à 5 principaux sont autorisés.

--deployment-resource-group --dr

Étendue à laquelle le déploiement initial doit être créé. Si aucune étendue n’est spécifiée, elle est définie par défaut sur l’étendue de la pile de déploiement.

--description

Description de la pile de déploiement.

--no-wait

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

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

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.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--template-file -f

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

--template-spec -s

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

--template-uri -u

Uri d’un fichier de modèle distant.

--yes

Ne pas demander de confirmation.

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

Supprimez la pile de déploiement spécifiée de l’étendue de l’abonnement.

az stack sub delete --action-on-unmanage {deleteAll, deleteResources, detachAll}
                    [--bse {false, true}]
                    [--id]
                    [--name]
                    [--yes]

Exemples

Supprimez la pile par nom.

az stack sub delete --name StackName --action-on-unmanage deleteResources

Supprimez la pile par ID de ressource de pile.

az stack sub delete --id /subscriptions/111111111111/providers/Microsoft.Resources/deploymentStacks/StackName --action-on-unmanage detachAll

Paramètres obligatoires

--action-on-unmanage --aou

Définit ce qui se passe pour les ressources qui ne sont plus gérées après la mise à jour ou la suppression de la pile.

valeurs acceptées: deleteAll, deleteResources, detachAll

Paramètres facultatifs

--bse --bypass-stack-out-of-sync-error

Indicateur pour contourner les erreurs de service qui indiquent que la liste des ressources de pile n’est pas correctement synchronisée.

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

ID de ressource de la pile de déploiement.

--name -n

Nom de la pile de déploiement.

--yes

Ne pas demander de confirmation.

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

Exportez le modèle utilisé pour créer la pile de déploiement.

az stack sub export [--id]
                    [--name]

Exemples

Exportez le modèle par nom.

az stack sub export --name StackName

Exporter un modèle par ID de ressource de pile.

az stack sub export --id /subscriptions/111111111111/providers/Microsoft.Resources/deploymentStacks/StackName

Paramètres facultatifs

--id

ID de ressource de la pile de déploiement.

--name -n

Nom de la pile de 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 stack sub list

Répertorier toutes les piles de déploiement dans l’abonnement.

az stack sub list

Exemples

Répertorier toutes les piles

az stack sub list
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 stack sub show

Obtenir la pile de déploiement spécifiée à partir de l’étendue de l’abonnement.

az stack sub show [--id]
                  [--name]

Exemples

Obtenir la pile par nom.

az stack sub show --name StackName

Obtenir la pile par ID de ressource de pile.

az stack sub show --id /subscriptions/111111111111/providers/Microsoft.Resources/deploymentStacks/StackName

Paramètres facultatifs

--id

ID de ressource de la pile de déploiement.

--name -n

Nom de la pile de 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 stack sub validate

Valider une pile de déploiement dans l’étendue de l’abonnement.

az stack sub validate --action-on-unmanage {deleteAll, deleteResources, detachAll}
                      --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                      --location
                      --name
                      [--bse {false, true}]
                      [--cs]
                      [--deny-settings-excluded-actions]
                      [--deny-settings-excluded-principals]
                      [--deployment-resource-group]
                      [--description]
                      [--parameters]
                      [--query-string]
                      [--tags]
                      [--template-file]
                      [--template-spec]
                      [--template-uri]

Exemples

Validez une pile de déploiement à l’aide du fichier de modèle et détachez toutes les ressources sur unmanage non managé.

az stack sub validate --name StackName --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll

Validez une pile de déploiement avec un fichier de paramètres et supprimez des ressources sur unmanage non managé.

az stack sub validate --name StackName --action-on-unmanage deleteResources --template-file simpleTemplate.json --parameters simpleTemplateParams.json --location westus2 --description description --deny-settings-mode None

Validez une pile de déploiement avec des spécifications de modèle.

az stack sub validate --name StackName --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources

Validez une pile de déploiement à l’aide du fichier bicep et supprimez toutes les ressources sur unmanage non managé.

az stack sub validate --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

Validez une pile de déploiement à un autre abonnement.

az stack sub validate --name StackName --template-file simpleTemplate.json --location westus2 --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources

Validez une pile de déploiement et déployez au niveau de l’étendue du groupe de ressources.

az stack sub validate --name StackName --template-file simpleTemplate.json --location westus --deployment-resource-group ResourceGroup --description description --deny-settings-mode None --action-on-unmanage deleteResources

Validez une pile de déploiement à l’aide de paramètres de paires clé/valeur.

az stack sub validate --name StackName --template-file simpleTemplate.json --location westus --description description --parameters simpleTemplateParams.json value1=foo value2=bar --deny-settings-mode None --action-on-unmanage deleteResources

Validez une pile de déploiement à 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 stack sub validate --name StackName --template-file azuredeploy.json --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json --location westus --deny-settings-mode None --action-on-unmanage deleteResources

Validez une pile de déploiement à partir d’un modèle local, à l’aide des paramètres de refus.

az stack sub validate --name StackName --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-excluded-principals "test1 test2" --location westus --action-on-unmanage deleteResources

Validez une pile de déploiement à partir d’un modèle local, appliquez des paramètres de refus aux étendues enfants.

az stack sub validate --name StackName --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-apply-to-child-scopes --location westus --action-on-unmanage deleteResources

Paramètres obligatoires

--action-on-unmanage --aou

Définit ce qui se passe pour les ressources qui ne sont plus gérées après la mise à jour ou la suppression de la pile.

valeurs acceptées: deleteAll, deleteResources, detachAll
--deny-settings-mode --dm

Définissez les opérations refusées sur les ressources gérées par la pile.

valeurs acceptées: denyDelete, denyWriteAndDelete, none
--location -l

Emplacement pour stocker la pile de déploiement.

--name -n

Nom de la pile de déploiement.

Paramètres facultatifs

--bse --bypass-stack-out-of-sync-error

Indicateur pour contourner les erreurs de service qui indiquent que la liste des ressources de pile n’est pas correctement synchronisée.

valeurs acceptées: false, true
valeur par défaut: False
--cs --deny-settings-apply-to-child-scopes

Refuser Paramètres sera appliqué aux étendues enfants.

valeur par défaut: False
--deny-settings-excluded-actions --ea

Liste des opérations de gestion basées sur les rôles qui sont exclues du refus Paramètres. Jusqu’à 200 actions sont autorisées.

--deny-settings-excluded-principals --ep

Liste des ID de principal AAD exclus du verrou. Jusqu’à 5 principaux sont autorisés.

--deployment-resource-group --dr

Étendue à laquelle le déploiement initial doit être créé. Si aucune étendue n’est spécifiée, elle est définie par défaut sur l’étendue de la pile de déploiement.

--description

Description de la pile de déploiement.

--parameters -p

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.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--template-file -f

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

--template-spec -s

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

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