다음을 통해 공유


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 – 빌드의 테스트 결과를 삭제합니다.

  • 레이블 – 빌드에서 만든 버전 제어 레이블을 삭제합니다.

  • 세부 정보 - 빌드 세부 사항(예: 활동 로그)을 삭제합니다.

  • 기호 – 빌드와 관련된 기호 저장소에서 기호 파일(*.pdb)을 삭제합니다.

  • 모두 – 빌드와 관련된 모든 데이터를 삭제합니다.

    참고참고
    쉼표를 사용하여 옵션을 구분할 수 있습니다.예를 들어, "/deleteOptions: DropLocation, Symbols"를 사용하여 빌드의 저장과 기호를 삭제할 수 있습니다.

date

/daterange 옵션에 대한 사용자 제공 값입니다. 다음 예제와 같이 "~"를 사용하여 날짜 범위를 지정할 수 있습니다.

  • ~1/1/2010 – 2010년 1월 1일 전에 만들어진 모든 빌드

  • 1/1/2010~ – 2010년 1월 1일 후에 만들어진 모든 빌드

  • 1/1/2009~12/31/2009 – 2009년 1월 1일과 2009년 12월 31일 사이에 만들어진 모든 빌드

Option

설명

/noprompt

빌드를 삭제할 때 메시지를 표시하지 않습니다.

/silent

삭제 도중 명령 프롬프트 창에 출력을 쓰지 않습니다. /noprompt를 의미합니다.

/builddefinition

삭제할 빌드 정의 또는 정의를 지정합니다.

/collection

팀 프로젝트 컬렉션을 지정합니다.

/deleteOptions

빌드를 삭제하는 옵션을 지정합니다.

/preview

delete 작업을 실제로 수행하지 않은 상태에서 발생하는 작업을 표시합니다.

/daterange

삭제할 빌드의 날짜 범위를 지정합니다.

설명

삭제 프로세스

이 과정에서 오류가 발생할 경우 경고 메시지가 표시됩니다. 하지만 경고가 나타나더라도 삭제는 성공한 것으로 간주됩니다.

삭제되는 여러 빌드

여러 빌드를 지정하는 경우 빌드 중 하나를 삭제하는 데 실패하더라도 프로세스가 중지되지는 않습니다. 명령은 빌드 삭제 실패 오류 메시지가 제공된 후 계속해서 다른 빌드를 삭제합니다.

이벤트 로그

빌드 삭제는 이벤트 로그에 로깅됩니다. 이 로그에는 빌드를 삭제한 사람, 빌드가 삭제된 시간 및 빌드 번호에 대한 정보가 포함됩니다.

예제

다음 예제에서는 http://myserver:8080/tfs/DefaultCollection에 있는 팀 프로젝트 컬렉션의 AdventureWorks 팀 프로젝트에서 빌드 번호 "TestBuild1 1_20070510.1" 및 "TestBuild 1_20070510.2"로 정의된 두 개의 빌드를 삭제합니다.

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

다음 예제에서는 http://myserver:8080/tfs/DefaultCollection에 있는 팀 프로젝트 컬렉션의 AdventureWorks 팀 프로젝트에서 definitionSpec이 "\Adventureworks\Definition1"인 두 개의 특정 빌드를 삭제합니다.

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

다음 예제에서는 http://myserver:8080/tfs/DefaultCollection에 있는 AdventureWorks 팀 프로젝트에서 빌드 URI "vstfs:///TestBuild/TestBuild/1" 및 "vstfs:///TestBuild/TestBuild/2"에 의해 정의되는 두 빌드를 삭제합니다.

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

참고 항목

작업

완료된 빌드 삭제

기타 리소스

Destroy 명령(Team Foundation Build)