Compartilhar via

az blueprint assignment

  • Alteração interruptiva

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 instalará automaticamente na primeira vez que você executar um comando az blueprint assignment. Saiba mais sobre extensões.

Esse grupo de comandos foi substituído implicitamente porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Blueprints 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 Pilhas de Implementação para oferecer suporte a 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 de blueprint.

Comandos

Nome Description Tipo Status
az blueprint assignment create

Crie uma atribuição de blueprint.

 Extension GA
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 atribuição de blueprint.

 Extension Preview
az blueprint assignment update

Atualize uma atribuição de blueprint.

 Extension GA
az blueprint assignment wait

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

 Extension GA
az blueprint assignment who

Obter o objectId nome da entidade de segurança do Blueprint Servie.

 Extension Preview

az blueprint assignment create

Alteração interruptiva

Esse comando foi substituído implicitamente porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Blueprints 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 Pilhas de Implementação para oferecer suporte a 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 Exigidos

--name -n

Nome da atribuição de blueprint.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--blueprint-version

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

--description

Várias linhas explicam esse recurso.

--display-name

Uma cadeia de caracteres de linha explica esse recurso.

--identity-type

Tipo da identidade gerenciada.

Propriedade Valor
Grupo de parâmetros: Identity Arguments
Valor padrão: SystemAssigned
Valores aceitos: 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 segurança do AAD excluídas dos bloqueios de blueprint. Até 5 entidades de segurança são permitidas.

--locks-mode

Modo de bloqueio.

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

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

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

Valores de parâmetro de atribuição de 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), 'name', 'location'.

--subscription -s

Use a assinatura para o escopo de destino da atribuição de blueprint. A susbcription padrão será usada 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 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.

--verbose

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

Propriedade Valor
Valor padrão: False

az blueprint assignment delete

Versão Prévia Alteração interruptiva

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Esse comando foi substituído implicitamente porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Blueprints 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 Pilhas de Implementação para oferecer suporte a 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 Exigidos

--name -n

Nome da atribuição de blueprint.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios 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 aceitos: 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, --subscription value or the default subscription will be used as the scope.

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

--verbose

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

Propriedade Valor
Valor padrão: False

az blueprint assignment list

Versão Prévia Alteração interruptiva

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Esse comando foi substituído implicitamente porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Blueprints 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 Pilhas de Implementação para oferecer suporte a 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 tarefas

az blueprint assignment list --subscription MySubscription

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios 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 onde iniciar a paginação. Esse é o valor do 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, --subscription value or the default subscription will be used as the scope.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
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.

--verbose

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

Propriedade Valor
Valor padrão: False

az blueprint assignment show

Versão Prévia Alteração interruptiva

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Esse comando foi substituído implicitamente porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Blueprints 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 Pilhas de Implementação para oferecer suporte a 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 atribuição de blueprint.

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

Exemplos

Mostrar uma atribuição

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

Parâmetros Exigidos

--name -n

Nome da atribuição de blueprint.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios 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, --subscription value or the default subscription will be used as the scope.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
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.

--verbose

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

Propriedade Valor
Valor padrão: False

az blueprint assignment update

Alteração interruptiva

Esse comando foi substituído implicitamente porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Blueprints 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 Pilhas de Implementação para oferecer suporte a 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 Exigidos

--name -n

Nome da atribuição de blueprint.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--blueprint-version

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

--description

Várias linhas explicam esse recurso.

--display-name

Uma cadeia de caracteres de linha explica esse recurso.

--identity-type

Tipo da identidade gerenciada.

Propriedade Valor
Grupo de parâmetros: Identity Arguments
Valores aceitos: 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 segurança do AAD excluídas dos bloqueios de blueprint. Até 5 entidades de segurança são permitidas.

--locks-mode

Modo de bloqueio.

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

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

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

Valores de parâmetro de atribuição de 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), 'name', 'location'.

--subscription -s

Use a assinatura para o escopo de destino da atribuição de blueprint. A susbcription padrão será usada 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 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.

--verbose

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

Propriedade Valor
Valor padrão: False

az blueprint assignment wait

Alteração interruptiva

Esse comando foi substituído implicitamente porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Blueprints 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 Pilhas de Implementação para oferecer suporte a 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 de 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 de script da CLI até que a Atribuição de Blueprint seja provisionada com êxito.

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

Parâmetros Exigidos

--name -n

Nome da atribuição de blueprint.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios 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 atenda 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. Ele é 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 de blueprint. A susbcription padrão será usada 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é que seja 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 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.

--verbose

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

Propriedade Valor
Valor padrão: False

az blueprint assignment who

Versão Prévia Alteração interruptiva

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Esse comando foi substituído implicitamente porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura. Blueprints 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 Pilhas de Implementação para oferecer suporte a 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.

Obter o objectId nome da entidade de segurança do Blueprint Servie.

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

Exemplos

Obter objectId do SPN

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

Parâmetros Exigidos

--name -n

Nome da atribuição de blueprint.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios 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, --subscription value or the default subscription will be used as the scope.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
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.

--verbose

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

Propriedade Valor
Valor padrão: False