Partilhar via

az stack sub

Gerencie pilhas de implantação na assinatura.

Comandos

Name Description Tipo Status
az stack sub create

Crie ou atualize uma pilha de implantação no escopo da assinatura.

 Core disponibilidade geral
az stack sub delete

Exclua a pilha de implantação especificada do escopo da assinatura.

 Core disponibilidade geral
az stack sub export

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

 Core disponibilidade geral
az stack sub list

Liste todas as pilhas de implantação na assinatura.

 Core disponibilidade geral
az stack sub show

Obtenha a pilha de implantação especificada do escopo da assinatura.

 Core disponibilidade geral
az stack sub validate

Valide uma pilha de implantação no escopo da assinatura.

 Core disponibilidade geral

az stack sub create

Crie ou atualize uma pilha de implantação no escopo da assinatura.

az stack sub create --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
                    --deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
                    --location
                    --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-resource-group --dr]
                    [--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 sub create --name StackName --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âmetros e exclua os recursos ao não gerenciar.

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

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

az stack sub create --name StackName --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 sub create --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

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

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

Crie uma pilha de implantação e implante no escopo do grupo de recursos.

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

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

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

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

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

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

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

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

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
--location -l

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

--name -n

O nome da pilha de implantação.

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.

--deployment-resource-group --dr

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

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

Exclua a pilha de implantação especificada do escopo da assinatura.

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

Exemplos

Exclua a pilha pelo nome.

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

Exclua pilha por id de recurso de pilha.

az stack sub delete --id /subscriptions/111111111111/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.

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

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

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

Exemplos

Exportar modelo pelo nome.

az stack sub export --name StackName

Exportar modelo por id de recurso de pilha.

az stack sub export --id /subscriptions/111111111111/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.

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

Liste todas as pilhas de implantação na assinatura.

az stack sub list

Exemplos

Listar todas as pilhas

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

Obtenha a pilha de implantação especificada do escopo da assinatura.

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

Exemplos

Obter pilha pelo nome.

az stack sub show --name StackName

Obtenha o id do recurso pilha por pilha.

az stack sub show --id /subscriptions/111111111111/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.

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

Valide uma pilha de implantação no escopo da assinatura.

az stack sub validate --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
                      --deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
                      --location
                      --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-resource-group --dr]
                      [--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 sub validate --name StackName --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âmetros e exclua recursos no unmanage.

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

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

az stack sub validate --name StackName --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 sub validate --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

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

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

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

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

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

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

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

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

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

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

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

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
--location -l

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

--name -n

O nome da pilha de implantação.

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.

--deployment-resource-group --dr

O escopo no qual a implantação inicial deve ser criada. Se um escopo não for especificado, ele assumirá 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 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