Compartilhar via

az stack mg

Gerenciar pilhas de implantação no grupo de gerenciamento.

Comandos

Nome Description Tipo Status
az stack mg create

Crie ou atualize uma pilha de implantação no escopo do grupo de gerenciamento.

 Core GA
az stack mg delete

Exclua a pilha de implantação especificada do escopo do grupo de gerenciamento.

 Core GA
az stack mg export

Exporte o modelo usado para criar a pilha de implantação.

 Core GA
az stack mg list

Listar todas as pilhas de implantação no grupo de gerenciamento.

 Core GA
az stack mg show

Obtenha a pilha de implantação especificada do escopo do grupo de gerenciamento.

 Core GA
az stack mg validate

Valide uma pilha de implantação no escopo do grupo de gerenciamento.

 Core GA

az stack mg create

Crie ou atualize uma pilha de implantação no escopo do grupo de gerenciamento.

az stack mg create --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
                   --deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
                   --___location
                   --management-group-id
                   --name
                   [--bse --bypass-stack-out-of-sync-error {false, true}]
                   [--cs --deny-settings-apply-to-child-scopes]
                   [--deny-settings-excluded-actions --ea]
                   [--deny-settings-excluded-principals --ep]
                   [--deployment-subscription --ds]
                   [--description]
                   [--no-wait]
                   [--parameters]
                   [--query-string]
                   [--tags]
                   [--template-file]
                   [--template-spec]
                   [--template-uri]
                   [--yes]

Exemplos

Crie uma pilha de implantação usando o arquivo de modelo e desanexe todos os recursos em 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

Crie uma pilha de implantação com o arquivo de parâmetro e exclua recursos em 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

Crie uma pilha de implantação com especificação de modelo.

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

Crie uma pilha de implantação usando o arquivo bicep e exclua todos os recursos em unmanage.

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

Crie uma pilha de implantação usando parâmetros de pares chave/valor.

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

Crie uma pilha de implantação a partir de um modelo local, usando um arquivo de parâmetro, um arquivo de parâmetro remoto e substituindo seletivamente pares chave/valor.

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

Crie uma pilha de implantação a partir de um modelo local usando configurações de negação.

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

Crie uma pilha de implantação a partir de um modelo local, aplique as configurações de negação ao escopo filho.

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

Parâmetros Exigidos

--action-on-unmanage --aou

Define o que acontece com recursos que não são mais gerenciados depois que a pilha é atualizada ou excluída.

Propriedade Valor
Valores aceitos: deleteAll, deleteResources, detachAll
--deny-settings-mode --dm

Defina quais operações são negadas em recursos gerenciados pela pilha.

Propriedade Valor
Valores aceitos: denyDelete, denyWriteAndDelete, none
--___location -l

O local para armazenar a pilha de implantação.

--management-group-id -m

A ID do grupo de gerenciamento na qual criar pilha.

--name -n

O nome da pilha de implantação.

Parâmetros Opcionais

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

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

Sinalizar para ignorar erros de serviço que indicam que a lista de recursos de pilha não está sincronizada corretamente.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--cs --deny-settings-apply-to-child-scopes

DenySettings será aplicado a escopos filho.

Propriedade Valor
Valor padrão: False
--deny-settings-excluded-actions --ea

Lista de operações de gerenciamento baseadas em função que são excluídas das denySettings. Até 200 ações são permitidas.

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

Lista de IDs de entidade de segurança do AAD excluídas do bloqueio. Até 5 entidades de segurança são permitidas.

--deployment-subscription --ds

O escopo no qual a implantação inicial deve ser criada. Se um escopo não for especificado, ele usará como padrão o escopo da pilha de implantação.

--description

A descrição da pilha de implantação.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--parameters -p

Os parâmetros podem ser fornecidos de um arquivo usando a sintaxe @{path}, uma cadeia de caracteres JSON ou como pares <KEY=VALUE>. Os parâmetros são avaliados em ordem, portanto, quando um valor é atribuído duas vezes, o último valor será usado. É recomendável que você forneça primeiro o arquivo de parâmetros e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.

--query-string -q

A cadeia de caracteres de consulta (um token SAS) a ser usada com o modelo-uri no caso de modelos vinculados.

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--template-file -f

Um caminho para um arquivo de modelo ou arquivo Bicep no sistema de arquivos.

--template-spec -s

A ID do recurso de especificação de modelo.

--template-uri -u

Um uri para um arquivo de modelo remoto.

--yes

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stack mg delete

Exclua a pilha de implantação especificada do escopo do grupo de gerenciamento.

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

Exemplos

Excluir pilha por nome.

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

Excluir pilha por id de recurso de pilha.

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

Parâmetros Exigidos

--action-on-unmanage --aou

Define o que acontece com recursos que não são mais gerenciados depois que a pilha é atualizada ou excluída.

Propriedade Valor
Valores aceitos: deleteAll, deleteResources, detachAll
--management-group-id -m

A ID do grupo de gerenciamento na qual criar pilha.

