Delete 命令 (Team Foundation 版本控制)

從 Team Foundation 版本控制伺服器移除檔案和資料夾,並將它們從磁碟刪除。

注意事項注意事項

   在執行簽入作業後,這個命令的結果才會顯示在其他工作區中。 如需詳細資訊,請參閱 簽入暫止的變更

必要的使用權限

若要使用 delete 命令,您必須將 [簽出] 權限設定為 [允許]。 如果加入 /lock 選項並使用 none 以外的值,您必須將 [鎖定] 權限設定為 [允許]。 此外,您必須擁有該工作區或將全域 [管理工作區] 權限設定為 [允許]。 如需詳細資訊,請參閱Team Foundation Server 使用權限

tf delete [/lock:(none|checkin|checkout)] [/recursive] [/login:username,[password]] itemspec

參數

引數

描述

itemspec

辨別要從 Team Foundation 版本控制伺服器刪除的檔案或資料夾。 如需 Team Foundation 如何剖析項目規格以判斷哪些項目位於範圍內的詳細資訊,請參閱命令列選項

注意事項注意事項
您可以指定一個以上的 Itemspec 引數。

username

提供 /login 選項的值。 您可以將使用者名稱值指定成網域\ 使用者名稱或使用者名稱的格式。

選項

描述

/lock

避免其他使用者簽入或簽出指定的項目。 如需詳細資訊,請參閱認識鎖定類型

鎖定選項:

  • None

    預設值。 沒有套用任何鎖定。 如果已在指定檔案上放置鎖定,這個選項就會移除該鎖定, 但是不會移除由其他人放置的鎖定。

  • Checkin

    其他使用者可以簽出指定的項目,但除非執行簽入來解除鎖定,否則他們無法將修訂簽入鎖定的檔案。 如果有任何其他的使用者鎖定了任一指定的項目,鎖定作業就會失敗。

  • Checkout

    防止其他使用者簽入或簽出任何指定的項目,直到您執行簽入以釋放鎖定為止。 如果有任何其他的使用者鎖定了任一指定的項目,鎖定作業就會失敗。

/recursive

刪除指定目錄中符合項目規格之所有檔案和 (或) 資料夾及子資料夾。

  • tf delete folder1\folder2 /recursive (其中 folder1\folder2 存在且為目錄) 會刪除 folder1\folder2 本身和 folder1\folder2 中的所有檔案和子目錄。

  • tf delete folder1\folder2\filespec* /recursive 會刪除 folder1\folder2 及其所有子目錄中符合檔案規格之所有檔案和子目錄,以及符合檔案規格之任何目錄中的所有檔案和子目錄。

    例如,某個工作區內含:

    Folder1\AVeryLongDirectoryName (其中內含某些檔案) 和 Folder1\Folder2\AVeryImportantFile.txt。

    tf delete 'Folder1\AVer*' /recursive

    刪除 folder1\folder2\NeverDelete\AVeryImportantFile.txt,因為其符合萬用字元 (Wildcard Character)。

/login

指定使用者名稱和密碼,以便透過 Visual Studio Team Foundation Server 驗證使用者。

備註

delete 命令會在工作區內針對指定的項目,記錄「刪除」類型的暫止變更。 當您藉由使用 ** checkin** 命令,將「刪除」類型的暫止變更認可到 Team Foundation 版本控制伺服器時,Team Foundation 會將項目從 Team Foundation 版本控制伺服器移除,但不會永久刪除。 您可以藉由使用 Dir 命令在 Team Foundation 版本控制伺服器中找到刪除的項目,然後使用 Undelete 命令還原刪除的項目。

如果已從工作區中刪除某項目,但尚未簽入該項變更,可以將項目還原到工作區,然後使用 Undo 命令從暫止變更清單移除該項刪除。

您無法刪除有其他暫止變更存在的項目。 例如,簽出的檔案就無法刪除。 若要刪除此類項目,必須使用 undo 命令復原目前的暫止變更。

當您簽入暫止刪除時,Team Foundation 會在 Team Foundation 版本控制伺服器中將檔案標示為已刪除。 接著從其他工作區執行項目的 get 作業 (可由您或其他使用者執行),從這些工作區刪除項目。

根據預設,當您的 itemspec 指定資料夾時,Team Foundation 會刪除它的所有檔案和子資料夾,以及子資料夾中所包含的檔案。

如需如何尋找 tf 命令列公用程式的詳細資訊,請參閱 Tf 命令列公用程式命令

範例

下列範例會在指定的本機工作區資料夾中刪除磁碟上的 314.cs,然後在簽入變更時,非永久性地從版本控制系統中移除 314.c。

c:\projects>tf delete 314.cs

請參閱

工作

移動、重新命名和刪除版本控制的檔案及資料夾

參考

Undelete 命令

Undo 命令

Dir 命令

其他資源

Tf 命令列公用程式命令