다음을 통해 공유


분기 명령(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 서버에 반영되지 않습니다. 자세한 내용은 팀의 코드베이스작업 체크 인을 참조하세요.

필수 구성 요소

명령을 사용하려면 원본 항목에 대한 읽기 권한을 가지며, 체크 아웃하고 대상 폴더에 대한 병합 권한을 허용으로 설정합니다. 자세한 내용은 기본 TFVC 권한참조하세요.

통사론

tf branch olditem newitem [/version:versionspec] [/noget] [/lock:(none|checkin|checkout)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]] [/recursive]

매개 변수

논쟁

인수 설명
<olditem> 분기할 원본 파일 또는 폴더의 이름을 지정합니다. <olditem> item;version형식의 버전 정보를 포함할 수도 있습니다.
<newitem> 대상 파일 또는 폴더의 이름 또는 대상의 부모 폴더를 지정합니다. <*newitem> 이미 있고 Azure DevOps Server 폴더인 경우 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

다음 예제에서는 현재 테스트 파일 폴더의 현재 작업 영역 버전에서 편집을 보류하지 않고 모든 파일을 복사하고 현재 Azure DevOps Server 폴더의 모든 항목에 대해 포함된 파일을 testfiles_branch Azure DevOps Server 폴더로 복사하고 c:\testfilestestfiles_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

다음은 레이블이 적용된 314.cs 버전을 분기하고, 이름을 Beta1branch이름을 지정하고, 현재 디렉터리가 매핑되는 Azure DevOps Server 폴더 외에 디스크의 현재 디렉터리에 저장하는 예제입니다.

c:\projects>tf branch 314.cs;LBeta1 314_Beta1branch