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 관리istrators 보안 그룹에 속해야 합니다. 자세한 내용은 기본 TFVC 권한을 참조 하세요.

구문

tf destroy [/keephistory] <itemspec1>[;<versionspec>][<itemspec2>...<itemspecN>] 
[/stopat:<versionspec>] [/preview] [/startcleanup] [/noprompt] [/silent] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]]

매개 변수

인수

Argument

설명

<itemspec1> [<itemspec2>...<itemspecN>]

제거할 파일 또는 폴더의 서버 경로를 지정합니다. 여러 itemspec 값을 사용하여 여러 항목을 삭제합니다. 예들 들어 tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3입니다.

로컬 경로는 지원되지 않습니다.

<versionspec>

또는 /stopat 옵션과 같은 C58/keephistory 버전을 제공합니다. 허용되는 값은 date또는 tip특정 변경 집합입니다. TFVC가 버전 사양을 구문 분석하여 범위 내에 있는 항목을 결정하는 방법에 대한 자세한 내용은 Team Foundation 버전 제어 명령 사용을 참조 하세요.

<username>

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

TeamProjectCollectionUrl

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

옵션

옵션

설명

/keephistory

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

/stopat

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

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

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

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

/preview

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

참고 항목

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

/startcleanup

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

/noprompt 또는 /i

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

/silent

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

/login

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

/collection

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

설명

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

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

지정 /preview/i 하지 않고 실행 tf destroy 하면 시스템에서 각 filespec 값에 대한 콘솔 예 또는 아니요 프롬프트를 표시합니다. 그렇지 않으면 모두에 예를 지정할 수 있습니다.

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

  • 지정 /keephistory하는 경우 모든 텍스트에 예, 아니요 또는 예라는 메시지가 표시됩니다. Yes 또는 Yes to All을 선택하면 소멸 프로세스가 시작되고 소멸된 항목에 대한 서버 경로가 명령 프롬프트 창에 표시됩니다.

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

값을 지정 versionspectip한 경우 명령 프롬프트 창에 표시되는 서버 경로에는 삭제 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입니다.