Rename 명령(Team Foundation 버전 제어)

업데이트: 2007년 11월

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

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

필요한 권한

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

tf rename [/lock:(none|checkout|checkin)] olditem newitem

매개 변수

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

옵션	설명
/lock	다른 사용자가 지정된 항목을 체크 인 또는 체크 아웃하지 못하게 하려면 이 옵션을 포함합니다. 이 옵션을 지정하지 않을 경우 항목의 기존 잠금 상태가 변경되지 않습니다. 자세한 내용은 잠금 형식 이해를 참조하십시오. 잠금 옵션 none   잠금이 적용되지 않습니다. checkin   체크 인을 수행하여 잠금을 해제할 때까지 다른 사용자는 지정한 항목을 체크 아웃할 수 있지만 잠긴 파일에 수정 버전을 체크 인할 수 없습니다. 다른 사용자가 지정한 항목 중 하나를 잠근 경우 잠금 작업이 실패합니다. checkout   체크 인을 수행하여 잠금을 해제할 때까지 다른 사용자는 지정한 항목을 체크 인 또는 체크 아웃할 수 없습니다. 다른 사용자가 지정한 항목 중 하나를 잠근 경우 잠금 작업이 실패합니다.

설명

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

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

• olditem의 이름을 newitem으로 바꿉니다(예: tf rename 314.cs 315.cs).

• 해당 경로에 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

참고 항목

작업

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

개념

잠금 형식 이해

보류 중인 변경 내용

참조

명령줄 구문(Team System)

Add 명령

Delete 명령(Team Foundation 버전 제어)

Get 명령

기타 리소스

Tf 명령줄 유틸리티 명령