Destroy 명령(Team Foundation 버전 제어)
tf destroy 명령을 사용하면 Team Foundation 버전 제어에서 버전 제어 파일을 제거하거나 영구적으로 삭제할 수 있습니다.
제거 작업은 취소할 수 없으므로 필요한 파일은 제거하지 않아야 합니다. 때에 따라서는 버전 제어 시스템을 정리해야 할 경우가 있습니다. 예를 들어 파일 중 일부가 컴퓨터 바이러스에 감염된 경우에는 해당 파일을 버전 제어에서 영구적으로 제거해야 합니다.
/keephistory 옵션을 사용하지 않고 tf destroy를 실행하는 경우 먼저 제거할 파일을 삭제하는 것이 좋습니다. 자세한 내용은 버전 제어에서 파일 및 폴더 삭제을 참조하십시오.
파일을 삭제하고 나면 Team Foundation 웨어하우스를 동기화할 수 있습니다. 그렇지 않으면 웨어하우스가 제거된 항목으로 동기화되지 않습니다.
필요한 권한
destroy 명령을 사용하려면 Team Foundation Administrators 보안 그룹에 속해 있어야 합니다. 자세한 내용은 Team Foundation Server 권한을 참조하십시오.
tf destroy [/keephistory] <itemspec1>[;<versionspec>][<itemspec2>...<itemspecN>]
[/stopat:<versionspec>] [/preview] [/startcleanup] [/noprompt] [/silent] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]]
매개 변수
인수 |
설명 |
|---|---|
itemspec1 [itemspec2…itemspecN] |
제거할 파일 또는 폴더의 서버 경로를 지정합니다. 여러 항목을 삭제하려면 itemspec 값을 여러 개 사용합니다. 예를 들어, tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3을 입력합니다. 로컬 경로는 지원되지 않습니다. |
versionspec |
/keephistory 또는 /stopat 옵션에 C58 같은 버전을 제공합니다. 사용할 수 있는 값은 날짜, 팁 또는 특정 변경 집합입니다. Team Foundation에서 버전 사양을 구문 분석하여 범위 내에 있는 항목을 결정하는 자세한 방법은 명령줄 구문(버전 제어)을 참조하십시오. |
username |
/login 옵션에 값을 제공합니다. 사용자 이름 값을 DOMAIN\UserName 또는 UserName으로 지정할 수 있습니다. |
TeamProjectCollectionUrl |
삭제할 파일을 포함하는 팀 프로젝트 컬렉션의 URL입니다(예: http://myserver:8080/tfs/DefaultCollection). |
Option |
설명 |
|---|---|
/keephistory |
선택적 요소로서, 파일에 대한 사용 기록을 보존하도록 지정하며 파일 내용이 제거된 경우에도 해당됩니다. /preview 옵션과 함께 지정할 수 없습니다. |
/stopat |
선택적 요소로서, /keephistory도 함께 지정한 경우에만 사용할 수 있습니다. 기록이 유지되는 파일 및 후속 파일의 파일 버전을 지정합니다. 항목의 마지막으로 체크 인한 버전의 경우 /stopat의 기본 버전은 팁(T)입니다. 레이블 또는 작업 영역 versionspec 값을 사용하여 /stopat 옵션에 항목을 지정할 수 없습니다. |
/preview |
제거될 파일을 명령 프롬프트 창에 표시합니다. tf destroy를 미리 보기 모드에서 실행하는 경우 실제로는 파일이 제거되지 않습니다. .gif "참고") 참고
명령 프롬프트 창에서는 제거될 각 파일에 대해 "제거됨"이라는 텍스트가 표시됩니다.하지만 /preview 옵션을 사용하는 경우 실제로는 파일이 제거되지 않습니다.
|
/startcleanup |
내용 삭제가 끝나는 즉시 파일 내용 정리 프로세스가 시작되도록 합니다. /startcleanup을 지정하지 않은 경우에는 데이터베이스 유지 관리 작업의 일환으로 Visual Studio Team Foundation Server에서 더 이상 참조하지 않는 모든 파일을 정리할 때 이러한 제거된 내용 정리 프로세스가 수행됩니다. 정리 작업은 기본적으로 매일 한 번씩 실행되도록 예약됩니다. |
/noprompt /i |
파일 제거 작업을 상호 작용하지 않는 작업으로 지정합니다. /i는 /noprompt의 별칭입니다. |
/silent |
파일이나 폴더를 삭제할 때 출력이 명령 프롬프트 창에 쓰여지지 않도록 지정합니다. |
/login |
Team Foundation Server에서 사용자를 인증할 사용자 이름과 암호를 지정합니다. |
/collection |
팀 프로젝트 컬렉션을 지정합니다. |
설명
tf destroy를 사용하여 버전 제어 파일을 제거하려고 하면 Team Foundation Server 응용 프로그램 계층에서 제거 요청을 수신한 후 사용자가 Team Foundation Administrators 보안 그룹의 멤버인지 확인합니다. 사용자가 이 그룹의 멤버가 아니면 해당 작업을 수행하는 데 필요한 충분한 권한이 없음을 알려 주는 오류 메시지 대화 상자가 표시됩니다.
권한 확인 작업이 끝나면 destroy 명령이 실행됩니다. 이 명령은 모든 파일 참조, 보류 집합 및 보류 중인 변경 내용을 삭제합니다. 파일이 영구적으로 삭제되는 실제 파일 제거 작업은 다음 번에 Team Foundation Server에서 더 이상 참조하지 않는 내용을 정리할 때 수행됩니다. /startcleanup 옵션을 지정하여 tf destroy를 실행한 후 곧바로 파일을 정리할 수도 있습니다.
/i 및 /preview를 지정하지 않고 tf destroy를 실행하면 각 filespec 값에 대해 Yes 또는 No 프롬프트가 표시됩니다. 그렇지 않은 경우에는 Yes to all을 지정할 수 있습니다. /keephistory를 지정하지 않은 경우 보류 중인 변경 내용이 있으면 이에 대해 알려 주는 대화형 텍스트가 표시됩니다. 변경 내용에 대한 자세한 내용을 볼 수 있도록 이 대화형 텍스트는 /preview를 가리킵니다. /keephistory를 지정한 경우에도 Yes, No 또는 All 텍스트가 표시됩니다. Yes나 All을 선택하면 제거 프로세스가 시작되고 제거된 항목에 대한 서버 경로가 명령 프롬프트 창에 나타납니다.
Destroyed: <serverItem1>
Destroyed: <serverItem2>
Destroyed: ...
versionspec 값을 팁으로 지정하면 명령 프롬프트 창에 표시되는 서버 경로에 삭제 ID가 포함됩니다. 예를 들면 명령 프롬프트 창에 X123과 같이 나타날 수 있습니다.
/preview 옵션을 사용하는 경우 실제로는 파일이 제거되지 않지만 명령줄 텍스트에는 파일이 제거되는 것으로 표시됩니다. 예를 들어 명령줄에서 tf destroy /preview $/Test1/MyProject/MyProject/Program.cs를 입력하면 명령 창에 다음 텍스트가 표시됩니다.
제거됨: $/Test1/MyProject/MyProject/Program.cs
하지만 /preview 옵션을 사용했으므로 실제로는 파일이 제거되지 않았습니다.
tf 명령줄 유틸리티를 찾는 방법에 대한 자세한 내용은 Tf 명령줄 유틸리티 명령을 참조하십시오.
/keephistory가 다른 버전 제어 작업에 주는 영향
제거된 파일에 대한 사용 기록을 보존하기 위해 /keephistory 옵션을 지정한 경우 다음 Team Foundation 버전 제어 작업에서는 파일이 제거된 것으로 처리됩니다.
**내용 변경 **파일 내용을 편집하거나 분기하는 등 제거된 파일의 내용을 변경하려고 하면 내용이 제거되었음을 알려 주는 오류 메시지가 표시됩니다.
**분기, 병합 또는 복원 **제거된 항목을 분기, 병합 또는 복원하려고 하면 항목의 내용이 제거되었음을 알려 주는 오류 메시지가 표시됩니다.
이전에 삭제된 항목 제거
항목이 이미 삭제된 경우 해당 항목에 삭제 ID가 연결되어 파일 이름이 변경됩니다.
예제
설명
다음 예제에서는 a.cs라는 파일을 영구적으로 삭제합니다.
코드
C:\pi\ws1>tf destroy $/proj/pi/a.cs
설명
다음 예제에서는 명령줄에 다음과 같이 입력하여 aFolder라는 폴더를 삭제합니다.
코드
C:\tf delete $/MyTeamProject/aFolder
설명
삭제된 항목 aFolder를 제거하려면 명령줄에 다음과 같이 입력해야 합니다.
코드
tf destroy $/MyTeamProject/sFolder;x123
여기서 x123은 삭제 ID입니다.
참고 항목
작업
개념
명령줄에서만 사용 가능한 작업(Team Foundation 버전 제어)