az repos policy build

Nota:

Esta referencia forma parte de la extensión de azure-devops para la CLI de Azure (versión 2.30.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az repos policy build. Más información sobre las extensiones.

Administrar la directiva de compilación.

Comandos

Nombre	Description	Tipo	Estado
az repos policy build create	Cree una directiva de compilación.	Extensión	GA
az repos policy build update	Actualizar la directiva de compilación.	Extensión	GA

az repos policy build create

Cree una directiva de compilación.

az repos policy build create --blocking {false, true}
                             --branch
                             --build-definition-id
                             --display-name
                             --enabled {false, true}
                             --manual-queue-only {false, true}
                             --queue-on-source-update-only {false, true}
                             --repository-id
                             --valid-duration
                             [--branch-match-type {exact, prefix}]
                             [--detect {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]

Parámetros requeridos

--blocking

Si la directiva debe bloquearse o no.

Valores aceptados: false, true

--branch

Rama en la que se debe aplicar esta directiva. Por ejemplo: maestro.

--build-definition-id

Id. de definición de compilación.

--display-name

Nombre para mostrar de esta directiva de compilación para identificar la directiva. Por ejemplo: "Directiva de cola manual".

--enabled

Si la directiva está habilitada o no.

Valores aceptados: false, true

--manual-queue-only

Si solo se permite la cola manual de compilaciones.

Valores aceptados: false, true

--queue-on-source-update-only

Solo cola en la actualización de origen.

Valores aceptados: false, true

--repository-id

Identificador del repositorio en el que se va a aplicar la directiva.

--valid-duration

Duración de la validez de la directiva (en minutos).

Parámetros opcionales

--branch-match-type

Determina cómo se usa el argumento de rama para aplicar una directiva. Si el valor es "exacto", la directiva se aplicará en una rama que tenga una coincidencia exacta en el argumento --branch. Si el valor es "prefijo", la directiva se aplica en todas las carpetas de rama que coinciden con el prefijo proporcionado por el argumento --branch.

Valores aceptados: exact, prefix

Valor predeterminado: exact

--detect

Detectar automáticamente la organización.

Valores aceptados: false, true

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--path-filter

Filtre las rutas de acceso en las que se aplica la directiva. Admite rutas de acceso absolutas, caracteres comodín y varias rutas de acceso separadas por ';'. Ejemplo: /WebApp/Models/Data.cs, /WebApp/* o *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

Parámetros globales

--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

az repos policy build update

Actualizar la directiva de compilación.

az repos policy build update --id
                             [--blocking {false, true}]
                             [--branch]
                             [--branch-match-type {exact, prefix}]
                             [--build-definition-id]
                             [--detect {false, true}]
                             [--display-name]
                             [--enabled {false, true}]
                             [--manual-queue-only {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]
                             [--queue-on-source-update-only {false, true}]
                             [--repository-id]
                             [--valid-duration]

Parámetros requeridos

--id --policy-id

Identificador de la directiva.

Parámetros opcionales

--blocking

Si la directiva debe bloquearse o no.

Valores aceptados: false, true

--branch

Rama en la que se debe aplicar esta directiva. Por ejemplo: maestro.

--branch-match-type

Determina cómo se usa el argumento de rama para aplicar una directiva. Si el valor es "exacto", la directiva se aplicará en una rama que tenga una coincidencia exacta en el argumento --branch. Si el valor es "prefijo", la directiva se aplica en todas las carpetas de rama que coinciden con el prefijo proporcionado por el argumento --branch.

Valores aceptados: exact, prefix

--build-definition-id

Id. de definición de compilación.

--detect

Detectar automáticamente la organización.

Valores aceptados: false, true

--display-name

Nombre para mostrar de esta directiva de compilación para identificar la directiva. Por ejemplo: "Directiva de cola manual".

--enabled

Si la directiva está habilitada o no.

Valores aceptados: false, true

--manual-queue-only

Si solo se permite la cola manual de compilaciones.

Valores aceptados: false, true

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--path-filter

Filtre las rutas de acceso en las que se aplica la directiva. Admite rutas de acceso absolutas, caracteres comodín y varias rutas de acceso separadas por ';'. Ejemplo: /WebApp/Models/Data.cs, /WebApp/* o *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

--queue-on-source-update-only

Solo cola en la actualización de origen.

Valores aceptados: false, true

--repository-id

Identificador del repositorio en el que se va a aplicar la directiva.

--valid-duration

Duración de la validez de la directiva (en minutos).

Parámetros globales

--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.