az pipelines

Note

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

Управление Azure Pipelines.

Эта группа команд является частью расширения azure-devops.

Команды

Имя	Описание	Тип	Состояние
az pipelines agent	Управление агентами.	Extension	GA
az pipelines agent list	Получение списка агентов в пуле.	Extension	GA
az pipelines agent show	Отображение сведений об агенте.	Extension	GA
az pipelines build	Управление сборками.	Extension	GA
az pipelines build cancel	Отменяется при выполнении сборки.	Extension	GA
az pipelines build definition	Управление определениями сборки.	Extension	GA
az pipelines build definition list	Перечисление определений сборки.	Extension	GA
az pipelines build definition show	Получение сведений об определении сборки.	Extension	GA
az pipelines build list	Вывод списка результатов сборки.	Extension	GA
az pipelines build queue	Запрос (очередь) сборки.	Extension	GA
az pipelines build show	Получение сведений о сборке.	Extension	GA
az pipelines build tag	Управление тегами сборки.	Extension	GA
az pipelines build tag add	Добавление тегов для сборки.	Extension	GA
az pipelines build tag delete	Удаление тега сборки.	Extension	GA
az pipelines build tag list	Получение тегов для сборки.	Extension	GA
az pipelines create	Создайте новый конвейер Azure (на основе YAML).	Extension	GA
az pipelines delete	Удаление конвейера.	Extension	GA
az pipelines folder	Управление папками для организации конвейеров.	Extension	GA
az pipelines folder create	Создайте папку.	Extension	GA
az pipelines folder delete	Удаление папки.	Extension	GA
az pipelines folder list	Вывод списка всех папок.	Extension	GA
az pipelines folder update	Обновите имя или описание папки.	Extension	GA
az pipelines list	Вывод списка конвейеров.	Extension	GA
az pipelines pool	Управление пулами агентов.	Extension	GA
az pipelines pool list	Вывод списка пулов агентов.	Extension	GA
az pipelines pool show	Отображение сведений о пуле агентов.	Extension	GA
az pipelines queue	Управление очередями агентов.	Extension	GA
az pipelines queue list	Вывод списка очередей агента.	Extension	GA
az pipelines queue show	Отображение сведений о очереди агента.	Extension	GA
az pipelines release	Управление выпусками.	Extension	GA
az pipelines release create	Запрос (создание) выпуска.	Extension	GA
az pipelines release definition	Управление определениями выпуска.	Extension	GA
az pipelines release definition list	Вывод списка определений выпуска.	Extension	GA
az pipelines release definition show	Получение сведений о определении выпуска.	Extension	GA
az pipelines release list	Вывод списка результатов выпуска.	Extension	GA
az pipelines release show	Получение сведений о выпуске.	Extension	GA
az pipelines run	Очередь (запуск) конвейера.	Extension	GA
az pipelines runs	Управление выполнением конвейера.	Extension	GA
az pipelines runs artifact	Управление артефактами запуска конвейера.	Extension	GA
az pipelines runs artifact download	Скачайте артефакт конвейера.	Extension	GA
az pipelines runs artifact list	Вывод списка артефактов, связанных с выполнением.	Extension	GA
az pipelines runs artifact upload	Отправка артефакта конвейера.	Extension	GA
az pipelines runs list	Вывод списка запусков конвейера в проекте.	Extension	GA
az pipelines runs show	Отображение сведений о выполнении конвейера.	Extension	GA
az pipelines runs tag	Управление тегами запуска конвейера.	Extension	GA
az pipelines runs tag add	Добавление тегов для выполнения конвейера.	Extension	GA
az pipelines runs tag delete	Удаление тега запуска конвейера.	Extension	GA
az pipelines runs tag list	Получение тегов для выполнения конвейера.	Extension	GA
az pipelines show	Получение сведений о конвейере.	Extension	GA
az pipelines update	Обновление конвейера.	Extension	GA
az pipelines variable	Управление переменными конвейера.	Extension	GA
az pipelines variable-group	Управление группами переменных.	Extension	GA
az pipelines variable-group create	Создайте группу переменных.	Extension	GA
az pipelines variable-group delete	Удаление группы переменных.	Extension	GA
az pipelines variable-group list	Вывод списка групп переменных.	Extension	GA
az pipelines variable-group show	Отображение сведений о группе переменных.	Extension	GA
az pipelines variable-group update	Обновите группу переменных.	Extension	GA
az pipelines variable-group variable	Управление переменными в группе переменных.	Extension	GA
az pipelines variable-group variable create	Добавьте переменную в группу переменных.	Extension	GA
az pipelines variable-group variable delete	Удалите переменную из группы переменных.	Extension	GA
az pipelines variable-group variable list	Вывод списка переменных в группе переменных.	Extension	GA
az pipelines variable-group variable update	Обновите переменную в группе переменных.	Extension	GA
az pipelines variable create	Добавьте переменную в конвейер.	Extension	GA
az pipelines variable delete	Удаление переменной из конвейера.	Extension	GA
az pipelines variable list	Вывод списка переменных в конвейере.	Extension	GA
az pipelines variable update	Обновите переменную в конвейере.	Extension	GA

