다음을 통해 공유


Destroy 명령(Team Foundation 버전 제어)

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

Visual Studio 2019 | Visual Studio 2022

tf destroy 명령을 사용하여 TFVC(Team Foundation 버전 제어)에서 버전 제어 파일을 삭제하거나 영구적으로 삭제합니다.

메모

Azure Devops 내에서 TFVC 리포지토리를 만든 후에는 삭제할 수 없습니다. 명령 tf destroy 버전 제어 파일 또는 폴더만 삭제하거나 영구적으로 삭제하지만 TFVC 리포지토리는 삭제되지 않습니다. 메시지가 삭제된 옵션 목록에 계속 표시됩니다.

경우에 따라 버전 제어 시스템을 정리해야 합니다. 예를 들어 일부 파일이 컴퓨터 바이러스에 감염된 경우 버전 제어에서 영구적으로 제거해야 합니다. 여전히 필요한 파일은 삭제하지 마세요. 삭제 동작은 되돌릴 수 없습니다.

/keephistory 옵션 없이 tf destroy 실행하기 전에 먼저 삭제하려는 파일을 삭제합니다. 자세한 내용은 버전 제어파일 및 폴더 삭제 참조하세요.

파일을 삭제한 후 TFVC 웨어하우스를 동기화할 수 있습니다. 그렇지 않으면 웨어하우스는 소멸된 항목과 동기화되지 않습니다.

필수 구성 요소

destroy 명령을 사용하려면 Team Foundation Administrators 보안 그룹에 속합니다. 자세한 내용은 기본 TFVC 권한참조하세요.

통사론

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 같은 버전을 제공합니다. 허용되는 값은 date, tip또는 특정 변경 집합입니다. TFVC가 버전 사양을 구문 분석하여 범위 내에 있는 항목을 결정하는 방법에 대한 자세한 내용은 Team Foundation 버전 제어 명령 사용을 참조하세요.

<username>

/login 옵션에 값을 제공합니다. username 값을 DOMAIN\username 또는 username지정할 수 있습니다.

TeamProjectCollectionUrl

