Compartir a través de

az repos policy build

Note

Esta referencia forma parte de la extensión 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. Obtenga 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.

 Extension GA
az repos policy build update

Actualizar la directiva de compilación.

 Extension 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 --organization]
                             [--path-filter]
                             [--project]

Parámetros requeridos

--blocking

Si la directiva debe bloquearse o no.

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

Propiedad Valor
Valores aceptados: false, true
--manual-queue-only

Si solo se permite la cola manual de compilaciones.

Propiedad Valor
Valores aceptados: false, true
--queue-on-source-update-only

Solo cola en la actualización de origen.

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

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.

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

Propiedad Valor
Valor predeterminado: exact
Valores aceptados: exact, prefix
--detect

Detectar automáticamente la organización.

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

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.

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

Propiedad Valor
Valor predeterminado: False

az repos policy build update

Actualizar la directiva de compilación.

az repos policy build update --id --policy-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 --organization]
                             [--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

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.

--blocking

Si la directiva debe bloquearse o no.

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

Propiedad Valor
Valores aceptados: exact, prefix
--build-definition-id

Id. de definición de compilación.

--detect

Detectar automáticamente la organización.

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

Propiedad Valor
Valores aceptados: false, true
--manual-queue-only

Si solo se permite la cola manual de compilaciones.

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

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

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.

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

Propiedad Valor
Valor predeterminado: False