분기 명령(Team Foundation 버전 제어)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
TFVC branch 명령은 메타데이터 및 버전 제어 기록을 포함한 항목 또는 항목 집합을 Azure DevOps 서버 및 로컬 작업 영역에서 한 위치에서 다른 위치로 복사합니다.
참고 항목
이 명령의 결과는 검사 작업을 수행할 때까지 Azure DevOps 서버에 반영되지 않습니다. 자세한 내용은 팀의 코드베이스에 대한 작업 체크 인을 참조하세요.
필수 조건
이 branch 명령을 사용하려면 원본 항목에 대한 읽기 권한과 대상 폴더에 대한 체크 아웃 및 병합 권한이 허용으로 설정되어 있어야 합니다. 자세한 내용은 기본 TFVC 권한을 참조 하세요.
구문
tf branch olditem newitem [/version:versionspec] [/noget] [/lock:(none|checkin|checkout)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]] [/recursive]
매개 변수
인수
| Argument | 설명 |
|---|---|
<olditem> |
분기할 원본 파일 또는 폴더의 이름을 지정합니다. 형식 <olditem> 의 item;version버전 정보도 포함될 수 있습니다. |
<newitem> |
대상 파일 또는 폴더의 이름 또는 대상의 부모 폴더를 지정합니다. 이미 있고 Azure DevOps Server 폴더인 경우 <*newitem> TFVC는 해당 폴더 내에 분기된 항목을 만듭니다. 그렇지 않으면 <newitem> 대상 파일 또는 폴더의 이름을 지정합니다. 대상이 이미 있는 경우 검사 동안 충돌이 발생할 수 있습니다. |
<versionspec> |
옵션에 대한 /version 값을 제공합니다. TFVC가 버전 사양을 구문 분석하여 범위 내에 있는 항목을 결정하는 방법에 대한 자세한 내용은 Team Foundation 버전 제어 명령 사용을 참조 하세요. |
<comment> |
분기에 대한 설명을 제공합니다. |
@<commentfile> |
분기에 사용되는 주석이 포함된 파일의 경로를 지정합니다. |
<authorname> |
옵션에 대해 사용자가 제공한 값입니다 /author . |
<username> |
옵션에 값을 /login 제공합니다. 사용자 이름 값을 하나 DOMAIN\username 또는 <username>.으로 지정할 수 있습니다. |
옵션
옵션
설명
/version
분기를 만들려는 항목의 버전입니다. 다음을 통해 버전을 지정할 수 있습니다.
- 날짜/시간(D10/20/2005)
- 변경 집합 번호(C1256)
- 레이블(Lmylabel)
- 최신 버전(T)
- 작업 영역(Wworkspacename)
버전이 제공되지 않은 경우 TFVC는 다음 논리를 사용하여 새 분기에 복사할 항목의 버전을 결정합니다.
- Azure DevOps Server 경로가 지정된 경우 TFVC는 항목을 최신 Azure DevOps Server 버전으로 분기합니다. 예를 들어
tf branch $/projects/help.cs서버 버전을 사용합니다. - 원본에 대해 로컬 경로가 지정된 경우 TFVC는 로컬 작업 영역 버전을 사용하여 새 분기를 만듭니다. 예를 들어
tf branch C:\314.cs로컬 작업 영역 버전을 사용합니다.
작업 영역 버전이 Azure DevOps 서버의 최신 버전보다 오래된 파일을 분기하는 경우 파일은 이전 버전에서 분기됩니다.
/lock
보류 중인 분기 및 관련 변경 내용에 검사 때까지 다른 사용자가 항목을 검사 또는 검사 수 없습니다. 자세한 내용은 잠금 유형 이해를 참조 하세요.
잠금 옵션:
none
기본값. 잠금이 적용되지 않습니다. 분기를 만드는 파일에 잠금이 있는 경우 이 옵션을 선택하면 잠금이 제거됩니다.checkin
다른 사용자는 지정된 항목을 검사 수 있지만 검사 수행하여 잠금을 해제할 때까지 잠긴 파일의 수정 버전에서 검사 수 없습니다. 다른 사용자가 지정된 항목 중 하나를 잠근 경우 잠금 작업이 실패합니다.checkout
검사 수행하여 잠금을 해제할 때까지 다른 사용자가 지정된 항목 중 하나를 검사 또는 검사 수 없습니다. 다른 사용자가 지정된 항목 중 하나를 잠근 경우 잠금 작업이 실패합니다.
/noget
이 옵션을 지정하면 새 분기에 있는 파일 및 폴더의 로컬 복사본이 로컬 작업 영역에 만들어지지 않습니다. 그러나 다음에 재귀 가져오기 작업을 수행할 때 로컬 복사본이 작업 영역으로 검색됩니다.
참고 항목
작업 영역 폴더를 은폐하여 재귀 가져오기 및 최신 작업을 수행하는 동안 /images 폴더의 내용과 같은 항목이 작업 영역으로 검색되지 않도록 할 수 있습니다. 자세한 내용은 Workfold 명령을 참조 하세요.
/noprompt
입력에 대한 프롬프트를 표시하지 않습니다.
/silent
분기를 /noget만들 때 명령 프롬프트 창에 출력이 기록되지 않음을 의미하고 지정합니다.
/checkin
분기에서 한 번의 작업으로 서버에 검사 만듭니다. 이 옵션은 로컬 작업 영역에서 보류 중인 변경 내용을 만들지 않습니다.
/comment
새 분기에 주석을 추가합니다. 이 옵션은 옵션과 함께 /checkin 만 사용됩니다.
/author
새 분기의 작성자를 식별합니다. 이 옵션은 옵션과 함께 /checkin 만 사용됩니다.
/recursive
폴더의 경우 내부의 모든 파일도 분기합니다.
설명
c:\00101과 같은 로컬 경로를 지정하지만 지정<versionspec>하지 않으면 TFVC는 새 분기를 만들기 위한 기준으로 로컬 작업 영역 버전을 사용합니다.
그러나 $/00101/*.cs 같은 서버 경로를 지정하고 지정<versionspec>하지 않으면 TFVC는 새 분기를 만들기 위한 기준으로 최신 Azure DevOps Server 버전을 사용합니다.
명령줄 유틸리티를 사용하는 tf 방법에 대한 자세한 내용은 Team Foundation 버전 제어 명령 사용을 참조 하세요.
예제
다음 예제에서는 작업 영역의 기본 폴더에 매핑된다고 c:\projects 가정합니다.
다음 예제에서는 최신 작업 영역 버전의 314.cs 포함된 분기 파일을 만들고, 314_branch 이름을 지정하고, 디스크의 현재 디렉터리와 매핑되는 Azure DevOps Server 폴더에 저장합니다.
c:\projects>tf branch 314.cs 314_branch
다음 예제에서는 현재 Azure DevOps Server 폴더의 314.cs 작업 영역 버전에서 편집을 보류하지 않고 모든 파일을 testdata Azure DevOps Server 폴더로 복사하고 디스크의 현재 디렉터리에서 testdata Azure DevOps Server 폴더에 매핑되는 작업 폴더로 복사합니다.
c:\projects>tf branch C:\314.cs $/testdata
다음은 testfiles 폴더의 현재 작업 영역 버전에서 편집을 보류하지 않고 모든 파일을 복사하고 현재 Azure DevOps Server 폴더의 모든 항목에 대해 포함된 파일을 testfiles_branch Azure DevOps Server 폴더로 복사하고 c:\testfiles에서 testfiles_branch Azure DevOps Server 폴더에 매핑되는 로컬 폴더로 복사합니다.
c:\projects>tf branch C:\testfiles $/testfiles_branch
다음 예제에서는 파일에 대한 변경 집합 #4에 존재했던 314.cs 분기를 만듭니다. Azure DevOps 서버와 같이 디스크의 작업 폴더에서 csharp_branch이라는 분기 파일이 만들어집니다.
c:\projects>tf branch C:\314.cs;C4 csharp_branch
다음 예제에서는 12/12/03에서와 같이 314.cs 새 분기를 만듭니다. Azure DevOps 서버와 같이 디스크의 작업 폴더에서 314\branch라는 분기 파일이 만들어집니다.
c:\projects>tf branch 314.cs;D12/12/03 314_branch
다음 예제에서는 레이블이 적용된 Beta1 314.cs 버전을 분기하고, 이름을 Beta1branch로 지정하고, 현재 디렉터리가 매핑되는 Azure DevOps Server 폴더 외에도 디스크의 현재 디렉터리에 저장합니다.
c:\projects>tf branch 314.cs;LBeta1 314_Beta1branch