삭제하려는 파일이 포함된 프로젝트 컬렉션의 URL입니다(예: http://myserver:8080/tfs/DefaultCollection.).

옵션

옵션

설명

/keephistory

선택적. 파일의 내용이 제거되더라도 파일의 기록이 보존되도록 지정합니다. 이 옵션은 /preview 옵션으로 지정할 수 없습니다.

/stopat

선택적. /keephistory 지정한 경우에만 사용할 수 있습니다.

파일의 파일 버전과 그 이후의 파일(기록이 보존되는 파일)을 지정합니다.

/stopat 기본 버전은 항목의 최신 체크 인 버전에 대한 tip(T)입니다.

레이블 또는 작업 영역 versionspec 값을 사용하여 /stopat 옵션에 대한 항목을 지정할 수 없습니다.

/preview

명령 프롬프트 창에서 제거될 파일을 표시합니다. tf destroy 미리 보기 모드에서 실행되면 파일이 실제로 제거되지 않습니다.

메모

명령 프롬프트 창의 텍스트에는 제거될 각 파일과 제거된 단어가 표시됩니다. 그러나 /preview 옵션을 사용하면 파일이 실제로 제거되지 않습니다.

/startcleanup

삭제가 완료된 직후 TFVC 메타데이터 정리 프로세스가 시작되도록 합니다. 사용자가 /startcleanup지정하지 않으면 데이터베이스 유지 관리에서 Azure DevOps Server에서 더 이상 참조하지 않는 모든 파일을 정리할 때 소멸된 메타데이터 정리 프로세스가 발생합니다. 기본적으로 정리는 5일마다 실행되도록 예약됩니다. TFVC 메타데이터가 정리된 지 7일 후 다른 정리 프로세스에 의해 콘텐츠가 삭제됩니다. 기본적으로 이 콘텐츠 정리 프로세스는 매일 한 번씩 실행됩니다.

/noprompt 또는 /i

파일 소멸이 비대화형이 되도록 지정합니다. /i /noprompt별칭입니다.

/silent

파일 또는 폴더를 삭제할 때 출력이 명령 프롬프트 창에 기록되지 않도록 지정합니다.

/login

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

/collection

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

발언

사용하여 버전 제어 파일을 삭제하면 TFVC의 애플리케이션 계층이 삭제 요청을 수신하고 보안 그룹에 Team Foundation Administrators의 구성원인지 확인합니다. 멤버가 아닌 경우 시스템에 작업을 수행할 수 있는 충분한 권한이 없다는 오류 메시지 대화 상자가 표시됩니다.

시스템에서 사용 권한을 확인한 후 destroy 명령을 실행합니다. 이 명령은 모든 파일 참조, 선반 및 보류 중인 변경 내용을 삭제합니다. 영구 삭제인 파일의 실제 소멸은 다음에 Azure DevOps Server에서 더 이상 참조하지 않는 콘텐츠가 정리될 때 발생합니다. tf destroy 실행 직후 파일을 정리하는 /startcleanup 옵션을 지정할 수도 있습니다.

지정하고 지정하지 않고 실행하면 시스템에서 콘솔 표시하거나 각 값에 대한 프롬프트 없음을 표시됩니다. 그렇지 않으면 모든예를 지정할 수 있습니다.

  • /keephistory지정하지 않으면 보류 중인 변경 내용(있는 경우)을 경고하는 대화형 텍스트가 표시됩니다. 대화형 텍스트는 변경 내용에 대한 자세한 정보를 원하는 경우 /preview 가리킵니다.

  • 지정하는 경우 , 없음 또는 모든 텍스트에 예 메시지가 표시됩니다. 선택하거나 모든예 선택하면 소멸 프로세스가 시작되고 제거된 항목에 대한 서버 경로가 명령 프롬프트 창에 표시됩니다.

Destroyed: <serverItem1>
Destroyed: <serverItem2>
Destroyed: ...

versionspec 값을 tip지정한 경우 명령 프롬프트 창에 표시되는 서버 경로에는 삭제 ID가 포함됩니다. 예를 들어 명령 프롬프트 창에 Destroyed: $/Test1/MyProject;X123 나타날 수 있습니다.

/preview 옵션을 사용하는 경우 파일이 제거되지 않지만 명령줄 텍스트에는 제거될 파일이 표시됩니다. 예를 들어 명령줄에 tf destroy /preview $/Test1/MyProject/MyProject/Program.cs 입력하면 명령 창에 다음 텍스트가 표시됩니다.

Destroyed: $/Test1/MyProject/MyProject/Program.cs

그러나 /preview 옵션을 사용했기 때문에 파일이 실제로 제거되지 않습니다.

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

다른 버전 제어 작업에 대한 /keephistory의 효과

제거된 파일의 기록을 유지하는 /keephistory 옵션을 지정하면 파일은 다음 TFVC 작업에 의해 제거된 것으로 처리됩니다.

  • 콘텐츠변경합니다. 제거된 파일의 콘텐츠(예: 편집 또는 분기)를 변경하려고 하면 시스템에서 콘텐츠가 삭제되었음을 나타내는 오류 메시지를 실행합니다.

  • 분기, 병합 또는. 제거된 항목을 분기, 병합 또는 해제하려고 하면 시스템에서 항목의 내용이 삭제되었음을 나타내는 오류 메시지를 발생합니다.

이전에 삭제한 항목 삭제

항목이 이미 삭제된 경우 삭제 ID가 해당 항목에 연결되고 파일 이름이 변경됩니다.

코드 검색은 tf destroy 알림을 처리하지 않으므로 TFVC 리포지토리에 tf destroy 사용하면 검색 인덱스에서 파일이 자동으로 삭제되지 않습니다. 결과적으로 이러한 파일은 코드 검색 결과에 표시됩니다. 이러한 고스트 파일 시나리오를 방지하려면 tf destroy 작업 전에 파일을 삭제합니다.

예제

다음 예제에서는 a.cs파일을 영구적으로 삭제합니다.

tf destroy $/proj/pi/a.cs

다음 예제에서는 폴더를 삭제하고 aFolder.

tf delete $/MyTeamProject/aFolder

aFolder삭제된 항목을 삭제하려면 명령줄에 다음을 입력합니다.

tf destroy $/MyTeamProject/aFolder;x123

여기서 x123 삭제 ID입니다.

  • 버전 제어 파일 삭제
  • tf 명령줄만 사용할 수 있는 작업