az pipelines create

Создайте новый конвейер Azure (на основе YAML).

az pipelines create --name
                    [--acquire-policy-token]
                    [--branch]
                    [--change-reference]
                    [--description]
                    [--detect {false, true}]
                    [--folder-path]
                    [--org --organization]
                    [--project]
                    [--queue-id]
                    [--repository]
                    [--repository-type {github, tfsgit}]
                    [--service-connection]
                    [--skip-first-run --skip-run {false, true}]
                    [--yaml-path --yml-path]

Примеры

Создание конвейера Azure из локального контекста репозитория извлечений

Repository name/url (--repository), type (--repository-type) and branch name (--branch) will be detected from the local git repository
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'

Создание конвейера Azure для репозитория, размещенного на сайте Github, с помощью URL-адреса клонирования

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master

Создание конвейера Azure для репозитория, размещенного в организации Github SampleOrg, имя репозитория SampleRepo

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleOrg/SampleRepoName --branch master --repository-type github

Создание конвейера Azure для репозитория, размещенного в репозитории Azure в том же проекте

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleRepoName --branch master --repository-type tfsgit

Создание конвейера Azure для репозитория с помощью yaml конвейера, уже зарегистрированного в репозитории

Service connection required for non Azure Repos can be optionally provided in the command to run it non interatively
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master --yml-path azure-pipelines.yml [--service-connection SERVICE_CONNECTION]

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

--name

Имя нового конвейера.

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

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

--acquire-policy-token

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

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

--branch

Имя ветви, для которой будет настроен конвейер. Если опущено, он будет автоматически обнаружен из локального репозитория.

--change-reference

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

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

--description

Описание нового конвейера.

--detect

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

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

--folder-path

Путь к папке, в которой необходимо создать конвейер. По умолчанию используется корневая папка. Например, "user1/test_pipelines".

--org --organization

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

--project -p

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

--queue-id

Идентификатор очереди в доступных пулах агентов. Будет автоматически обнаружен, если он не указан.

--repository

Репозиторий, для которого необходимо настроить конвейер. Можно клонировать URL-адрес репозитория Git или имя репозитория для Azure Repos или owner/RepoName в случае GitHub репозитория. Если опущено, он будет автоматически обнаружен из удаленного URL-адреса локального репозитория Git. Если имя указано вместо URL-адреса, аргумент --repository-type также является обязательным.

--repository-type

Тип репозитория. Если опущено, он будет автоматически обнаружен из удаленного URL-адреса локального репозитория. Tfsgit для Azure Repos "github" для репозитория GitHub.

Свойство	Значение
Допустимые значения:	github, tfsgit

--service-connection

Идентификатор подключения службы, созданного для репозитория для GitHub репозитория. Используйте команду az devops service-endpoint -h для создания и перечисления service_connections. Не требуется для Azure Repos.

--skip-first-run --skip-run

Укажите этот флаг, чтобы предотвратить запуск первого запуска, активируемого командой. Команда вернет конвейер, если выполнение пропускается, оно выдаст выполнение конвейера.

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

--yaml-path --yml-path

Путь к файлу yaml конвейеров в репозитории (если yaml уже присутствует в репозитории).

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

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

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False

