Compartir a través de


az blueprint assignment

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 comando az blueprint assignment. 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 la asignación de plano técnico.

Comandos

Nombre Description Tipo Estado
az blueprint assignment create

Cree una asignación de plano técnico.

Extension GA
az blueprint assignment delete

Elimine una asignación de plano técnico.

Extension Preview
az blueprint assignment list

Enumera las asignaciones de plano técnico dentro de una suscripción.

Extension Preview
az blueprint assignment show

Obtener una asignación de plano técnico.

Extension Preview
az blueprint assignment update

Actualice una asignación de plano técnico.

Extension GA
az blueprint assignment wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición de asignación de plano técnico.

Extension GA
az blueprint assignment who

Obtenga blueprint Servie Principal Name objectId.

Extension Preview

az blueprint assignment create

Cambio importante

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 una asignación de plano técnico.

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]

Ejemplos

Asignación con identidad administrada asignada por el 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" \

Asignación con identidad administrada asignada por el usuario

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 requeridos

--name -n

Nombre de la asignación de 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.

--blueprint-version

Identificador de recurso de la versión publicada de una definición de plano técnico.

--description

En varias líneas se explica este recurso.

--display-name

Una cadena de línea explica este recurso.

--identity-type

Tipo de la identidad administrada.

Propiedad Valor
Grupo de parámetros: Identity Arguments
Valor predeterminado: SystemAssigned
Valores aceptados: None, SystemAssigned, UserAssigned
--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--locks-excluded-principals

Lista de entidades de seguridad de AAD excluidas de los bloqueos de plano técnico. Se permiten hasta 5 entidades de seguridad.

--locks-mode

Modo de bloqueo.

Propiedad Valor
Valores aceptados: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Use el grupo de administración para el ámbito de destino de la asignación de plano técnico. Está reservado para uso futuro. Use --subscription en su lugar.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
--parameters -p

Valores de parámetros de asignación de plano técnico. Puede ser una cadena JSON o una ruta de acceso del archivo JSON.

--resource-group-value

Pares clave=valor para un grupo de recursos. Las claves incluyen "artifact_name" (obligatorio), "name", "location".

--subscription -s

Use la suscripción para el ámbito de destino de la asignación de plano técnico. Si no se especifica la opción, se usará la susbcription predeterminada.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
--user-assigned-identity

Identidad administrada asignada por el usuario asociada al recurso.

Propiedad Valor
Grupo de parámetros: Identity 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 assignment delete

Vista previa Cambio importante

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

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.

Elimine una asignación de plano técnico.

az blueprint assignment delete --name
                               [--delete-behavior {all, none}]
                               [--management-group]
                               [--subscription]
                               [--yes]

Ejemplos

Eliminar una asignación

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

Parámetros requeridos

--name -n

Nombre de la asignación de 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.

--delete-behavior

Cuando deleteBehavior=all, se eliminarán los recursos creados por la asignación del plano técnico.

Propiedad Valor
Valores aceptados: all, none
--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
--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
--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
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 assignment list

Vista previa Cambio importante

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

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.

Enumera las asignaciones de plano técnico dentro de una suscripción.

az blueprint assignment list [--management-group]
                             [--max-items]
                             [--next-token]
                             [--subscription]

Ejemplos

Enumerar tareas

az blueprint assignment list --subscription MySubscription

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.

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

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token argumento de un comando posterior.

Propiedad Valor
Grupo de parámetros: Pagination Arguments
--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

Propiedad Valor
Grupo de parámetros: Pagination Arguments
--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 assignment show

Vista previa Cambio importante

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

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.

Obtener una asignación de plano técnico.

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

Ejemplos

Mostrar una asignación

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

Parámetros requeridos

--name -n

Nombre de la asignación de 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.

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

Cambio importante

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 una asignación de plano técnico.

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 requeridos

--name -n

Nombre de la asignación de 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.

--blueprint-version

Identificador de recurso de la versión publicada de una definición de plano técnico.

--description

En varias líneas se explica este recurso.

--display-name

Una cadena de línea explica este recurso.

--identity-type

Tipo de la identidad administrada.

Propiedad Valor
Grupo de parámetros: Identity Arguments
Valores aceptados: None, SystemAssigned, UserAssigned
--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--locks-excluded-principals

Lista de entidades de seguridad de AAD excluidas de los bloqueos de plano técnico. Se permiten hasta 5 entidades de seguridad.

--locks-mode

Modo de bloqueo.

Propiedad Valor
Valores aceptados: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Use el grupo de administración para el ámbito de destino de la asignación de plano técnico. Está reservado para uso futuro. Use --subscription en su lugar.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
--parameters -p

Valores de parámetros de asignación de plano técnico. Puede ser una cadena JSON o una ruta de acceso del archivo JSON.

--resource-group-value

Pares clave=valor para un grupo de recursos. Las claves incluyen "artifact_name" (obligatorio), "name", "location".

--subscription -s

Use la suscripción para el ámbito de destino de la asignación de plano técnico. Si no se especifica la opción, se usará la susbcription predeterminada.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
--user-assigned-identity

Identidad administrada asignada por el usuario asociada al recurso.

Propiedad Valor
Grupo de parámetros: Identity 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 assignment wait

Cambio importante

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.

Coloque la CLI en un estado de espera hasta que se cumpla una condición de asignación de plano técnico.

az blueprint assignment wait --name
                             [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--interval]
                             [--management-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

Ejemplos

Pause la ejecución de la siguiente línea de script de la CLI hasta que la asignación de plano técnico se aprovisione correctamente.

az blueprint assignment wait --subscription MySubscription \ --name MyBlueprintAssignment --created

Parámetros requeridos

--name -n

Nombre de la asignación de 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.

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
--deleted

Espere hasta que se elimine.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 30
--management-group -m

Use el grupo de administración para el ámbito de destino de la asignación de plano técnico. Está reservado para uso futuro. Use --subscription en su lugar.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
--subscription -s

Use la suscripción para el ámbito de destino de la asignación de plano técnico. Si no se especifica la opción, se usará la susbcription predeterminada.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
--timeout

Espera máxima en segundos.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
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 assignment who

Vista previa Cambio importante

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

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.

Obtenga blueprint Servie Principal Name objectId.

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

Ejemplos

Obtener objectId de SPN

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

Parámetros requeridos

--name -n

Nombre de la asignación de 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.

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