Команда Start (Team Foundation Build)

Статья
11/05/2008

Обновлен: Ноябрь 2007

Команда start используется для запуска настроенного определения построения Team Foundation Build.

Необходимые разрешения

Чтобы использовать команду start, необходимо, чтобы разрешение безопасности Начать построениеTeam Foundation Server имело значение Разрешить. Кроме того, учетная запись службы уровня приложений и учетная запись службы Team Foundation Build должны иметь разрешения на чтение и запись в папке размещения построений. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

Примечание.
Даже если вход в систему выполнен с учетными данными администратора, необходимо открыть окно командной строки с повышенными правами, чтобы выполнить эту функцию на сервере под управлением Windows Server 2008. Чтобы открыть окно командной строки с повышенными правами, нажмите кнопку Пуск, щелкните правой кнопкой мыши пункт Командная строка и выберите команду Запуск от имени администратора. Дополнительные сведения см. на веб-узле корпорации Майкрософт.

Даже если вход в систему выполнен с учетными данными администратора, необходимо открыть окно командной строки с повышенными правами, чтобы выполнить эту функцию на сервере под управлением Windows Server 2008. Чтобы открыть окно командной строки с повышенными правами, нажмите кнопку Пуск, щелкните правой кнопкой мыши пункт Командная строка и выберите команду Запуск от имени администратора. Дополнительные сведения см. на веб-узле корпорации Майкрософт.

TFSBuild start /server:teamFoundationServer 
/builddefinition:definitionSpec [/droplocations:dl] [/getoption:go] 
[/customgetversion:versionSpec] [/priority:p] [/requestedfor:userName] 
[/msbuildarguments:args] [/silent] [/queue]

TFSBuild start teamFoundationServer teamProject definitionName 
[/droplocation:dl] [/getoption:go] [priority:p]
  [/customversion:versionSpec] [/requestedfor:userName]
[/msbuildarguments:args] [/silent] [/queue]

Параметры

Аргумент	Описание
teamFoundationServer	URL-адрес сервера Team Foundation, куда возвращаются построенные решения.
teamProject	Имя командного проекта, для которого необходимо построить решения.
definitionName	Имя определения построения в командном проекте, которое должно использоваться для построения.
dl	Путь к общедоступной папке, где двоичные файлы построений и файлы журналов сохраняются после завершения построения. Например, папка //server/share. Используется с параметром /droplocations.
go	Используется с параметром /getoption. Действительно при значениях "LatestOnQueue", "LatestOnBuild" и "Custom".
versionSpec	Версия файлов, которую необходимо построить, когда параметр /getoption имеет значение "Custom". Используется с параметром /customgetversion. Возможны следующие варианты указания версии. Дата/время (D20/10/2005) Версия набора изменений (C1256) Метка (Lmylabel) Последняя версия (T) Версия рабочей области (Wworkspacename;владелец)
p	Приоритет очереди для определения построения. Используется с параметром /priority. Допустимые значения: "Low", "BelowNormal", "Normal", "AboveNormal" и "High".
userName	Пользователь, который запрашивает построение.
args	Аргументы командной строки, которые передаются в MSBuild.

Параметр	Описание
/droplocation	Необязательный элемент. Задает каталог для процесса построения. Может использоваться сокращение /d. По умолчанию используется каталог построения, указанный в определении построения. Примечание. При выборе каталога построения следует убедиться, что для построения имеется достаточно места, потому что недостаток места приведет к отмене построения.
/getoption	Необязательный элемент. Задает файлы, получаемые из управления версиями.
/customgetversion	Необязательный элемент. Задает пользовательскую версию файлов, которая получается, если параметр /getoption имеет значение "Custom".
/priority	Необязательный элемент. Задает приоритет очереди построения.
/requestedfor	Необязательный элемент. Указывает пользователя, для которого было запрошено построение.
/msbuildarguments	Необязательный элемент. Указывает аргументы командной строки, которые передаются в MSBuild. Общий формат имеет следующий вид: /msbuildarguments:"/p:SomeProperty=SomeValue /t:MySpecialTarget"
/silent	Необязательный элемент. При указании данного параметра данные вывода не записываются в окне командной строки, пока выполняется построение.
/queue	Вставляет запрос на запуск построения в очередь построения и сразу же возвращает.

Заметки

Команда командной строки Team FoundationTFSBuild start может использоваться со службой планировщика заданий, чтобы выполнять периодические или ночные построения.

Если строится несколько решений, при определении порядка построения следует учитывать зависимости решений друг от друга. Например, настройте, чтобы Решение1 строилось раньше Решения2, если Решение2 зависит от Решения1.

По умолчанию транзитный каталог не создается автоматически как общедоступная папка. Таким образом, в нем нельзя публиковать построения и результаты теста. Необходимо вручную настроить общедоступную папку и добавить разрешения на запись для каталога Windows и разрешения на совместное использование для учетной записи, которая запускает службу Team Build Service для сохранения построения, и для учетной записи инженера-испытателя для публикации результатов теста.

Пример

В следующем примере строится тип построения Nightlies в командном проекте AdventureWorks на сервере server01. Итоговое построение располагается в каталоге BuildDrop.

>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"

В следующем примере строится тип построения Nightlies в командном проекте AdventureWorks на сервере server01. Итоговое построение располагается в каталоге BuildDrop. Параметр /msbuildarguments используется для передачи уровня детализации MSBuild диагностики. Дополнительные сведения см. в разделе Справочные сведения о командной строке MSBuild.

>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"