Start 명령(Team Foundation Build)

start 명령을 사용하여 구성된 Team Foundation Build 빌드 정의를 실행할 수 있습니다.

필요한 권한

start 명령을 사용하려면 Visual Studio Team Foundation Server의 큐 빌드뷰 빌드 정의 보안 권한이 허용으로 설정되어 있어야 합니다. 또한 응용 프로그램 계층 서비스 계정과 Team Foundation Build 서비스 계정에 빌드 저장 위치에 대한 읽기/쓰기 권한이 있어야 합니다. 자세한 내용은 Team Foundation Server 권한을 참조하십시오.

TFSBuild start /collection:teamProjectCollectionUrl 
/builddefinition:definitionSpec [/droplocation:droplocation] [/getoption:getoption] 
[/customgetversion:versionSpec] [/priority:priority] [/requestedfor:userName] 
[/msbuildarguments:args] [/shelveset:shelvesetName [/checkin]] 
[/silent] [/queue]

TFSBuild start teamProjectCollectionUrl teamProject definitionName 
[/droplocation:droplocation] [/getoption:getoption] [priority:priority]
 [/customgetversion:versionSpec] [/requestedfor:userName]
[/shelveset:shelvesetName [/checkin]]
[/msbuildarguments:args] [/silent] [/queue]

매개 변수

인수

설명

teamProjectCollectionUrl

빌드 중인 솔루션과 프로젝트가 포함된 팀 프로젝트 컬렉션의 URL

teamProject

빌드 중인 솔루션과 프로젝트가 포함된 팀 프로젝트의 이름

definitionName

빌드에 사용할 팀 프로젝트의 빌드 정의 이름입니다.

droplocation

빌드가 완료된 후 빌드 이진 파일과 로그 파일이 저장되는 공용 폴더의 경로입니다. 예를 들어 \\server\share를 지정할 수 있습니다. 이 인수는 /droplocation 옵션과 함께 사용됩니다.

getoption

/getoption 옵션과 함께 사용합니다. 유효한 값은 LatestOnQueue, LatestOnBuild 및 Custom입니다.

versionSpec

  • /getoption을 사용자 지정으로 설정할 때 빌드하려는 파일을 지정하는 Versionspec입니다. 이 명령은 /customgetversion 옵션과 함께 사용할 수 있습니다. versionspec 구문에 대한 자세한 내용은 명령줄 구문(버전 제어)을 참조하십시오.

priority

빌드 정의에 사용할 큐 우선 순위입니다. 이 인수는 /priority 옵션과 함께 사용할 수 있습니다.

유효한 값은 Low, BelowNormal, Normal, AboveNormal 및 High입니다.

userName

완성된 빌드와 연결할 사용자의 이름.

args

MSBuild로 전달할 명령줄 인수입니다.

shelvesetName

개인 빌드를 시작하거나 게이트 체크 인 트리거로 정의된 빌드를 시작하는 경우 보류 집합 이름을 지정합니다.

Option

설명

/collection

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

/droplocation

선택적 요소로서, 빌드 프로세스가 발생하는 디렉터리를 지정합니다. /d로 약식 표기할 수 있습니다. 기본적으로 빌드 정의에서 지정된 빌드 디렉터리가 사용됩니다.

참고참고
   빌드 공간이 부족하면 빌드가 취소되므로 빌드 디렉터리를 선택할 때는 빌드 공간이 충분한지 확인해야 합니다.

/getoption

선택적 요소로서, 버전 제어에서 가져오려는 파일을 지정합니다.

/customgetversion

선택적 요소로서, /getoption 값을 Custom으로 지정한 경우 가져올 파일의 사용자 지정 버전을 지정합니다.

/priority

선택적 요소로서, 빌드 큐 우선 순위를 지정합니다.

/requestedfor

선택적 요소로서, 빌드를 요청한 사용자를 지정합니다.

/msbuildarguments

선택적 요소로서, MSBuild로 전달할 명령줄 인수를 지정합니다.

일반적인 형식은 다음과 같습니다.

/msbuildarguments:"/p:SomeProperty=SomeValue /t:MySpecialTarget"

/shelveset

선택적 요소로서, 개인 빌드를 시작하거나 게이트 체크 인 트리거로 정의된 빌드를 시작하는 경우 보류 집합 이름을 지정합니다.

/checkin

선택적 요소로서, 이 옵션은 게이트 체크 인 트리거가 정의된 빌드를 시작하는 경우 적용됩니다. 빌드가 성공한 경우 시스템에서 파일을 체크 인하려면 이 옵션을 지정합니다.

/silent

선택적 요소로서, 이 옵션을 지정하면 빌드가 실행될 때 명령 프롬프트 창에 출력이 나타나지 않습니다.

/queue

빌드 큐에 빌드 시작 요청을 삽입하고 즉시 반환합니다.

설명

작업 스케줄러 서비스와 함께 Team Foundation 명령줄 명령 TFSBuild start를 사용하여 반복되는 빌드나 야간 빌드를 수행할 수 있습니다.

둘 이상의 솔루션을 빌드하면서 빌드 순서를 결정할 때는 솔루션 사이의 종속성을 고려합니다. 예를 들어, Solution2가 Solution1에 종속되어 있는 경우 Solution1을 Solution2보다 먼저 빌드해야 합니다.

저장 디렉터리는 자동으로 공유 디렉터리로 만들어지지 않습니다. 따라서 저장 디렉터리는 빌드와 테스트 결과를 게시하는 데 사용할 수 없습니다. 수동으로 공유를 설정한 다음 Windows 디렉터리에 대한 쓰기 권한과 Team Build Service를 실행하는 데 사용된 두 계정 모두에 대한 공유 권한을 추가해야 빌드를 저장하고 테스터 계정으로 테스트 결과를 게시할 수 있습니다.

예제

다음 예제는 http://myserver:8080/DefaultCollection에 있는 팀 프로젝트 컬렉션의 AdventureWorks 팀 프로젝트에 있는 Nightlies 빌드 형식을 빌드합니다. 결과 빌드는 BuildDrop 디렉터리에 있습니다.

>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"

다음 예제는 http://myserver:8080/DefaultCollection에 있는 컬렉션의 AdventureWorks 팀 프로젝트에 있는 Nightlies 빌드 형식을 빌드합니다. 결과 빌드는 BuildDrop 디렉터리에 있습니다. /msbuildarguments 옵션을 사용하여 MSBuild에서 진단의 자세한 정도를 전달합니다. 자세한 내용은 MSBuild 명령줄 참조을 참조하십시오.

>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"

참고 항목

작업

기본 빌드 정의 만들기

기타 리소스

Team Foundation Build 명령

빌드 실행 및 모니터

빌드 프로세스 정의