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가 구문 분석할 수 있는 형식의 날짜입니다. 다음 예제와 같이 "~"를 사용하여 날짜 범위를 지정할 수 있습니다.
|
Option |
설명 |
---|---|
/collection |
팀 프로젝트 컬렉션을 지정합니다. |
/BuildDefinition |
삭제할 빌드 정의 또는 정의를 지정합니다. |
/preview |
제거될 필드를 명령 프롬프트 창에 표시합니다. 이 옵션을 지정하면 빌드는 실제로 삭제되지 않습니다. |
/noprompt |
빌드를 삭제할 때 메시지를 표시하지 않도록 지정합니다. |
/silent |
빌드를 삭제하는 도중 명령 프롬프트 창에 출력을 쓰지 않도록 지정합니다. /noprompt를 의미합니다. |
설명
적절한 권한 없이 빌드를 삭제하려고 시도하면 대화 상자는 해당 팩트를 사용자에게 알립니다.
예제
다음 예제에서는 2010년 11월 20일 이전이고 "New Works" 팀 프로젝트에 있는 "Nightly Build" 빌드 정의를 기반으로 하는 빌드를 영구히 삭제합니다.
>tfsbuild.exe destroy /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"New Works\Nightly Build" /daterange:~2010-11-20