az pipelines delete

Удаление конвейера.

az pipelines delete --id
                    [--acquire-policy-token]
                    [--change-reference]
                    [--detect {false, true}]
                    [--org --organization]
                    [--project]
                    [--yes]

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

--id

Идентификатор конвейера.

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

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

--acquire-policy-token

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

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

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

--project -p

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

--yes -y

Не запрашивать подтверждение.

Свойство	Значение
Default value:	False

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

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

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False

az pipelines list

Вывод списка конвейеров.

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org --organization]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

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

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

--detect

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

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

--folder-path

При указании фильтрует определения в этой папке.

--name

Ограничить результаты конвейерами с таким именем или начиная с этого имени. Примеры: FabCI или Fab*.

--org --organization

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

--project -p

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

--query-order

Порядок результатов.

Свойство	Значение
Допустимые значения:	ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None

--repository

Ограничить результаты конвейерами, связанными с этим репозиторием.

--repository-type

Ограничить результаты конвейерами, связанными с этим типом репозитория. Необходимо передать аргумент "репозиторий" вместе с этим аргументом.

Свойство	Значение
Допустимые значения:	bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol

--top

Максимальное количество конвейеров для списка.

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

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

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False

az pipelines run

Очередь (запуск) конвейера.

az pipelines run [--acquire-policy-token]
                 [--branch]
                 [--change-reference]
                 [--commit-id]
                 [--detect {false, true}]
                 [--folder-path]
                 [--id]
                 [--name]
                 [--open]
                 [--org --organization]
                 [--parameters]
                 [--project]
                 [--variables]

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

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

--acquire-policy-token

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

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

--branch

Имя ветви, в которой выполняется конвейер, должна быть поставлена в очередь. Пример: refs/heads/master или master или refs/pull/1/merge или refs/tags/tag.

--change-reference

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

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

--commit-id

Идентификатор фиксации, в котором выполняется конвейер, должен быть помещен в очередь.

--detect

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

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

--folder-path

Путь к папке конвейера. По умолчанию используется папка корневого уровня.

--id

Идентификатор конвейера в очередь. Требуется, если --name не задано.

--name

Имя конвейера в очередь. Игнорируется, если указан идентификатор -id.

--open

Откройте страницу результатов конвейера в веб-браузере.

Свойство	Значение
Default value:	False

--org --organization

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

--parameters

Пробелы разделены парами "name=value" для параметров, которые вы хотите задать.

--project -p

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

--variables

Пробелы разделены парами "name=value" для переменных, которые вы хотите задать.

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

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

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False

az pipelines show

Получение сведений о конвейере.

az pipelines show [--detect {false, true}]
                  [--folder-path]
                  [--id]
                  [--name]
                  [--open]
                  [--org --organization]
                  [--project]

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

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

--detect

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

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

--folder-path

Путь к папке конвейера. По умолчанию используется папка корневого уровня.

--id

Идентификатор конвейера.

--name

Имя конвейера. Игнорируется, если указан идентификатор -id.

--open

Откройте страницу сводки конвейера в веб-браузере.

Свойство	Значение
Default value:	False

--org --organization

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

--project -p

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

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

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

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False

az pipelines update

Обновление конвейера.

az pipelines update --id
                    [--acquire-policy-token]
                    [--branch]
                    [--change-reference]
                    [--description]
                    [--detect {false, true}]
                    [--new-folder-path]
                    [--new-name]
                    [--org --organization]
                    [--project]
                    [--queue-id]
                    [--yaml-path --yml-path]

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

--id

Идентификатор конвейера для обновления.

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

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

--acquire-policy-token

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

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

--branch

Имя ветви, для которой будет настроен конвейер.

--change-reference

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

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

--description

Новое описание конвейера.

--detect

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

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

--new-folder-path

Новый полный путь к папке для перемещения конвейера в. Например, "user1/production_pipelines".

--new-name

Новое обновленное имя конвейера.

--org --organization

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

--project -p

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

--queue-id

Идентификатор очереди пула агентов, в котором должен выполняться конвейер.

--yaml-path --yml-path

Путь к yaml-файлу конвейеров в репозитории.

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

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

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False