Compartilhar via

az stack group

  • Referência

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

Comandos

Nome Description Tipo Status
az stack group create

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

 Núcleo GA
az stack group delete

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

 Núcleo GA
az stack group export

Exporte o modelo usado para criar a pilha de implantação do escopo do grupo de recursos.

 Núcleo GA
az stack group list

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

 Núcleo GA
az stack group show

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

 Núcleo GA
az stack group validate

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

 Núcleo GA

az stack group create

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

az stack group create --action-on-unmanage {deleteAll, deleteResources, detachAll}
                      --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                      --name
                      --resource-group
                      [--bse {false, true}]
                      [--cs]
                      [--deny-settings-excluded-actions]
                      [--deny-settings-excluded-principals]
                      [--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 exclua recursos em unmanage.

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

Crie uma pilha de implantação com o arquivo de parâmetro e desanexe todos os recursos em unmanage.

az stack group create --name StackName --resource-group ResourceGroup --action-on-unmanage detachAll --template-file simpleTemplate.json --parameters simpleTemplateParams.json --description description --deny-settings-mode None

Crie uma pilha de implantação com especificação de modelo e exclua todos os recursos em unmanage.

az stack group create --name StackName --resource-group ResourceGroup --action-on-unmanage deleteAll --template-spec TemplateSpecResourceIDWithVersion --description description --deny-settings-mode None

Crie uma pilha de implantação usando o arquivo bicep.

az stack group create --name StackName --resource-group ResourceGroup --template-file simple.bicep --description description --deny-settings-mode None --action-on-unmanage deleteResources

Crie uma pilha de implantação em uma assinatura diferente.

az stack group create --name StackName --resource-group ResourceGroup --template-file simpleTemplate.json --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources

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

az stack group create --name StackName --template-file simpleTemplate.json --resource-group ResourceGroup --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 group create --name StackName --template-file azuredeploy.json --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json --resource-group ResourceGroup --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 group create --name StackName --resource-group ResourceGroup --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-excluded-principals "test1 test2" --action-on-unmanage deleteResources

Crie uma pilha de implantação a partir de um modelo local, aplique a configuração de negação a escopos filho.

az stack group create --name StackName --resource-group ResourceGroup --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-apply-to-child-scopes --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.

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

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

Valores aceitos: denyDelete, denyWriteAndDelete, none
--name -n

O nome da pilha de implantação.

--resource-group -g

O grupo de recursos em que a pilha de implantação será criada.

Parâmetros Opcionais

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

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

DenySettings será aplicado a escopos filho.

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.

--description

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

--no-wait

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

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.

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

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

az stack group delete

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

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

Exemplos

Excluir pilha por nome.

az stack group delete --name StackName --resource-group ResourceGroup --action-on-unmanage deleteResources

Excluir pilha por id de recurso de pilha.

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

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.

Valores aceitos: deleteAll, deleteResources, detachAll

Parâmetros Opcionais

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

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

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

--name -n

O nome da pilha de implantação.

--resource-group -g

O grupo de recursos no qual a pilha de implantação existe.

--yes

Não solicite confirmação.

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

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

az stack group export

Exporte o modelo usado para criar a pilha de implantação do escopo do grupo de recursos.

az stack group export [--id]
                      [--name]
                      [--resource-group]

Exemplos

Exportar modelo por nome.

az stack group export --name StackName --resource-group ResourceGroup

Exportar modelo por id de recurso de pilha.

az stack group export --id /subscriptions/111111111111/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/StackName

Parâmetros Opcionais

--id

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

--name -n

O nome da pilha de implantação.

--resource-group -g

O grupo de recursos no qual a pilha de implantação existe.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

az stack group list

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

az stack group list --resource-group

Exemplos

Listar todas as pilhas no grupo de recursos

az stack group list --resource-group ResourceGroup

Parâmetros Exigidos

--resource-group -g

O grupo de recursos no qual a pilha de implantação existe.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

az stack group show

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

az stack group show [--id]
                    [--name]
                    [--resource-group]

Exemplos

Obter pilha pelo nome.

az stack group show --name StackName --resource-group ResourceGroup

Obter a id do recurso stack by stack.

az stack group show --id /subscriptions/111111111111/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/StackName

Parâmetros Opcionais

--id

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

--name -n

O nome da pilha de implantação.

--resource-group -g

O grupo de recursos no qual a pilha de implantação existe.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

az stack group validate

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

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

Exemplos

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

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

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

az stack group validate --name StackName --resource-group ResourceGroup --action-on-unmanage detachAll --template-file simpleTemplate.json --parameters simpleTemplateParams.json --description description --deny-settings-mode None

Valide uma pilha de implantação com especificação de modelo e exclua todos os recursos em unmanage.

az stack group validate --name StackName --resource-group ResourceGroup --action-on-unmanage deleteAll --template-spec TemplateSpecResourceIDWithVersion --description description --deny-settings-mode None

Valide uma pilha de implantação usando o arquivo bicep.

az stack group validate --name StackName --resource-group ResourceGroup --template-file simple.bicep --description description --deny-settings-mode None --action-on-unmanage deleteResources

Valide uma pilha de implantação em uma assinatura diferente.

az stack group validate --name StackName --resource-group ResourceGroup --template-file simpleTemplate.json --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources

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

az stack group validate --name StackName --template-file simpleTemplate.json --resource-group ResourceGroup --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 group validate --name StackName --template-file azuredeploy.json --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json --resource-group ResourceGroup --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 group validate --name StackName --resource-group ResourceGroup --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-excluded-principals "test1 test2" --action-on-unmanage deleteResources

Valide uma pilha de implantação de um modelo local, aplique a configuração de negação a escopos filho.

az stack group validate --name StackName --resource-group ResourceGroup --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-apply-to-child-scopes --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.

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

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

Valores aceitos: denyDelete, denyWriteAndDelete, none
--name -n

O nome da pilha de implantação.

--resource-group -g

O grupo de recursos em que a pilha de implantação será criada.

Parâmetros Opcionais

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

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

DenySettings será aplicado a escopos filho.

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.

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.