az blueprint assignment

Referência

Observação

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.

Comandos para gerenciar a atribuição do blueprint.

Comandos

Nome	Description	Tipo	Status
az blueprint assignment create	Crie uma atribuição de blueprint.	Extensão	GA
az blueprint assignment delete	Exclua uma atribuição de blueprint.	Extensão	Versão Prévia
az blueprint assignment list	Listar atribuições de blueprint em uma assinatura.	Extensão	Versão Prévia
az blueprint assignment show	Obtenha uma atribuição de blueprint.	Extensão	Versão Prévia
az blueprint assignment update	Atualizar uma atribuição de blueprint.	Extensão	GA
az blueprint assignment wait	Coloque a CLI em um estado de espera até que uma condição da Atribuição do Blueprint seja atendida.	Extensão	GA
az blueprint assignment who	Obtenha o Blueprint Servie Principal Name objectId.	Extensão	Versão Prévia

az blueprint assignment create

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

Parâmetros Opcionais

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

valores aceitos: None, SystemAssigned, UserAssigned

valor padrão: SystemAssigned

--location -l

Local. 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 do blueprint. São permitidos até 5 diretores.

--locks-mode

Modo de bloqueio.

valores aceitos: AllResourcesDoNotDelete, AllResourcesReadOnly, None

--management-group -m

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

--parameters -p

Valores de parâmetro 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. A susbcription padrão será usada se a opção não for especificada.

--user-assigned-identity

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

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az blueprint assignment delete

Versão Prévia

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

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

Parâmetros Opcionais

--delete-behavior

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

valores aceitos: all, none

--management-group -m

Use o grupo de gerenciamento para o escopo do blueprint.

--subscription -s

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

--yes -y

Não solicite confirmação.

valor padrão: False

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az blueprint assignment list

Versão Prévia

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

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

--management-group -m

Use o grupo de gerenciamento para o escopo do blueprint.

--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 no --next-token argumento de um comando subsequente.

--next-token

Token para especificar onde iniciar a paginação. Esse é o valor de token de uma resposta truncada anteriormente.

--subscription -s

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

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az blueprint assignment show

Versão Prévia

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

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

Parâmetros Opcionais

--management-group -m

Use o grupo de gerenciamento para o escopo do blueprint.

--subscription -s

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

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az blueprint assignment update

Atualizar 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 do blueprint.

Parâmetros Opcionais

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

valores aceitos: None, SystemAssigned, UserAssigned

--location -l

Local. 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 do blueprint. São permitidos até 5 diretores.

--locks-mode

Modo de bloqueio.

valores aceitos: AllResourcesDoNotDelete, AllResourcesReadOnly, None

--management-group -m

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

--parameters -p

Valores de parâmetro 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. A susbcription padrão será usada se a opção não for especificada.

--user-assigned-identity

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

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az blueprint assignment wait

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 Exigidos

--name -n

Nome da atribuição do blueprint.

Parâmetros Opcionais

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

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

--deleted

Aguarde até ser excluído.

valor padrão: False

--exists

Aguarde até que o recurso exista.

valor padrão: False

--interval

Intervalo de sondagem em segundos.

valor padrão: 30

--management-group -m

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

--subscription -s

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

--timeout

Espera máxima em segundos.

valor padrão: 3600

--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

valor padrão: False

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az blueprint assignment who

Versão Prévia

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

Obtenha o Blueprint Servie Principal Name objectId.

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

Exemplos

Obter SPN objectId

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

Parâmetros Exigidos

--name -n

Nome da atribuição do blueprint.

Parâmetros Opcionais

--management-group -m

Use o grupo de gerenciamento para o escopo do blueprint.

--subscription -s

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

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

Compartilhar via

az blueprint assignment

Comandos

az blueprint assignment create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az blueprint assignment delete

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az blueprint assignment list

Exemplos

Parâmetros Opcionais

az blueprint assignment show

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az blueprint assignment update

Parâmetros Exigidos

Parâmetros Opcionais

az blueprint assignment wait

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az blueprint assignment who

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Recursos adicionais