Rename 명령(Team Foundation 버전 제어)

rename 명령은 파일이나 폴더의 이름 또는 경로를 변경합니다. rename 명령, 별칭 move 또는 ren을 사용하여 파일이나 폴더를 새 위치로 이동할 수 있습니다.

참고

   이 명령의 결과는 체크 인 작업을 수행할 때까지 Team Foundation 버전 제어 서버에 반영되지 않습니다. 자세한 내용은 보류 중인 변경 내용 체크 인을 참조하십시오.

필요한 권한

rename 명령을 사용하려면 체크 아웃 권한이 허용으로 설정되어 있어야 합니다. 자세한 내용은 Team Foundation Server 권한을 참조하십시오.

tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem

매개 변수

인수

설명

olditem

이름을 바꾸려는 파일 또는 폴더의 원래 이름과 경로입니다. 로컬 작업 영역 경로(예: C:\myfiles\314.cs) 또는 Team Foundation 버전 제어 서버 경로(예: $/myfiles/314.cs)를 지정할 수 있습니다.

newitem

파일 또는 폴더의 새 이름입니다. 이 이름을 사용하여 다른 로컬 또는 Team Foundation 버전 제어 서버 경로의 위치를 지정할 수 있습니다.

username

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

Option

설명

/lock

다른 사용자가 지정된 항목을 체크 인 또는 체크 아웃하지 못하게 하려면 이 옵션을 포함합니다. 이 옵션을 지정하지 않을 경우 항목의 기존 잠금 상태가 변경되지 않습니다. 자세한 내용은 잠금 형식 이해을 참조하십시오.

잠금 옵션

  • none   잠금이 적용되지 않습니다.

  • 체크 인   체크 인을 수행하여 잠금을 해제할 때까지 다른 사용자는 지정한 항목을 체크 아웃할 수 있지만 잠긴 파일의 수정 버전을 체크 인할 수 없습니다. 다른 사용자가 지정한 항목 중 하나를 잠근 경우 잠금 작업이 실패합니다.

  • 체크 아웃   체크 인을 수행하여 잠금을 해제할 때까지 다른 사용자는 지정한 항목 중 하나를 체크 인 또는 체크 아웃할 수 없습니다. 다른 사용자가 지정한 항목 중 하나를 잠근 경우 잠금 작업이 실패합니다.

/login

Visual Studio Team Foundation Server에서 사용자를 인증할 사용자 이름과 암호를 지정합니다.

설명

tf 명령줄 유틸리티의 rename 명령을 사용하여 작업 영역의 버전 제어 항목을 이동하거나 이름을 바꿀 수 있습니다. 여러 개의 파일을 이동하려면 rename 명령에 와일드카드 문자를 지정하여 사용합니다. 여러 개의 버전 제어 파일이나 폴더의 이름을 바꾸는 작업은 명령줄에서만 수행할 수 있습니다.

Rename을 사용하여 다음 작업을 수행할 수 있습니다.

  • olditem의 이름을 tf rename 314.cs 315.cs 같은 newitem으로 바꿉니다.

  • 해당 경로에 olditem의 경로와 다른 newitem을 제공하여 Team Foundation 버전 제어 서버의 새 위치로 olditem을 이동합니다(예:  tf rename 314.cs ..\newdir\314.cs).

존재하지 않는 폴더를 지정하는 newitem을 제공할 경우 rename 명령은 대상 폴더를 만듭니다. newitem이 폴더인 경우 olditem은 newitem의 자식이 됩니다.

다음 경우에는 항목의 이름을 바꿀 수 없습니다.

  • 동일한 작업 영역에 체크 인하기 전에 항목을 이미 삭제했습니다.

  • 새 이름이 이미 Team Foundation 버전 제어 서버에 존재하며 폴더가 아닙니다.

  • 보류 중인 체크 인 항목을 이미 추가했거나, 분기했거나, 이름을 변경했습니다.

  • 항목이 작업 영역에서 매핑되지만 로컬 디스크에서 사용할 수 없습니다.

  • 항목이 숨겨졌습니다.

같은 이름의 다른 파일이 보류 중인 체크 인을 추가한 항목의 이름을 바꿀 수 있습니다. 그러나 분기되었지만 체크 인되지 않은 항목의 이름은 바꿀 수 없습니다. 보류 중인 편집 내용이 있는 파일의 이름을 바꾸면 편집 내용이 유지됩니다.

명시적으로 매핑된 항목의 경우 먼저 매핑을 변경해야만 이름을 바꿀 수 있습니다. 예를 들어, $/ProjectX/MyApp을 c:\MyApp으로 매핑하는 작업 폴더가 있는 경우 MyApp의 이름을 바꿀 수 없습니다. MyApp에 있는 항목은 이름을 바꿀 수 있지만 MyApp 자체는 이름을 바꿀 수 없습니다.

tf 명령줄 유틸리티를 검색하는 방법에 대한 자세한 내용은 Tf 명령줄 유틸리티 명령을 참조하십시오.

예제

다음 예제에서는 314.c의 이름을 1254.c로 변경합니다.

c:\projects>tf rename  314.c  1254.c

다음 예제에서는 314.c의 이름을 1254.c로 바꾸고 newdir 폴더로 이동합니다.

c:\projects>tf rename 314.c ..\newdir\1254.c

다음 예제에서는 Form1.vb의 이름을 MainPage.vb로 바꾸고 잠금을 적용합니다.

c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin

참고 항목

작업

버전 제어 파일과 폴더 이동, 이름 바꾸기 및 삭제

참조

명령줄 구문(버전 제어)

Add 명령

Delete 명령(Team Foundation 버전 제어)

Get 명령

개념

잠금 형식 이해

보류 중인 변경 내용

기타 리소스

Tf 명령줄 유틸리티 명령