Команда Delete (Team Foundation Build)
Обновлен: Ноябрь 2007
Команда delete удаляет указанное завершенное построение. Все данные, связанные с построением, удаляются из агента построения и системы управления версиями, и папка размещения очищается. Кроме того, построение больше не содержится в обозревателе построений.
Необходимые разрешения
Для запуска команды delete учетная запись, запрашивающая операцию удаления, должна иметь разрешение Администрирование построения со значением Разрешить. Если с удаляемым построением связаны результаты тестирования, учетная запись должна иметь разрешение Публикация результатов тестирования со значением Разрешить. Кроме того, учетная запись службы уровня приложений и учетная запись службы Team Foundation Build должны иметь разрешения на чтение и запись в папке размещения построений. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
.gif "Примечание") Примечание. |
|---|
Даже если вход в систему выполнен с учетными данными администратора, необходимо открыть окно командной строки с повышенными правами, чтобы выполнить эту функцию на сервере под управлением Windows Server 2008. Чтобы открыть окно командной строки с повышенными правами, нажмите кнопку Пуск, щелкните правой кнопкой мыши пункт Командная строка и выберите команду Запуск от имени администратора. Дополнительные сведения см. на веб-узле корпорации Майкрософт. |
TFSBuild delete [/noprompt] [/silent] /server:teamFoundationServer /builddefinition:definitionSpec buildNumbers…
TFSBuild delete [/noprompt] [/silent] /server:teamFoundationServer buildUris…
TFSBuild delete [/noprompt] [/silent] teamFoundationServer teamProject buildNumbers…
Параметры
Аргумент |
Описание |
|---|---|
teamfoundationserver |
URL-адрес сервера Team Foundation, используемый для построений. |
teamProject |
Имя командного проекта, для которого предназначено определение построения. |
definitionSpec |
Используется с классом /builddefinition. Удаляемое построение или построения. Поддерживаются символы подстановки. |
BuildNumbers |
Разделенный пробелами список удаляемых построений. Если номер построения содержит пробелы, его необходимо заключить в одиночные кавычки. Поддерживаются символы подстановки. |
buildUris |
Разделенный пробелами список URI-идентификаторов удаляемых построений. Например: tfsbuild delete uri1 uri2 uri3 /s:MyServer. |
Параметр |
Описание |
|---|---|
/noprompt |
Необязательный. Отключение запроса при удалении построения. |
/silent |
Необязательный. Отключение вывода в окне командной строки при удалении. Подразумевает /noprompt. |
/server |
Сервер Team Foundation, используемый для удаляемого построения или построений. |
/builddefinition |
Задает удаляемое определение или определения построений. |
Заметки
Процесс удаления
При удалении номера построения выполните следующие действия:
Убедитесь, что номер построения допустим и построение в данный момент не выполняется.
Удалите содержимое хранилища построений и узла размещения, если у запрашивающего пользователя имеется разрешение Администрирование построения.
Очистите папку размещения от двоичных файлов данного построения. В случае сбоя этого процесса выдается предупреждение. Однако даже при наличии предупреждения удаление считается успешным.
Примечание.Данные из хранилища не удаляются.
Несколько удаляемых построений
Если указать несколько построений, сбой при удалении одного из них не остановит весь процесс. Команда продолжит удаление других построений после выдачи сообщение об ошибке удаления построения.
Журнал событий
Удаления построений регистрируются в журнале событий. Журнал содержит информацию о том, кто удалил построение, о времени удаления и о номере построения.
Пример
Следующий пример удаляет два построения, определенные номерами "TestBuild1 1_20070510.1" и "TestBuild 1_20070510.2", из командного проекта AdventureWorks на сервере server01.
> > tfsbuild.exe delete http://server01:8080 Adventureworks “TestBuild1 1_20070510.1” “TestBuild 1_20070510.2”
Следующий пример удаляет два конкретных построения, в которых definitionSpec равно "\Adventureworks\Definition1", из командного проекта AdventureWorks на сервере server01.
>tfsbuild.exe delete /server:http://server01:8080 /builddefinition:”\Adventureworks\Definition 1” “Definition 1_20070510.1” “Definition 1_20070510.2”
Следующий пример удаляет два построения, определенные URI-идентификаторами "vstfs:///TestBuild/TestBuild/1" и "vstfs:///TestBuild/TestBuild/2", из командного проекта AdventureWorks на сервере server01.
>tfsbuild.exe delete /server:http://server01:8080 vstfs:///TestBuild/TestBuild/1 vstfs:///TestBuild/TestBuild/29
См. также
Задачи
Практическое руководство. Удаление завершенного построения (командная строка)
Создание определения построения