Compartir vía

az blueprint artifact role

  • Obsoleto

Note

This reference is part of the blueprint extension for the Azure CLI (version 2.50.0 or higher). La extensión instalará automáticamente la primera vez que ejecute un az blueprint artifact role comando. Learn more about extensions.

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

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 Deprecated
az blueprint artifact role update

Actualice el artefacto del rol de plano técnico.

 Extension Deprecated

az blueprint artifact role create

Obsoleto

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 comando está en desuso implícitamente porque el grupo de comandos "az blueprint" está en desuso y se quitará en una versión futura.

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
Parameter group: 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
Parameter group: 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

Output format.

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

Obsoleto

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 comando está en desuso implícitamente porque el grupo de comandos "az blueprint" está en desuso y se quitará en una versión futura.

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
Parameter group: 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
Parameter group: 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

Output format.

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