Compartir a través de


az repos policy build

Nota:

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.

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 con el que esta directiva de compilación identifica la directiva. Por ejemplo: "Directiva de cola manual".

--enabled

Si la directiva está habilitada o no.

valores aceptados: false, true
--manual-queue-only

Establece si solo se pueden poner compilaciones en cola manualmente.

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

Detecta automáticamente la organización.

valores aceptados: false, true
--org --organization

URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Es obligatorio si no está configurada como predeterminada o seleccionada mediante 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 se recoge a través de la configuración de Git.

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

Detecta automáticamente la organización.

valores aceptados: false, true
--display-name

Nombre para mostrar con el que esta directiva de compilación identifica la directiva. Por ejemplo: "Directiva de cola manual".

--enabled

Si la directiva está habilitada o no.

valores aceptados: false, true
--manual-queue-only

Establece si solo se pueden poner compilaciones en cola manualmente.

valores aceptados: false, true
--org --organization

URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Es obligatorio si no está configurada como predeterminada o seleccionada mediante 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 se recoge 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 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.