Partilhar via

az blueprint assignment

  • Mudança de última hora

Note

Essa referência faz parte da extensão de blueprint para a CLI do Azure (versão 2.50.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az blueprint assignment. Saiba mais sobre extensões.

Este grupo de comandos foi implicitamente preterido porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Os planos e comandos associados serão preteridos já em julho de 2026. Os clientes são incentivados a fazer a transição para Especificações de Modelo e Conjuntos de Implementações para suportar os seus cenários além dessa data. A documentação de migração está disponível em https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Comandos para gerenciar a atribuição do blueprint.

Comandos

Nome Descrição Tipo Estado
az blueprint assignment create

Crie uma atribuição de blueprint.

 Extension disponibilidade geral
az blueprint assignment delete

Exclua uma atribuição de blueprint.

 Extension Preview
az blueprint assignment list

Listar atribuições de blueprint em uma assinatura.

 Extension Preview
az blueprint assignment show

Obtenha uma tarefa de blueprint.

 Extension Preview
az blueprint assignment update

Atualize uma atribuição de blueprint.

 Extension disponibilidade geral
az blueprint assignment wait

Coloque a CLI em um estado de espera até que uma condição da atribuição do Blueprint seja atendida.

 Extension disponibilidade geral
az blueprint assignment who

Obtenha o Blueprint Servie Principal Name objectId.

 Extension Preview

az blueprint assignment create

Mudança de última hora

Este comando foi implicitamente preterido porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Os planos e comandos associados serão preteridos já em julho de 2026. Os clientes são incentivados a fazer a transição para Especificações de Modelo e Conjuntos de Implementações para suportar os seus cenários além dessa data. A documentação de migração está disponível em https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Crie uma atribuição de blueprint.

az blueprint assignment create --name
                               [--blueprint-version]
                               [--description]
                               [--display-name]
                               [--identity-type {None, SystemAssigned, UserAssigned}]
                               [--location]
                               [--locks-excluded-principals]
                               [--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
                               [--management-group]
                               [--parameters]
                               [--resource-group-value]
                               [--subscription]
                               [--user-assigned-identity]

Exemplos

Atribuição com identidade gerenciada atribuída pelo sistema

az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type SystemAssigned \
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/provid \
ers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=westus \
--resource-group-value artifact_name=rg-art-2 name=rg2 location=eastus \
--parameters "path/to/parameter/file" \

Atribuição com identidade gerenciada atribuída pelo usuário

az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type UserAssigned \
--user-assigned-identity "/subscriptions/00000000-0000-0000-0000-000000000000 \
/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"\
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup \
/providers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=eastus \
--parameters "path/to/parameter/file" \

Parâmetros Obrigatórios

--name -n

Nome da atribuição do blueprint.

Parâmetros Opcionais

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

--blueprint-version

ID do recurso da versão publicada de uma definição de blueprint.

--description

Multi-linha explicar este recurso.

--display-name

Uma cadeia de caracteres de linha única explica este recurso.

--identity-type

Tipo de identidade gerenciada.

Propriedade Valor
Grupo de parâmetros: Identity Arguments
Valor padrão: SystemAssigned
Valores aceites: None, SystemAssigned, UserAssigned
--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--locks-excluded-principals

Lista de entidades de AAD excluídas dos bloqueios de blueprint. São permitidos até 5 princípios.

--locks-mode

Modo de bloqueio.

Propriedade Valor
Valores aceites: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Use o grupo de gerenciamento para o escopo de destino da atribuição de blueprint. Está reservado para uso futuro. Em vez disso, use --subscription.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--parameters -p

Valores dos parâmetros de atribuição do Blueprint. Pode ser uma cadeia de caracteres JSON ou um caminho de arquivo JSON.

--resource-group-value

Pares Key=Value para um grupo de recursos. As chaves incluem 'artifact_name'(obrigatório), 'nome', 'localização'.

--subscription -s

Use a assinatura para o escopo de destino da atribuição do blueprint. Susbcription padrão será usado se a opção não for especificada.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--user-assigned-identity

A identidade gerenciada atribuída pelo usuário associada ao recurso.

Propriedade Valor
Grupo de parâmetros: Identity Arguments
Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

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

--verbose

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

Propriedade Valor
Valor padrão: False

az blueprint assignment delete

Previsualizar Mudança de última hora

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Este comando foi implicitamente preterido porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Os planos e comandos associados serão preteridos já em julho de 2026. Os clientes são incentivados a fazer a transição para Especificações de Modelo e Conjuntos de Implementações para suportar os seus cenários além dessa data. A documentação de migração está disponível em https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Exclua uma atribuição de blueprint.

az blueprint assignment delete --name
                               [--delete-behavior {all, none}]
                               [--management-group]
                               [--subscription]
                               [--yes]

Exemplos

Excluir uma atribuição

az blueprint assignment delete --subscription MySubscription --name MyBlueprintAssignment

Parâmetros Obrigatórios

--name -n

Nome da atribuição do blueprint.

Parâmetros Opcionais

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

--delete-behavior

Quando deleteBehavior=all, os recursos que foram criados pela atribuição de blueprint serão excluídos.

Propriedade Valor
Valores aceites: all, none
--management-group -m

Use o grupo de gerenciamento para o escopo do blueprint.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--subscription -s

Use a assinatura para o escopo do blueprint. Se --management-group não for especificado, --valor da assinatura ou a assinatura padrão será usada como escopo.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--yes -y

Não solicite confirmação.

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

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

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

Mostrar esta mensagem de ajuda e sair.

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

--verbose

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

Propriedade Valor
Valor padrão: False

az blueprint assignment list

Previsualizar Mudança de última hora

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Este comando foi implicitamente preterido porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Os planos e comandos associados serão preteridos já em julho de 2026. Os clientes são incentivados a fazer a transição para Especificações de Modelo e Conjuntos de Implementações para suportar os seus cenários além dessa data. A documentação de migração está disponível em https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Listar atribuições de blueprint em uma assinatura.

az blueprint assignment list [--management-group]
                             [--max-items]
                             [--next-token]
                             [--subscription]

Exemplos

Listar atribuições

az blueprint assignment list --subscription MySubscription

Parâmetros Opcionais

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

--management-group -m

Use o grupo de gerenciamento para o escopo do blueprint.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token em --next-token argumento de um comando subsequente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--next-token

Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--subscription -s

Use a assinatura para o escopo do blueprint. Se --management-group não for especificado, --valor da assinatura ou a assinatura padrão será usada como escopo.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

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

--verbose

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

Propriedade Valor
Valor padrão: False

az blueprint assignment show

Previsualizar Mudança de última hora

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Este comando foi implicitamente preterido porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Os planos e comandos associados serão preteridos já em julho de 2026. Os clientes são incentivados a fazer a transição para Especificações de Modelo e Conjuntos de Implementações para suportar os seus cenários além dessa data. A documentação de migração está disponível em https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Obtenha uma tarefa de blueprint.

az blueprint assignment show --name
                             [--management-group]
                             [--subscription]

Exemplos

Mostrar uma tarefa

az blueprint assignment show --subscription MySubscription --name MyBlueprintAssignment

Parâmetros Obrigatórios

--name -n

Nome da atribuição do blueprint.

Parâmetros Opcionais

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

--management-group -m

Use o grupo de gerenciamento para o escopo do blueprint.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--subscription -s

Use a assinatura para o escopo do blueprint. Se --management-group não for especificado, --valor da assinatura ou a assinatura padrão será usada como escopo.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

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

--verbose

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

Propriedade Valor
Valor padrão: False

az blueprint assignment update

Mudança de última hora

Este comando foi implicitamente preterido porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Os planos e comandos associados serão preteridos já em julho de 2026. Os clientes são incentivados a fazer a transição para Especificações de Modelo e Conjuntos de Implementações para suportar os seus cenários além dessa data. A documentação de migração está disponível em https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Atualize uma atribuição de blueprint.

az blueprint assignment update --name
                               [--blueprint-version]
                               [--description]
                               [--display-name]
                               [--identity-type {None, SystemAssigned, UserAssigned}]
                               [--location]
                               [--locks-excluded-principals]
                               [--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
                               [--management-group]
                               [--parameters]
                               [--resource-group-value]
                               [--subscription]
                               [--user-assigned-identity]

Parâmetros Obrigatórios

--name -n

Nome da atribuição do blueprint.

Parâmetros Opcionais

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

--blueprint-version

ID do recurso da versão publicada de uma definição de blueprint.

--description

Multi-linha explicar este recurso.

--display-name

Uma cadeia de caracteres de linha única explica este recurso.

--identity-type

Tipo de identidade gerenciada.

Propriedade Valor
Grupo de parâmetros: Identity Arguments
Valores aceites: None, SystemAssigned, UserAssigned
--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--locks-excluded-principals

Lista de entidades de AAD excluídas dos bloqueios de blueprint. São permitidos até 5 princípios.

--locks-mode

Modo de bloqueio.

Propriedade Valor
Valores aceites: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Use o grupo de gerenciamento para o escopo de destino da atribuição de blueprint. Está reservado para uso futuro. Em vez disso, use --subscription.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--parameters -p

Valores dos parâmetros de atribuição do Blueprint. Pode ser uma cadeia de caracteres JSON ou um caminho de arquivo JSON.

--resource-group-value

Pares Key=Value para um grupo de recursos. As chaves incluem 'artifact_name'(obrigatório), 'nome', 'localização'.

--subscription -s

Use a assinatura para o escopo de destino da atribuição do blueprint. Susbcription padrão será usado se a opção não for especificada.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--user-assigned-identity

A identidade gerenciada atribuída pelo usuário associada ao recurso.

Propriedade Valor
Grupo de parâmetros: Identity Arguments
Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

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

--verbose

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

Propriedade Valor
Valor padrão: False

az blueprint assignment wait

Mudança de última hora

Este comando foi implicitamente preterido porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Os planos e comandos associados serão preteridos já em julho de 2026. Os clientes são incentivados a fazer a transição para Especificações de Modelo e Conjuntos de Implementações para suportar os seus cenários além dessa data. A documentação de migração está disponível em https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Coloque a CLI em um estado de espera até que uma condição da atribuição do Blueprint seja atendida.

az blueprint assignment wait --name
                             [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--interval]
                             [--management-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

Exemplos

Pause a execução da próxima linha do script da CLI até que a atribuição do Blueprint seja provisionada com êxito.

az blueprint assignment wait --subscription MySubscription \ --name MyBlueprintAssignment --created

Parâmetros Obrigatórios

--name -n

Nome da atribuição do blueprint.

Parâmetros Opcionais

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

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 30
--management-group -m

Use o grupo de gerenciamento para o escopo de destino da atribuição de blueprint. Está reservado para uso futuro. Em vez disso, use --subscription.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--subscription -s

Use a assinatura para o escopo de destino da atribuição do blueprint. Susbcription padrão será usado se a opção não for especificada.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--timeout

Espera máxima em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

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

--verbose

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

Propriedade Valor
Valor padrão: False

az blueprint assignment who

Previsualizar Mudança de última hora

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Este comando foi implicitamente preterido porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Os planos e comandos associados serão preteridos já em julho de 2026. Os clientes são incentivados a fazer a transição para Especificações de Modelo e Conjuntos de Implementações para suportar os seus cenários além dessa data. A documentação de migração está disponível em https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Obtenha o Blueprint Servie Principal Name objectId.

az blueprint assignment who --name
                            [--management-group]
                            [--subscription]

Exemplos

Obter objectId do SPN

az blueprint assignment who --subscription MySubscription --name MyBlueprintAssignment

Parâmetros Obrigatórios

--name -n

Nome da atribuição do blueprint.

Parâmetros Opcionais

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

--management-group -m

Use o grupo de gerenciamento para o escopo do blueprint.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--subscription -s

Use a assinatura para o escopo do blueprint. Se --management-group não for especificado, --valor da assinatura ou a assinatura padrão será usada como escopo.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

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

--verbose

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

Propriedade Valor
Valor padrão: False