Partager via

az stack mg

  • Référence

Gérer les piles de déploiement au niveau du groupe d’administration.

Commandes

Nom Description Type Statut
az stack mg create

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

 Core GA
az stack mg delete

Supprimez la pile de déploiement spécifiée de l’étendue du groupe d’administration.

 Core GA
az stack mg export

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

 Core GA
az stack mg list

Répertorier toutes les piles de déploiement dans le groupe d’administration.

 Core GA
az stack mg show

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

 Core GA
az stack mg validate

Valider une pile de déploiement dans l’étendue du groupe d’administration.

 Core GA

az stack mg create

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

az stack mg create --action-on-unmanage {deleteAll, deleteResources, detachAll}
                   --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                   --location
                   --management-group-id
                   --name
                   [--bse {false, true}]
                   [--cs]
                   [--deny-settings-excluded-actions]
                   [--deny-settings-excluded-principals]
                   [--deployment-subscription]
                   [--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 mg create --name StackName --management-group-id myMg --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 mg create --name StackName --management-group-id myMg --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 mg create --name StackName --management-group-id myMg --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 mg create --name StackName --management-group-id myMg --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

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

az stack mg create --name StackName --management-group-id myMg --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 mg create --name StackName --management-group-id myMg --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 mg create --name StackName --management-group-id myMg --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 à l’étendue enfant.

az stack mg create --name StackName --management-group-id myMg --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.

--management-group-id -m

ID du groupe d’administration sur lequel créer la pile.

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

É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 mg delete

Supprimez la pile de déploiement spécifiée de l’étendue du groupe d’administration.

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

Exemples

Supprimez la pile par nom.

az stack mg delete --name StackName --management-group-id myMg --action-on-unmanage detachAll

Supprimez la pile par ID de ressource de pile.

az stack mg delete --id /providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/StackName --management-group-id myMg --action-on-unmanage deleteAll

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
--management-group-id -m

ID du groupe d’administration sur lequel créer la pile.

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

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

az stack mg export --management-group-id
                   [--id]
                   [--name]

Exemples

Exportez le modèle par nom.

az stack mg export --name StackName --management-group-id myMg

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

az stack mg export --id /providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/StackName --management-group-id myMg

Paramètres obligatoires

--management-group-id -m

ID du groupe d’administration sur lequel créer la pile.

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

Répertorier toutes les piles de déploiement dans le groupe d’administration.

az stack mg list --management-group-id

Exemples

Répertorier toutes les piles

az stack mg list --management-group-id myMg

Paramètres obligatoires

--management-group-id -m

ID du groupe d’administration sur lequel créer la pile.

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

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

az stack mg show --management-group-id
                 [--id]
                 [--name]

Exemples

Obtenir la pile par nom.

az stack mg show --name StackName --management-group-id myMg

Obtenir la pile par ID de ressource de pile.

az stack mg show --id /providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/StackName --management-group-id myMg

Paramètres obligatoires

--management-group-id -m

ID du groupe d’administration sur lequel créer la pile.

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

Valider une pile de déploiement dans l’étendue du groupe d’administration.

az stack mg validate --action-on-unmanage {deleteAll, deleteResources, detachAll}
                     --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                     --location
                     --management-group-id
                     --name
                     [--bse {false, true}]
                     [--cs]
                     [--deny-settings-excluded-actions]
                     [--deny-settings-excluded-principals]
                     [--deployment-subscription]
                     [--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 mg validate --name StackName --management-group-id myMg --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 mg validate --name StackName --management-group-id myMg --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 mg validate --name StackName --management-group-id myMg --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 mg validate --name StackName --management-group-id myMg --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

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

az stack mg validate --name StackName --management-group-id myMg --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 mg validate --name StackName --management-group-id myMg --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 mg validate --name StackName --management-group-id myMg --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 à l’étendue enfant.

az stack mg validate --name StackName --management-group-id myMg --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.

--management-group-id -m

ID du groupe d’administration sur lequel créer la pile.

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

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