Delete 命令 (Team Foundation 版本控制)

發行項
08/21/2008

更新：2007 年 11 月

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

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

必要的使用權限

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

tf delete [/lock:(none|checkin|checkout)] [/recursive] itemspec

參數

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

選項	描述
/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)。

/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)。

備註

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

請參閱

共用方式為

Delete 命令 (Team Foundation 版本控制)

參數

備註

範例

請參閱

工作

參考

其他資源

其他資源