Поделиться через

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

  • Статья

Команду delete можно использовать для удаления выполненного построения, включая некоторые или все связанные данные.

Примечание

Команда не удаляет данные из хранилища; для выполнения операций такого типа воспользуйтесь командой destroy.Дополнительные сведения см. в разделе Команда Destroy (Team Foundation Build).

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

Для запуска команды delete учетная запись, запрашивающая операцию удаления, должна иметь разрешение Удаление построений со значением Разрешить. Если с удаляемым построением связаны результаты тестирования, учетная запись должна иметь разрешение Публикация результатов тестирования со значением Разрешить. Кроме того, учетная запись службы уровня приложений и учетная запись службы Team Foundation Build должны иметь разрешения на чтение и запись в папке размещения построений. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

TFSBuild delete /collection:teamProjectCollectionUrl /builddefinition:definitionSpec buildnumber[buildNumber...] [/deleteOptions:deleteOptions] [/noprompt] [/silent] [/preview] 

TFSBuild delete /collection:teamProjectCollectionUrl buildUri[buildUri...]

TFSBuild delete teamProjectCollectionUrl teamProject buildNumber[buildNumber...]

TFSBuild delete /collection:teamProjectCollectionUrl /dateRange:[date]~[date] /buildDefinition:definitionSpec

TFSBuild delete /collection:teamProjectCollectionUrl /dateRange:[date]~[date] teamProject

Параметры

Аргумент

Описание

teamProject

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

definitionSpec

Используется с классом /builddefinition. Построение или построения, которые нужно удалить. Поддерживаются подстановочные символы.

buildNumber

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

buildUri

Разделенный пробелами список URI построений, которые планируется удалить.

teamProjectCollectionUrl

URL-адрес коллекции командных проектов, содержащей сборку, которую необходимо удалить (например, http://myserver:8080/tfs/DefaultCollection).

deleteOptions

Задаваемое пользователем значение параметра /deleteOptions. Чтобы удалить построение, можно задать значения следующих параметров:

  • DropLocation — удаляет папку размещения построения.

  • TestResults — удаляет результатов теста для построения

  • Label — удаляет метку системы управления версиями, созданную построением.

  • Details — удаление подробностей (например, журнал активности) о построении.

  • Symbols — удаляет любой файл символов (*.pdb) в хранилище символов, связанных с построением.

  • All – удаляет все данные, связанные с построением.

    ПримечаниеПримечание
    Параметры можно разделять запятыми.Например, можно удалить размещения и символы построения с помощью "/deleteOptions: DropLocation, Symbols".

date

Предоставляемое пользователем значение параметра /daterange. С помощью знака «~» можно задать диапазон дат, как показано в следующих примерах:

  • ~1/1/2010 – все построения, созданные до 01.01.2010

  • 1/1/2010~ – все построения, созданные после 01.01.2010

  • 1/1/2009~12/31/2009 – все построения, созданные с 01.01.2009 по 31.12.2009

Параметр

Описание

/noprompt

Не выполняйте запрос при удалении построения.

/silent

Отключение вывода в окне командной строки при удалении. Подразумевает /noprompt.

/builddefinition

Задает определение или определения построения, которые нужно удалить.

/collection

Указывает коллекцию командных проектов.

/deleteOptions

Задает параметры для удаления построения.

/preview

Отображает результат без фактического выполнения операции delete.

/daterange

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

Заметки

Процесс удаления

При возникновении сбоя во время этого процесса появляется предупреждающее сообщение. Однако даже при появлении предупреждения удаление считается успешным.

Несколько удаляемых построений

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

Журнал событий

Удаления построений регистрируются в журнале событий. Журнал содержит информацию о том, кто удалил построение, о времени удаления и о номере построения.

Пример

Следующий пример удаляет два построения определяемых номерами построения "TestBuild1 1_20070510.1" и "TestBuild 1_20070510.2" из командного проекта AdventureWorks, входящего в коллекцию командных проектов по адресу http://myserver:8080/tfs/DefaultCollection.

> > tfsbuild.exe delete http://myserver:8080/tfs/DefaultCollection Adventureworks "TestBuild1 1_20070510.1" "TestBuild 1_20070510.2"

Следующий пример удаляет два указанных построения, где definitionSpec равен "\Adventureworks\Definition1" из командного проекта AdventureWorks, входящего в коллекцию командных проектов по адресу http://myserver:8080/tfs/DefaultCollection.

>tfsbuild.exe delete /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"\Adventureworks\Definition 1" "Definition 1_20070510.1" "Definition 1_20070510.2"

Следующий пример удаляет два построения определяемых URI построения "vstfs:///TestBuild/TestBuild/1" и "vstfs:///TestBuild/TestBuild/2" из командного проекта AdventureWorks, входящего в коллекцию командных проектов по адресу http://myserver:8080/tfs/DefaultCollection.

>tfsbuild.exe delete /collection:http://myserver:8080/tfs/DefaultCollection vstfs:///TestBuild/TestBuild/1 vstfs:///TestBuild/TestBuild/29

См. также

Задачи

Удаление завершенного построения

Другие ресурсы

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