Compartir a través de

az blueprint assignment

  • Referencia

Nota:

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.

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.

 Extensión GA
az blueprint assignment delete

Elimine una asignación de plano técnico.

 Extensión Vista previa
az blueprint assignment list

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

 Extensión Vista previa
az blueprint assignment show

Obtener una asignación de plano técnico.

 Extensión Vista previa
az blueprint assignment update

Actualice una asignación de plano técnico.

 Extensión 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.

 Extensión GA
az blueprint assignment who

Obtenga blueprint Servie Principal Name objectId.

 Extensión Vista previa

az blueprint assignment create

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

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

Valores aceptados: None, SystemAssigned, UserAssigned
Valor predeterminado: SystemAssigned
--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.

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.

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

--user-assigned-identity

Identidad administrada asignada por el usuario asociada al recurso.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az blueprint assignment delete

Vista previa

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

Elimine una asignación de plano técnico.

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

Ejemplos

Eliminación de 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

--delete-behavior

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

Valores aceptados: all, none
--management-group -m

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

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

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az blueprint assignment list

Vista previa

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

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

az blueprint assignment list --subscription MySubscription

Parámetros opcionales

--management-group -m

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

--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 el argumento de un comando posterior.

--next-token

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

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az blueprint assignment show

Vista previa

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

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

--management-group -m

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

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az blueprint assignment update

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

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

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.

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.

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

--user-assigned-identity

Identidad administrada asignada por el usuario asociada al recurso.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

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.

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

--created

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

Valor predeterminado: False
--custom

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

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

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.

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

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

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

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az blueprint assignment who

Vista previa

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

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

--management-group -m

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

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.