共用方式為


刪除版本控制的檔案

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 Administrators 安全組的成員。 如需詳細資訊,請參閱 預設 TFVC 權限

  • 在您執行 tf destroy 而不使用 [/keephistory] 選項之前,請先刪除您想要終結的檔案。 如需詳細資訊,請參閱 從版本控制中刪除檔案和資料夾。 刪除檔案之後,其檔名現在會包含刪除標識碼。 例如,如果檔名是 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 中的 原始檔控制總管 檢視歷史記錄。 如需詳細資訊,請參閱 History 命令取得項目記錄

  • 使用 [/stopat] 選項,將歷程記錄資訊保留到 versionspec 值為止。 versionspec 值可以是最新版本、特定變更集或日期。 如需 versionspec 值的詳細資訊,請參閱 使用 Team Foundation 版本控制命令

    若要刪除專案 MyTeamProject 中的所有檔案,並同時保留截至且包含 2005 年 10 月 23 日的檔案歷程記錄,請輸入:

    tf destroy $/MyTeamProject /keephistory /stopat:D10/23/2005
    
  • 使用 [/startcleanup] 選項,立即清除 Azure DevOps Server 不再參考之檔案的 TFVC 元數據。 如果沒有此選項,當資料庫由每五天執行的 SQL 進程維護時,就會移除這些元數據。 在刪除 TFVC 元數據七天后,另一個 SQL 進程將會刪除終結檔案的內容。

    若要立即終結 aFolder中的所有檔案,請輸入:

    tf destroy /startcleanup $/MyTeamProject/aFolder