Partilhar via

az blueprint artifact role

  • 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 artifact role. Saiba mais sobre extensões.

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. Este grupo de comandos foi implicitamente preterido porque o grupo de comandos 'az blueprint' foi preterido e será removido em uma versão futura.

Comandos para gerenciar o artefato de atribuição de função do blueprint.

Comandos

Nome Descrição Tipo Estado
az blueprint artifact role create

Crie um artefato de função de blueprint.

 Extension disponibilidade geral
az blueprint artifact role update

Atualizar artefato de função de blueprint.

 Extension disponibilidade geral

az blueprint artifact role 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 um artefato de função de blueprint.

az blueprint artifact role create --artifact-name
                                  --blueprint-name
                                  --principal-ids
                                  --role-definition-id
                                  [--depends-on]
                                  [--description]
                                  [--display-name]
                                  [--management-group]
                                  [--resource-group-art]
                                  [--subscription]

Exemplos

Criar um artefato de função

az blueprint artifact role create \
--blueprint-name MyBlueprint --artifact-name MyRole --role-definition-id \
"/providers/Microsoft.Authorization/roleDefinitions/00000000-0000-0000-0000-000000000000" \
--principal-ids "[parameters('[Usergrouporapplicationname]:MyRoleAssignmentName')]"

Parâmetros Obrigatórios

--artifact-name

Nome do artefato de esquema.

--blueprint-name

Nome da definição do blueprint.

--principal-ids

Matriz de identidades de usuário ou grupo no Azure Ative Directory ou uma referência ao parâmetro correspondente na definição de blueprint. O roleDefinition será aplicado a cada identidade.

--role-definition-id

A id de definição de função completa. Apenas funções internas são suportadas.

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.

--depends-on

Artefatos que precisam ser implantados antes do artefato especificado.

--description

Descrição do artefato de planta.

--display-name

DisplayName deste artefato.

--management-group -m

Use o grupo de gerenciamento para o escopo do blueprint.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--resource-group-art

Nome do artefato do grupo de recursos ao qual a política será atribuída.

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

Atualizar artefato de função de blueprint.

az blueprint artifact role update --artifact-name
                                  --blueprint-name
                                  [--depends-on]
                                  [--description]
                                  [--display-name]
                                  [--management-group]
                                  [--resource-group-art]
                                  [--subscription]

Exemplos

Atualizar um artefato de função

az blueprint artifact role update \
--blueprint-name MyBlueprint --artifact-name MyRole --display-name "My Big Role"

Parâmetros Obrigatórios

--artifact-name

Nome do artefato de esquema.

--blueprint-name

Nome da definiçã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.

--depends-on

Artefatos que precisam ser implantados antes do artefato especificado. Use '--depends-on' sem valores para remover dependências.

--description

Descrição do artefato de planta.

--display-name

DisplayName deste artefato.

--management-group -m

Use o grupo de gerenciamento para o escopo do blueprint.

Propriedade Valor
Grupo de parâmetros: Resource_scope Arguments
--resource-group-art

Nome do artefato do grupo de recursos ao qual a política será atribuída.

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