다음을 통해 공유


레이블 명령(Team Foundation 버전 제어)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

TFVC(Team Foundation 버전 제어) tf label 명령은 TFVC 서버의 파일 또는 폴더 버전에서 레이블을 연결하거나 제거합니다.

필수 조건

label 명령을 사용하려면 레이블 사용 권한이 허용으로 설정되어 있어야 합니다. 다른 사용자가 만든 레이블을 수정하거나 삭제하려면 관리 레이블 등록 권한이 허용으로 설정되어 있어야 합니다. 자세한 내용은 기본 TFVC 권한을 참조 하세요.

구문

tf label labelname[@scope] [/owner:ownername] 
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)] 
[/child:(replace|merge)] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]	
tf label /delete labelname[@scope] 
itemspec [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

매개 변수

인수

Argument

설명

<labelname>

지정된 항목에서 연결, 수정 또는 제거할 레이블의 이름을 식별합니다.

@<scope>

고유한 TFVC 서버 디렉터리를 labelname 지정합니다. 이 매개 변수를 사용하면 동일한 이름의 두 레이블이 TFVC 서버의 서로 다른 부분에 있는 경우 레이블이 지정된 항목 집합을 독립적으로 만들고, 관리하고, 검색하고, 삭제할 수 있습니다.

<ownername>

옵션과 같은 DOMAIN\JuanGojuango/owner 값을 제공합니다.

<itemspec>

레이블을 지정하거나 레이블을 다시 지정하거나 수정할 파일 또는 폴더를 식별합니다. TFVC가 구문 분석 itemspec 하여 범위 내에 있는 항목을 확인하는 방법에 대한 자세한 내용은 Team Foundation 버전 제어 명령 사용을 참조 하세요.

참고 항목

itemspec 이상의 인수를 지정할 수 있습니다.

<versionspec>

옵션과 같은 c2/version 값을 제공합니다. TFVC가 버전 사양을 구문 분석하여 범위 내에 있는 항목을 결정하는 방법에 대한 자세한 내용은 Team Foundation 버전 제어 명령 사용을 참조 하세요.

<comment>

레이블에 대한 사용자가 제공한 주석입니다.

@<commentfile>

레이블에 사용할 주석이 포함된 디스크에 있는 파일의 사용자 제공 경로입니다.

<username>

옵션에 값을 /login 제공합니다. 사용자 이름 값을 하나 DOMAIN\username 또는 username.으로 지정할 수 있습니다.

<TeamProjectCollectionUrl>

레이블 http://myserver:8080/tfs/DefaultCollection을 첨부하거나 레이블을 삭제하려는 파일 또는 폴더의 버전을 포함하는 지정된 프로젝트 컬렉션의 URL입니다.

옵션

옵션

설명

/owner

레이블을 소유한 사용자의 이름을 지정합니다.

/version

선택 사항. 레이블을 연결, 수정 또는 제거할 파일 또는 폴더의 버전을 지정합니다. 다음은 변경 집합 값입니다(예: .) C93. 기본적으로 TFVC는 제공되지 않은 versionspec 경우 기본 작업 영역 버전을 사용합니다.

/comment

레이블에 대한 설명 또는 주석을 추가하거나 수정합니다.

/child

문서화되지 않았습니다.

/recursive

사용자와 일치하는 itemspec 디렉터리의 모든 항목에 레이블을 지정합니다 versionspec. 옵션과 함께 /delete 사용할 수 없습니다.

/delete

레이블을 제거합니다.

/login

Azure DevOps를 사용하여 사용자를 인증할 사용자 이름과 암호를 지정합니다.

/collection

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

설명

레이블은 TFVC 서버에서 관련이 없는 파일 및 폴더 집합에 연결할 수 있는 표식입니다. 레이블을 사용하여 개발 또는 빌드를 위해 작업 영역으로 파일 및 폴더 검색을 간소화합니다. 레이블은 파일 및 폴더를 임의로 추가 및 제거하거나 해당 항목의 버전을 변경할 수 있는 변경 집합 또는 날짜/시간과 같습니다. 레이블은 다음 TFVC 명령에 전달할 수 있는 버전 사양입니다.

레이블의 일반적인 유형은 중요 시점 레이블(예: M1, Beta2또는 Release Candidate 0)입니다.

레이블은 버전별로 다릅니다. 즉, 한 버전의 파일 또는 폴더에만 레이블을 연결할 수 있습니다. 항목의 각 버전은 여러 레이블을 지원할 수 있습니다.

레이블은 버전이 지정된 개체가 아닙니다. 따라서 파일의 레이블 기록은 추적되지 않습니다. 또한 레이블 작업은 작업 영역에서 보류 중인 변경 내용을 만들지 않습니다. 명령을 실행 label 하면 업데이트가 TFVC 서버에 즉시 반영됩니다.

명령줄 유틸리티를 사용하는 tf 방법에 대한 자세한 내용은 Team Foundation 버전 제어 명령 사용을 참조 하세요.

레이블 제거 및 삭제

레이블 해제 명령을 사용하여 파일 또는 폴더에서 레이블을 제거할 수 있습니다. 또는 명령을 사용하여 시스템에서 레이블을 삭제할 tf label /delete 수 있습니다.

레이블이 첨부된 항목 목록, 해당 주석, 범위 및 소유자가 포함된 기존 레이블에 대한 자세한 내용은 레이블 명령을 참조하세요.

오버로드된 레이블 관리

레이블 이름은 지정된 범위 전체에서 고유해야 합니다. 레이블을 추가할 때 지정된 범위 또는 묵시적 범위에서 해당 레이블 이름을 사용하도록 예약합니다. 매개 변수의 @scope 기본값은 프로젝트(예 : $/TeamProject1)입니다.

다른 팀 또는 사용자가 TFVC 서버의 다른 부분에 있는 버전 제어 파일 집합과 같은 M3 공통 레이블을 추가하는 경우 루트 프로젝트 폴더가 다른 디렉터리에 있는 한 프로젝트의 버전 제어 파일에 레이블을 적용 M3 할 수 있습니다. 예를 들어 $/math 디렉터리의 파일에 레이블M3이 지정된 경우 $/projects 디렉터리의 파일에 레이블을 적용 M3 할 수도 있습니다.

레이블을 가져오거나 제거하거나 레이블이 지정된 항목을 관리M3하려면 작업할 레이블을 TFVC M3 에 알리는 매개 변수를 지정 @scope 해야 합니다.

Team Foundation 버전 제어 서버의 루트 $/ 에 레이블을 만들거나 특정 폴더에 대한 레이블 권한을 조정하여 TFVC 서버의 다른 부분과 같은 M3 레이블을 "오버로드"하지 못하도록 할 수 있습니다.

예제

다음 예제에서는 docs goodbuild 폴더의 작업 영역 버전과 레이블에 포함된 파일 및 폴더에 레이블을 연결합니다.

c:\projects>tf label goodbuild docs /recursive

다음 예제에서는 docs goodbuild 폴더에 레이블을 연결하지만 docs 폴더에 포함된 파일 및 폴더에는 연결하지 않습니다.

c:\projects>tf label goodbuild docs

다음 예제에서는 TFVC 서버의 314.cs 버전 3에 레이블을 연결 goodbuild 합니다.

c:\projects>tf label goodbuild /version:3 $/src/314.cs

다음 예제에서는 TFVC 서버의 badbuild 모든 항목에서 레이블을 삭제합니다.

c:\projects>tf label /delete badbuild

다음 예제에서는 범위 옵션을 사용하여 @ 314.cs 레이블을 적용합니다.

c:\projects>tf label goodbuild@$/TeamProject1 314.cs