Partilhar via

az stack group

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

Comandos

Name Description Tipo Status
az stack group create

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

 Core disponibilidade geral
az stack group delete

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

 Core disponibilidade geral
az stack group export

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

 Core disponibilidade geral
az stack group list

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

 Core disponibilidade geral
az stack group show

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

 Core disponibilidade geral
az stack group validate

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

 Core disponibilidade geral

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 --aou {deleteAll, deleteResources, detachAll}
                      --deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
                      --name
                      --resource-group
                      [--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]
                      [--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 arquivo de parâmetros 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 as 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 aos 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 Obrigatórios

--action-on-unmanage --aou

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

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

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

Propriedade Valor
Valores aceites: denyDelete, denyWriteAndDelete, none
--name -n

O nome da pilha de implantação.

--resource-group -g

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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
Default value: False
Valores aceites: false, true
--cs --deny-settings-apply-to-child-scopes

DenySettings será aplicado a escopos filho.

Propriedade Valor
Default value: False
--deny-settings-excluded-actions --ea

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

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

Lista de IDs principais do AAD excluídos do bloqueio. São permitidos até 5 princípios.

--description

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

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--parameters -p

Os parâmetros podem ser fornecidos a partir 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 seu arquivo de parâmetros primeiro 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 template-uri no caso de modelos vinculados.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags 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 do modelo.

--template-uri -u

Um uri para um arquivo de modelo remoto.

--yes

Não solicite confirmação.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az stack group delete

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

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

Exemplos

Exclua a pilha pelo nome.

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

Exclua 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 Obrigatórios

--action-on-unmanage --aou

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

Propriedade Valor
Valores aceites: deleteAll, deleteResources, detachAll

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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
Default value: False
Valores aceites: false, true
--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 onde a pilha de implantação existe.

--yes

Não solicite confirmação.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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 onde a pilha de implantação existe.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az stack group list

Liste 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 Obrigatórios

--resource-group -g

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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

Obtenha o id do recurso pilha por pilha.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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 onde a pilha de implantação existe.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az stack group validate

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

az stack group validate --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
                        --deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
                        --name
                        --resource-group
                        [--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]
                        [--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âmetros e desanexe todos os recursos no 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 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 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 a partir de um modelo local, usando as 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 a partir de um modelo local, aplique a configuração de negação aos 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 Obrigatórios

--action-on-unmanage --aou

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

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

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

Propriedade Valor
Valores aceites: denyDelete, denyWriteAndDelete, none
--name -n

O nome da pilha de implantação.

--resource-group -g

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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
Default value: False
Valores aceites: false, true
--cs --deny-settings-apply-to-child-scopes

DenySettings será aplicado a escopos filho.

Propriedade Valor
Default value: False
--deny-settings-excluded-actions --ea

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

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

Lista de IDs principais do AAD excluídos do bloqueio. São permitidos até 5 princípios.

--description

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

--parameters -p

Os parâmetros podem ser fornecidos a partir 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 seu arquivo de parâmetros primeiro 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 template-uri no caso de modelos vinculados.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags 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 do modelo.

--template-uri -u

Um uri para um arquivo de modelo remoto.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False