Команда Destroy (Team Foundation Build)
Для полного удаления готовых построений можно использовать команду TFSBuild destroy. Можно сохранить место в хранилище данных, уничтожив устаревшие построения.
Предупреждение
Эту команду следует использовать с осторожностью, поскольку ее эффект необратим.
Эта команда окончательно удаляет запись базы данных для построения, но не удаляет артефакты, относящиеся к построению, такие как сбросы, метки элементов управления версиями и результаты тестов. Команду TFSBuild delete можно использовать для удаления артефактов, прежде чем навсегда удалить построение.
Необходимые разрешения
Для использования команды destroy необходимо иметь разрешение Уничтожение построений со значением Разрешить. Это разрешение автоматически получают администраторы коллекции командных проектов, администраторы проекта и построители. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
TFSBuild destroy /collection:TeamProjectCollectionUrl /BuildDefinition:DefinitionSpec BuildNumber [BuildNumber...] [/noprompt] [/silent] [/preview]
TFSBuild destroy /collection:TeamProjectCollectionUrl BuildUri [BuildUri...]
TFSBuild destroy TeamProjectCollectionUrl TeamProject BuildNumber [BuildNumber...]
TFSBuild destroy /collection:TeamProjectCollectionUrl /DateRange: [Date]~[Date] /BuildDefinition:DefinitionSpec
TFSBuild destroy /collection:TeamProjectCollectionUrl BuildUri [BuildUri...]
Параметры
Аргумент |
Описание |
|---|---|
TeamProjectCollectionUrl |
URL-адрес коллекции командных проектов, содержащей сборку, которую необходимо уничтожить (например, http://myserver:8080/tfs/DefaultCollection). |
DefinitionSpec |
Используется с классом /BuildDefinition. Определения построения, которые нужно уничтожить. Допускается использование подстановочных знаков. |
BuildNumber |
Разделенный пробелами список построений, которые планируется удалить. Если номер построения содержит пробелы, следует заключить его в одинарные кавычки. Допускается использование подстановочных знаков. |
BuildUri |
Разделенный пробелами список URI построений, которые планируется удалить. |
TeamProject |
Имя командного проекта, для которого предназначено определение построения. |
Date |
Используется для параметра /daterange. Дата в формате, обрабатываемом .NET Framework. С помощью знака «~» можно задать диапазон дат, как показано в следующих примерах:
|
Параметр |
Описание |
|---|---|
/collection |
Указывает коллекцию командных проектов. |
/BuildDefinition |
Задает определение или определения построения, которые нужно удалить. |
/preview |
Отображает в окне командной строки построения, которые будут уничтожены. При указании этого параметра построения не уничтожаются фактически. |
/noprompt |
Задает не выполнять запрос при удалении построения. |
/silent |
Указывает не записывать выходные данные в окно командной строки во время удаления построений. Подразумевает /noprompt. |
Заметки
При попытке удаления сборки без соответствующих разрешений появится диалоговое окно с информацией об этом.
Пример
В этом примере окончательно удаляется построения, которые старше 20 ноября 2010, и основанных на определении построения "Ночного построения" в командном проекте "Новые работы".
>tfsbuild.exe destroy /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"New Works\Nightly Build" /daterange:~2010-11-20
См. также
Задачи
Удаление завершенного построения
Создание базового определения построения