Parâmetros Opcionais

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

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

Sinalizar para ignorar erros de serviço que indicam que a lista de recursos de pilha não está sincronizada corretamente.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--id

A ID do recurso da pilha de implantação.

--name -n

O nome da pilha de implantação.

--yes

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stack mg export

Exporte o modelo usado para criar a pilha de implantação.

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

Exemplos

Exportar modelo por nome.

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

Exportar modelo por id de recurso de pilha.

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

Parâmetros Exigidos

--management-group-id -m

A ID do grupo de gerenciamento na qual criar pilha.

Parâmetros Opcionais

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

--id

A ID do recurso da pilha de implantação.

--name -n

O nome da pilha de implantação.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stack mg list

Listar todas as pilhas de implantação no grupo de gerenciamento.

az stack mg list --management-group-id

Exemplos

Listar todas as pilhas

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

Parâmetros Exigidos

--management-group-id -m

A ID do grupo de gerenciamento na qual criar pilha.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stack mg show

Obtenha a pilha de implantação especificada do escopo do grupo de gerenciamento.

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

Exemplos

Obter pilha pelo nome.

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

Obter a id do recurso stack by stack.

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

Parâmetros Exigidos

--management-group-id -m

A ID do grupo de gerenciamento na qual criar pilha.

Parâmetros Opcionais

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

--id

A ID do recurso da pilha de implantação.

--name -n

O nome da pilha de implantação.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stack mg validate

Valide uma pilha de implantação no escopo do grupo de gerenciamento.

az stack mg validate --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
                     --deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
                     --___location
                     --management-group-id
                     --name
                     [--bse --bypass-stack-out-of-sync-error {false, true}]
                     [--cs --deny-settings-apply-to-child-scopes]
                     [--deny-settings-excluded-actions --ea]
                     [--deny-settings-excluded-principals --ep]
                     [--deployment-subscription --ds]
                     [--description]
                     [--parameters]
                     [--query-string]
                     [--tags]
                     [--template-file]
                     [--template-spec]
                     [--template-uri]

Exemplos

Valide uma pilha de implantação usando o arquivo de modelo e desanexe todos os recursos em unmanage.

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

Valide uma pilha de implantação com o arquivo de parâmetro e exclua recursos em unmanage.

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

Validar uma pilha de implantação com especificação de modelo.

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

Valide uma pilha de implantação usando o arquivo bicep e exclua todos os recursos em unmanage.

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

Valide uma pilha de implantação usando parâmetros de pares chave/valor.

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

Valide uma pilha de implantação de um modelo local, usando um arquivo de parâmetro, um arquivo de parâmetro remoto e substituindo seletivamente pares chave/valor.

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

Valide uma pilha de implantação de um modelo local usando configurações de negação.

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

Valide uma pilha de implantação de um modelo local, aplique as configurações de negação ao escopo filho.

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

Parâmetros Exigidos

--action-on-unmanage --aou

Define o que acontece com recursos que não são mais gerenciados depois que a pilha é atualizada ou excluída.

Propriedade Valor
Valores aceitos: deleteAll, deleteResources, detachAll
--deny-settings-mode --dm

Defina quais operações são negadas em recursos gerenciados pela pilha.

Propriedade Valor
Valores aceitos: denyDelete, denyWriteAndDelete, none
--___location -l

O local para armazenar a pilha de implantação.

--management-group-id -m

A ID do grupo de gerenciamento na qual criar pilha.

--name -n

O nome da pilha de implantação.

Parâmetros Opcionais

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

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

Sinalizar para ignorar erros de serviço que indicam que a lista de recursos de pilha não está sincronizada corretamente.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--cs --deny-settings-apply-to-child-scopes

DenySettings será aplicado a escopos filho.

Propriedade Valor
Valor padrão: False
--deny-settings-excluded-actions --ea

Lista de operações de gerenciamento baseadas em função que são excluídas das denySettings. Até 200 ações são permitidas.

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

Lista de IDs de entidade de segurança do AAD excluídas do bloqueio. Até 5 entidades de segurança são permitidas.

--deployment-subscription --ds

O escopo no qual a implantação inicial deve ser criada. Se um escopo não for especificado, ele usará como padrão o escopo da pilha de implantação.

--description

A descrição da pilha de implantação.

--parameters -p

Os parâmetros podem ser fornecidos de um arquivo usando a sintaxe @{path}, uma cadeia de caracteres JSON ou como pares <KEY=VALUE>. Os parâmetros são avaliados em ordem, portanto, quando um valor é atribuído duas vezes, o último valor será usado. É recomendável que você forneça primeiro o arquivo de parâmetros e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.

--query-string -q

A cadeia de caracteres de consulta (um token SAS) a ser usada com o modelo-uri no caso de modelos vinculados.

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--template-file -f

Um caminho para um arquivo de modelo ou arquivo Bicep no sistema de arquivos.

--template-spec -s

A ID do recurso de especificação de modelo.

--template-uri -u

Um uri para um arquivo de modelo remoto.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False