Compartir a través de

az blueprint artifact policy

  • 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 comando az blueprint artifact policy. 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 directivas de plano técnico.

Comandos

Nombre Description Tipo Estado
az blueprint artifact policy create

Cree un artefacto de directiva de plano técnico.

 Extension GA
az blueprint artifact policy update

Actualice el artefacto de la directiva de plano técnico.

 Extension GA

az blueprint artifact policy 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 un artefacto de directiva de plano técnico.

az blueprint artifact policy create --artifact-name
                                    --blueprint-name
                                    --policy-definition-id
                                    [--depends-on]
                                    [--description]
                                    [--display-name]
                                    [--management-group]
                                    [--parameters]
                                    [--resource-group-art]
                                    [--subscription]

Ejemplos

Creación de un artefacto de directiva

az blueprint artifact policy create \
--blueprint-name MyBlueprint --artifact-name MyPolicy --policy-definition-id \
"/providers/Microsoft.Authorization/policyDefinitions/00000000-0000-0000-0000-000000000000" \
--parameters path/to/file --display-name "Policy to do sth"

Parámetros requeridos

--artifact-name

Nombre del artefacto del plano técnico.

--blueprint-name

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

--policy-definition-id

Identificador de definición de directiva completa.

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

Parámetros para el artefacto de asignación de directivas. Puede ser una cadena JSON o una ruta de acceso del archivo JSON.

--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 policy 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 el artefacto de la directiva de plano técnico.

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

Ejemplos

Actualización de un artefacto de directiva

az blueprint artifact policy update \
--blueprint-name MyBlueprint --artifact-name MyPolicy --display-name "My Policy"

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

Parámetros para el artefacto de asignación de directivas. Puede ser una cadena JSON o una ruta de acceso del archivo JSON.

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