az blueprint artifact role

Alteração interruptiva

Note

Esta referência faz parte da extensão blueprint para o 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.

O Azure Blueprints será descontinuado em 31 de janeiro de 2027, com restrições introduzidas de forma faseada a partir de 31 de julho de 2026. Após a aposentação, a API do serviço deixa de responder e estes comandos deixam de funcionar; serão removidos da CLI do Azure numa versão posterior. Migre definições de projetos para Especificações de Modelo e atribuições para Pilhas de Implementação do Azure (recomendado). Orientação de migração: https://aka.ms/AzureBlueprintsRetirement Este grupo de comandos está implicitamente obsoleto porque o grupo de comando 'az blueprint' está obsoleto e será removido numa versão futura.

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

Comandos

Name	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

Alteração interruptiva

O Azure Blueprints será descontinuado em 31 de janeiro de 2027, com restrições introduzidas de forma faseada a partir de 31 de julho de 2026. Após a aposentação, a API do serviço deixa de responder e estes comandos deixam de funcionar; serão removidos da CLI do Azure numa versão posterior. Migre definições de projetos para Especificações de Modelo e atribuições para Pilhas de Implementação do Azure (recomendado). Orientação de migração: https://aka.ms/AzureBlueprintsRetirement Este comando está implicitamente obsoleto porque o grupo de comando 'az blueprint' está obsoleto e será removido numa versão futura.

Crie um artefato de função de blueprint.

az blueprint artifact role create --artifact-name
                                  --blueprint-name
                                  --principal-ids
                                  --role-definition-id
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--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

Array de identidades de utilizadores ou grupos no Azure Active Directory ou uma referência ao parâmetro correspondente na definição do 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 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.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

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

--debug

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

Propriedade	Valor
Valor predefinido:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor predefinido:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor predefinido:	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 predefinido:	False

az blueprint artifact role update

Alteração interruptiva

O Azure Blueprints será descontinuado em 31 de janeiro de 2027, com restrições introduzidas de forma faseada a partir de 31 de julho de 2026. Após a aposentação, a API do serviço deixa de responder e estes comandos deixam de funcionar; serão removidos da CLI do Azure numa versão posterior. Migre definições de projetos para Especificações de Modelo e atribuições para Pilhas de Implementação do Azure (recomendado). Orientação de migração: https://aka.ms/AzureBlueprintsRetirement Este comando está implicitamente obsoleto porque o grupo de comando 'az blueprint' está obsoleto e será removido numa versão futura.

Atualizar artefato de função de blueprint.

az blueprint artifact role update --artifact-name
                                  --blueprint-name
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--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 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.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

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

--debug

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

Propriedade	Valor
Valor predefinido:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor predefinido:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor predefinido:	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 predefinido:	False

Comentários

Esta página foi útil?