終結版本控制的檔案
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
一段時間后，版本控制伺服器會取得越來越多的檔案和資料夾。 當您嘗試管理磁碟空間需求時，這可能會造成問題。 您可能被迫從版本控制中移除所有專案及其階層。 例如，專案可能僅供學習之用，或某些檔案受到病毒污染。 因此，身為 TFVC 系統管理員，有時候您可能必須終結版本控制下的檔案和資料夾。
下列程式示範如何使用 命令終結檔案和資料夾 tf destroy 。 雖然檔案已永久移除，但您可以保留與其相關聯的歷程記錄。 如需 可用tf destroy選項和自變數的詳細資訊，請參閱 Destroy 命令 （Team Foundation 版本控制）。
注意
作業 destroy 只能從命令行取得。
必要條件
若要使用
destroy命令，您必須是Team Foundation 管理員 istrators 安全組的成員。 如需詳細資訊，請參閱 預設 TFVC 許可權。在不使用
/keephistory選項執行tf destroy之前，請先刪除您想要終結的檔案。 如需詳細資訊，請參閱 從版本控制中刪除檔案和資料夾。 刪除檔案之後，其檔名現在會包含刪除標識碼。 例如，如果檔名aFile.cs，則刪除后的檔名aFile.cs;x123，其中 x123 是刪除標識符。刪除檔案之後，您可以同步處理 TFVC 倉儲。 否則，倉儲將不會與已終結的專案同步處理。
永久終結版本控制的檔案
在 Windows 中，選取 [ 啟動 ]，然後輸入 開發人員命令提示字元。 從搜尋結果中，選取 Visual Studio 版本的開發人員命令提示字元，例如 Visual Studio 2022 的開發人員命令提示字元。
若要預覽終結檔案 aFile.cs 而不終結檔案，請在命令提示字元中輸入 ：
tf destroy /preview /i $/MyTeamProject/aFile.cs注意
命令提示字元視窗中的文字會顯示
Destroyed: $/MyTeamProject/aFile.cs，但是當您使用/preview選項時，檔案實際上不會終結。若要終結檔案 aFile.cs，請在命令提示字元中輸入 ：
tf destroy /i $/MyTeamProject/aFile.cs此命令會顯示命令提示字元視窗中可能的擱置變更和擱置集的相關信息。 如果您指定
/i或非互動式，在永久移除檔案之前，系統不會提示您輸入 [是]、 [否] 或 [全部 ] 對話框。若要終結 aFolder 中的所有檔案，同時保留其歷程記錄，請輸入：
tf destroy /keephistory $/MyTeamProject/aFolder注意
您無法使用
/keephistory指定 。/preview此動作會保留 aFolder 中所有檔案的歷程記錄資訊。 您可以使用
tf history命令來檢視檔案的歷程記錄。 您也可以在 Visual Studio 中的原始檔控制總管中檢視歷程記錄。 如需詳細資訊，請參閱 記錄命令 和 取得專案的歷程記錄。/stopat使用 選項，將歷程記錄資訊保留至 和 包含versionspec值。 此值versionspec可以是最新版本、特定變更集或日期。 如需值的詳細資訊versionspec，請參閱 使用Team Foundation版本控制命令。若要終結專案 MyTeamProject 中的所有檔案，並同時保留檔案的歷程記錄，最多且包含 10/23/2005，請輸入：
tf destroy $/MyTeamProject /keephistory /stopat:D10/23/2005/startcleanup使用 選項，立即清除 Azure DevOps Server 不再參考之檔案的 TFVC 元數據。 如果沒有此選項，當資料庫由每五天執行的 SQL 進程維護時，就會移除這些元數據。 在刪除 TFVC 元數據七天后，另一個 SQL 進程將會刪除終結檔案的內容。若要立即終結 aFolder 中的所有檔案，請輸入：
tf destroy /startcleanup $/MyTeamProject/aFolder