Compartir a través de

az blueprint artifact role

  • Cambio importante

Note

Esta referencia forma parte de la extensión de plano técnico para la CLI de Azure (versión 2.50.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un az blueprint artifact role comando. Obtenga más información sobre las extensiones.

Los planos técnicos y los comandos asociados quedarán en desuso a principios de julio de 2026. Se recomienda a los clientes que realicen la transición a las especificaciones de plantilla y a las pilas de implementaciones para admitir sus escenarios más allá de esa fecha. La documentación de migración está disponible en https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Este grupo de comandos está en desuso implícitamente porque el grupo de comandos "az blueprint" está en desuso y se quitará en una versión futura.

Comandos para administrar el artefacto de asignación de roles de plano técnico.

Comandos

Nombre Description Tipo Estado
az blueprint artifact role create

Cree un artefacto de rol de plano técnico.

 Extension GA
az blueprint artifact role update

Actualice el artefacto del rol de plano técnico.

 Extension GA

az blueprint artifact role create

Cambio importante

Este comando está en desuso implícitamente porque el grupo de comandos "az blueprint" está en desuso y se quitará en una versión futura. Los planos técnicos y los comandos asociados quedarán en desuso a principios de julio de 2026. Se recomienda a los clientes que realicen la transición a las especificaciones de plantilla y a las pilas de implementaciones para admitir sus escenarios más allá de esa fecha. La documentación de migración está disponible en https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Cree un artefacto de rol de plano técnico.

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]

Ejemplos

Creación de un artefacto de rol

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 requeridos

--artifact-name

Nombre del artefacto del plano técnico.

--blueprint-name

Nombre de la definición del plano técnico.

--principal-ids

Matriz de identidades de usuario o grupo en Azure Active Directory o una referencia al parámetro correspondiente en el definiton del plano técnico. RoleDefinition se aplicará a cada identidad.

--role-definition-id

Identificador de definición de rol completo. Solo se admiten los roles integrados.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--depends-on

Artefactos que deben implementarse antes del artefacto especificado.

--description

Descripción del artefacto del plano técnico.

--display-name

DisplayName de este artefacto.

--management-group -m

Use el grupo de administración para el ámbito del plano técnico.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
--resource-group-art

Nombre del artefacto del grupo de recursos al que se asignará la directiva.

--subscription -s

Use la suscripción para el ámbito del plano técnico. Si no se especifica --management-group, el valor --subscription o la suscripción predeterminada se usarán como ámbito.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az blueprint artifact role update

Cambio importante

Este comando está en desuso implícitamente porque el grupo de comandos "az blueprint" está en desuso y se quitará en una versión futura. Los planos técnicos y los comandos asociados quedarán en desuso a principios de julio de 2026. Se recomienda a los clientes que realicen la transición a las especificaciones de plantilla y a las pilas de implementaciones para admitir sus escenarios más allá de esa fecha. La documentación de migración está disponible en https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Actualice el artefacto del rol de plano técnico.

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

Ejemplos

Actualización de un artefacto de rol

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

Parámetros requeridos

--artifact-name

Nombre del artefacto del plano técnico.

--blueprint-name

Nombre de la definición del plano técnico.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--depends-on

Artefactos que deben implementarse antes del artefacto especificado. Use "--depends-on" sin valores para quitar dependencias.

--description

Descripción del artefacto del plano técnico.

--display-name

DisplayName de este artefacto.

--management-group -m

Use el grupo de administración para el ámbito del plano técnico.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
--resource-group-art

Nombre del artefacto del grupo de recursos al que se asignará la directiva.

--subscription -s

Use la suscripción para el ámbito del plano técnico. Si no se especifica --management-group, el valor --subscription o la suscripción predeterminada se usarán como ámbito.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False