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]
Обязательные параметры
Следует ли блокировать политику.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Ветвь, к которой должна применяться эта политика. Например: master.
Идентификатор определения сборки.
Отображаемое имя для этой политики сборки для идентификации политики. Например: "Политика очереди вручную".
Включена ли политика.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Следует ли разрешать только ручную очередь сборок.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Очередь только при обновлении источника.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Идентификатор репозитория, в котором применяется политика.
Длительность действия политики (в минутах).
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Автоматическое получение маркера Политика Azure для этой операции ресурса.
| Свойство | Значение |
|---|---|
| Группа параметров: | Global Policy Arguments |
Определяет, как используется аргумент ветви для применения политики. Если значение равно "точно", политика будет применена к ветви, которая имеет точное совпадение с аргументом --branch. Если значение равно префиксу, политика применяется ко всем папкам ветви, которые соответствуют префиксу, предоставленному аргументом --branch.
| Свойство | Значение |
|---|---|
| Значение по умолчанию: | exact |
| Допустимые значения: | exact, prefix |
Связанный идентификатор ссылки на изменение для этой операции ресурса.
| Свойство | Значение |
|---|---|
| Группа параметров: | Global Policy Arguments |
Автоматическое определение организации.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Azure DevOps URL-адрес организации. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
Пути фильтра, к которым применяется политика. Поддерживает абсолютные пути, подстановочные знаки и несколько путей, разделенных ";". Пример: /WebApp/Models/Data.cs, /WebApp/* или *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.
Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Значение по умолчанию: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Значение по умолчанию: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Значение по умолчанию: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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]
Обязательные параметры
Идентификатор политики.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Автоматическое получение маркера Политика Azure для этой операции ресурса.
| Свойство | Значение |
|---|---|
| Группа параметров: | Global Policy Arguments |
Следует ли блокировать политику.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Ветвь, к которой должна применяться эта политика. Например: master.
Определяет, как используется аргумент ветви для применения политики. Если значение равно "точно", политика будет применена к ветви, которая имеет точное совпадение с аргументом --branch. Если значение равно префиксу, политика применяется ко всем папкам ветви, которые соответствуют префиксу, предоставленному аргументом --branch.
| Свойство | Значение |
|---|---|
| Допустимые значения: | exact, prefix |
Идентификатор определения сборки.
Связанный идентификатор ссылки на изменение для этой операции ресурса.
| Свойство | Значение |
|---|---|
| Группа параметров: | Global Policy Arguments |
Автоматическое определение организации.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Отображаемое имя для этой политики сборки для идентификации политики. Например: "Политика очереди вручную".
Включена ли политика.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Следует ли разрешать только ручную очередь сборок.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Azure DevOps URL-адрес организации. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
Пути фильтра, к которым применяется политика. Поддерживает абсолютные пути, подстановочные знаки и несколько путей, разделенных ";". Пример: /WebApp/Models/Data.cs, /WebApp/* или *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.
Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.
Очередь только при обновлении источника.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Идентификатор репозитория, в котором применяется политика.
Длительность действия политики (в минутах).
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Значение по умолчанию: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Значение по умолчанию: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Значение по умолчанию: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Значение по умолчанию: | False |