az repos policy build

Note

Эта ссылка является частью расширения azure-devops для Azure CLI (версия 2.30.0 или выше). Расширение будет автоматически устанавливаться при первом запуске команды az repos policy build. Подробнее о расширениях.

Управление политикой сборки.

Команды

Имя Описание Тип Состояние
az repos policy build create

Создайте политику сборки.

Extension GA
az repos policy build update

Обновление политики сборки.

Extension GA

az repos policy build create

Создайте политику сборки.

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
                             [--acquire-policy-token]
                             [--branch-match-type {exact, prefix}]
                             [--change-reference]
                             [--detect {false, true}]
                             [--org --organization]
                             [--path-filter]
                             [--project]

Обязательные параметры

--blocking

Следует ли блокировать политику.

Свойство Значение
Допустимые значения: false, true
--branch

Ветвь, к которой должна применяться эта политика. Например: master.

--build-definition-id

Идентификатор определения сборки.

--display-name

Отображаемое имя для этой политики сборки для идентификации политики. Например: "Политика очереди вручную".

--enabled

Включена ли политика.

Свойство Значение
Допустимые значения: false, true
--manual-queue-only

Следует ли разрешать только ручную очередь сборок.

Свойство Значение
Допустимые значения: false, true
--queue-on-source-update-only

Очередь только при обновлении источника.

Свойство Значение
Допустимые значения: false, true
--repository-id

Идентификатор репозитория, в котором применяется политика.

--valid-duration

Длительность действия политики (в минутах).

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--branch-match-type

Определяет, как используется аргумент ветви для применения политики. Если значение равно "точно", политика будет применена к ветви, которая имеет точное совпадение с аргументом --branch. Если значение равно префиксу, политика применяется ко всем папкам ветви, которые соответствуют префиксу, предоставленному аргументом --branch.

Свойство Значение
Значение по умолчанию: exact
Допустимые значения: exact, prefix
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--detect

Автоматическое определение организации.

Свойство Значение
Допустимые значения: false, true
--org --organization

Azure DevOps URL-адрес организации. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--path-filter

Пути фильтра, к которым применяется политика. Поддерживает абсолютные пути, подстановочные знаки и несколько путей, разделенных ";". Пример: /WebApp/Models/Data.cs, /WebApp/* или *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az repos policy build update

Обновление политики сборки.

az repos policy build update --id --policy-id
                             [--acquire-policy-token]
                             [--blocking {false, true}]
                             [--branch]
                             [--branch-match-type {exact, prefix}]
                             [--build-definition-id]
                             [--change-reference]
                             [--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]

Обязательные параметры

--id --policy-id

Идентификатор политики.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--blocking

Следует ли блокировать политику.

Свойство Значение
Допустимые значения: false, true
--branch

Ветвь, к которой должна применяться эта политика. Например: master.

--branch-match-type

Определяет, как используется аргумент ветви для применения политики. Если значение равно "точно", политика будет применена к ветви, которая имеет точное совпадение с аргументом --branch. Если значение равно префиксу, политика применяется ко всем папкам ветви, которые соответствуют префиксу, предоставленному аргументом --branch.

Свойство Значение
Допустимые значения: exact, prefix
--build-definition-id

Идентификатор определения сборки.

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--detect

Автоматическое определение организации.

Свойство Значение
Допустимые значения: false, true
--display-name

Отображаемое имя для этой политики сборки для идентификации политики. Например: "Политика очереди вручную".

--enabled

Включена ли политика.

Свойство Значение
Допустимые значения: false, true
--manual-queue-only

Следует ли разрешать только ручную очередь сборок.

Свойство Значение
Допустимые значения: false, true
--org --organization

Azure DevOps URL-адрес организации. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--path-filter

Пути фильтра, к которым применяется политика. Поддерживает абсолютные пути, подстановочные знаки и несколько путей, разделенных ";". Пример: /WebApp/Models/Data.cs, /WebApp/* или *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.

--queue-on-source-update-only

Очередь только при обновлении источника.

Свойство Значение
Допустимые значения: false, true
--repository-id

Идентификатор репозитория, в котором применяется политика.

--valid-duration

Длительность действия политики (в минутах).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False