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
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
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.
Identificador de recurso de la versión publicada de una definición de plano técnico.
En varias líneas se explica este recurso.
Una cadena de línea explica este recurso.
Tipo de la identidad administrada.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Identity Arguments |
| Valor predeterminado: | SystemAssigned |
| Valores aceptados: | None, SystemAssigned, UserAssigned |
Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Lista de entidades de seguridad de AAD excluidas de los bloqueos de plano técnico. Se permiten hasta 5 entidades de seguridad.
Modo de bloqueo.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | AllResourcesDoNotDelete, AllResourcesReadOnly, None |
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 |
Valores de parámetros de asignación de plano técnico. Puede ser una cadena JSON o una ruta de acceso del archivo JSON.
Pares clave=valor para un grupo de recursos. Las claves incluyen "artifact_name" (obligatorio), "name", "location".
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 |
Identidad administrada asignada por el usuario asociada al recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Identity Arguments |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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
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
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.
Cuando deleteBehavior=all, se eliminarán los recursos creados por la asignación del plano técnico.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | all, none |
Use el grupo de administración para el ámbito del plano técnico.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource_scope Arguments |
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 |
No solicita confirmación.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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
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.
Use el grupo de administración para el ámbito del plano técnico.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource_scope Arguments |
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 |
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 |
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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
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
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.
Use el grupo de administración para el ámbito del plano técnico.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource_scope Arguments |
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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
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
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.
Identificador de recurso de la versión publicada de una definición de plano técnico.
En varias líneas se explica este recurso.
Una cadena de línea explica este recurso.
Tipo de la identidad administrada.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Identity Arguments |
| Valores aceptados: | None, SystemAssigned, UserAssigned |
Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Lista de entidades de seguridad de AAD excluidas de los bloqueos de plano técnico. Se permiten hasta 5 entidades de seguridad.
Modo de bloqueo.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | AllResourcesDoNotDelete, AllResourcesReadOnly, None |
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 |
Valores de parámetros de asignación de plano técnico. Puede ser una cadena JSON o una ruta de acceso del archivo JSON.
Pares clave=valor para un grupo de recursos. Las claves incluyen "artifact_name" (obligatorio), "name", "location".
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 |
Identidad administrada asignada por el usuario asociada al recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Identity Arguments |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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
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
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.
Espere hasta que se cree con "provisioningState" en "Succeeded".
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | False |
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 |
Espere hasta que se elimine.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | False |
Espere hasta que exista el recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | False |
Intervalo de sondeo en segundos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | 30 |
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 |
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 |
Espera máxima en segundos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | 3600 |
Espere hasta que se actualice con provisioningState en "Succeeded".
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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
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
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.
Use el grupo de administración para el ámbito del plano técnico.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource_scope Arguments |
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |