Checkin 명령
현재 작업 영역의 보류 중인 변경 내용을 Team Foundation 버전 제어 서버에 커밋합니다.
필요한 권한
checkin 명령을 사용하려면 체크 인 권한이 허용으로 설정되어 있어야 합니다. /author 옵션을 사용하려면 다른 사용자의 변경 내용 체크 인 권한이 허용으로 설정되어 있어야 합니다. 자세한 내용은 Team Foundation Server 권한을 참조하십시오.
tf checkin [/author:author name] [/comment:("comment"|@comment file)]
[/noprompt] [/notes:("Note Name"="note text"|@notefile)]
[/override:(reason|@reasonfile)] [/recursive] [/saved] [/validate] [itemspec] [/bypass] [/login:username,[password]]
tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]
매개 변수
인수 |
설명 |
|---|---|
author name |
/author 옵션에 대한 사용자 제공 값입니다. |
comment |
체크 인에 대한 사용자 제공 설명입니다. |
@comment file |
체크 인에 대한 설명이 포함된 디스크에 있는 파일의 사용자 제공 경로입니다. |
NoteFieldName=NoteFieldValue |
체크 인 메모 필드의 값을 설정합니다. 세미콜론으로 구분된 여러 "field=value" 식을 제공할 수 있습니다. |
Notefile |
체크 인 메모 필드 이름과 값을 "field=value" 형식으로 포함하는 디스크에 있는 파일의 사용자 제공 경로입니다. 각 "field=value"를 세미콜론으로 구분하여 여러 줄에 입력할 수 있습니다. 예를 들면 다음과 같습니다. field1=value1; field2=value 는 여러 줄에 걸쳐 있음; |
Reasonfile |
체크 인 정책을 무시하는 이유에 대한 사용자 제공 설명입니다. 이유가 지정된 경우 정책 재정의와 이 설명에 대한 알림이 Team Foundation 관리자에게 전자 메일로 보내집니다. |
itemspec |
체크 인할 파일이나 폴더를 지정합니다. Team Foundation에서 파일 사양을 구문 분석하여 범위 내에 있는 항목을 결정하는 자세한 방법은 명령줄 옵션을 참조하십시오. |
username |
/login 옵션에 값을 제공합니다. 사용자 이름 값을 DOMAIN\UserName 또는 UserName으로 지정할 수 있습니다. |
shelvesetname [:owner] |
체크 인할 보류 집합을 식별합니다. 선택적 요소인 owner 인수는 현재 사용자가 소유하지 않은 보류 집합을 지정하는 데 사용합니다. |
TeamProjectCollectionUrl |
체크 인할 파일 또는 폴더를 포함하는 팀 프로젝트 컬렉션의 URL입니다(예: http://myserver:8080/tfs/DefaultCollection). |
Option |
설명 |
|---|---|
/author |
사용자가 다른 사용자를 대신하여 변경 내용을 체크 인할 수 있도록 보류 중인 변경 내용의 작성자를 식별합니다. CheckinOther 권한이 필요합니다. |
/comment |
변경 집합에 설명을 연결합니다. |
/noprompt |
사용자 입력을 요청하는 메시지를 표시하지 않습니다. |
/notes |
변경 집합과 연결할 체크 인 메모를 하나 이상 제공합니다. |
/override |
체크 인 정책 실패를 재정의할 수 있습니다. 체크 인 정책이 존재하며 체크 인하려는 경우에만 이 옵션이 필요합니다. |
/recursive |
지정되거나 포함된 작업 폴더 및 하위 폴더의 모든 항목을 체크 인합니다. |
/saved |
체크 인이 실패하거나 사용자가 체크 인을 취소하거나 사용자가 변경 내용을 복원할 경우 선택된 변경 내용, 설명, 작업 항목, 체크 인 메모, 체크 인 정책 재정의 이유(있을 경우) 등이 컴퓨터에 저장됩니다. /saved 옵션은 /noprompt와 함께 사용될 경우 저장된 설명(있을 경우) 등과 함께 변경 내용을 체크 인합니다. 해당되는 경우 저장되었습니다. |
/validate |
/validate 옵션을 사용하면 실제로 체크 인하지 않고 체크 인을 테스트할 수 있습니다. /validate 옵션은 체크 인이 실제로 체크인하지 않고 체크 인 정책을 평가하고, 체크인 메모를 확인하고, 충돌을 확인하도록 합니다. 이 옵션으로 식별되는 충돌 같은 문제는 항목을 체크 인하기 전에 해결해야 합니다. |
/bypass |
제어된 체크 인 요구를 무시합니다. 자세한 내용은 제어된 체크 인 빌드에 의해 제어되는 보류 중인 변경 내용 체크 인을 참조하십시오. |
/login |
Visual Studio Team Foundation Server에서 사용자를 인증할 사용자 이름과 암호를 지정합니다. |
/shelveset |
이름으로 보류 집합을 지정합니다. |
/collection |
팀 프로젝트 컬렉션을 지정합니다. |
설명
보류 중인 변경 내용은 파일 또는 폴더 추가, 삭제, 이름 바꾸기, 편집, 분기, 삭제 취소 또는 파일 형식으로 구성됩니다. 편집 및 이름 바꾸기와 같은 일부 변경 내용은 단일 항목에 동시에 적용할 수 있습니다. 보류 중인 변경은 체크 인을 위해 제출되지 않은 것입니다. Team Foundation에서 보류 중인 변경의 전체 목록에 대한 자세한 내용은 보류 중인 변경 내용을 참조하십시오.
checkin 명령은 보류 중인 변경 내용, 작업 항목, 사용자 정의 설명 및 시스템 메타데이터의 동적으로 정의된 집합에서 Team Foundation 버전 제어 서버의 변경 집합을 만들고 다른 사용자가 변경 내용을 사용할 수 있게 만듭니다. 다른 사용자는 get 명령을 사용하여 변경 내용을 검색할 수 있습니다. history 및 changeset 명령은 전송된 변경 내용에 대한 변경 집합 정보를 표시합니다.
참고
명령줄에서 보류 중인 변경 내용을 체크 인할 수 있으므로 소스 제어 탐색기의 상황에 맞는 메뉴가 보류 중인 변경 내용의 상태를 항상 반영하지 않을 수도 있습니다.
tf 명령줄 유틸리티를 검색하는 방법에 대한 자세한 내용은 Tf 명령줄 유틸리티 명령을 참조하십시오.
체크 인 프로세스
체크 인 작업은 원자적으로 수행되는데 이는 작업이 전부 성공하거나 전부 실패한다는 것을 의미합니다. 보류 중인 변경 내용의 목록에 있는 변경 내용 중 하나를 Team Foundation 버전 제어 서버에 전송하지 못할 경우 변경 내용 중 하나가 커밋되는 것이 아니며 변경 집합이 작성되지 않습니다. 예를 들어, 작업 도중에 네트워크 연결이 끊길 경우 전체 작업이 실패합니다.
체크 인 프로세스의 첫 번째 단계는 보류 중인 변경 내용이 체크 인 정책을 준수하는지 평가하는 것입니다. /override 옵션을 사용하여 명령줄에서 체크 인 정책 실패를 재정의할 수 있습니다. 정책 실패가 재정의되는 이유를 제공해야 합니다. 이 이유는 Team Foundation 버전 제어 서버에서 유지되며 커밋된 변경 집합의 특성이 됩니다. /override 옵션은 주로 스크립트에서 사용하도록 되어 있습니다. 자세한 내용은 체크 인 정책 재정의을 참조하십시오.
보류 중인 변경 내용의 목록에 있는 항목의 버전이 최신 Team Foundation 버전 제어 서버 버전과 다를 경우 Team Foundation은 먼저 사용자의 버전과 최신 Team Foundation 버전 제어 서버 버전 사이의 충돌을 해결하라는 메시지를 표시합니다. 예를 들어, stellar.cs의 버전 4를 체크 아웃했으며 최신 Team Foundation 버전 제어 서버 버전이 이제 버전 6인 경우 충돌을 해결하는 메시지가 표시됩니다. **/noprompt ** 옵션을 지정하지 않은 경우 버전 차이를 조사 및 해결할 수 있도록 해결 대화 상자가 표시됩니다. 차이를 해결하고 코드를 다시 테스트한 후에 변경 내용 체크 인을 다시 시도할 수 있습니다.
예제
다음 예제에서는 c:\projects에 매핑된 작업 영역의 모든 보류 중인 변경 내용의 대량 체크 인 작업을 위해 미리 선택된 보류 중인 변경 내용이 있는 체크 인 대화 상자를 표시합니다. 항목이 체크 아웃되었으므로 체크 인을 클릭하면 각 항목이 Team Foundation 버전 제어 서버의 변경 집합에 개별적으로 전송되고 평가되어 서버 버전이 변경되지 않았는지 확인합니다. 체크 인에 성공할 경우 Team Foundation은 변경 집합을 만들고 이후에 참조하기 위해 해당 번호를 표시합니다.
c:\projects>tf checkin
다음 예제에서는 현재 작업 영역의 모든 보류 중인 변경 내용을 지정된 설명과 함께 Team Foundation 버전 제어 서버에 전송하여 새 변경 집합을 만듭니다.
c:\projects>tf checkin /comment:"Re-implemented Pi calculator" /noprompt
다음 예제에서는 보류 중인 변경 내용을 314.cs에 전송하고 현재 작업 영역의 다른 모든 수정 버전을 보류 중인 상태로 둡니다.
c:\projects>tf checkin 314.cs /noprompt