共用方式為

刪除指令 （Team Foundation 版本控制）

  • 發行項

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

delete 命令會從 Azure DevOps 伺服器移除檔案和資料夾，並從磁碟中刪除它們。

注意

除非您執行簽入作業，否則在其他工作區中看不到此命令的結果。 如需詳細資訊，請參閱 開發程式代碼和管理擱置中的變更。

先決條件

若要使用 delete 命令，請將 [簽出 權限設定為 Allow。 如果您將 [/lock] 選項與 none以外的值包含在 內，請將 [鎖定] 權限設定為 [允許]。 您必須擁有工作區，或擁有全域 管理工作區， 權限設定為 Allow。 如需詳細資訊，請參閱 預設 TFVC 權限。

語法

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

參數

參數

自變數

描述

<itemspec>

識別要從 Azure DevOps 伺服器刪除的檔案或資料夾。 如需 TFVC 如何剖析 itemspec 以判斷哪些項目在範圍內的詳細資訊，請參閱 使用選項修改命令如何。

注意

您可以指定多個 itemspec 自變數。

<username>

提供值給 [/login] 選項。 您可以將使用者名稱值指定為 DOMAIN\username 或 username。

選項

選項

描述

/lock

防止其他使用者簽入或簽出指定的專案。 如需詳細資訊，請參閱 瞭解鎖定類型。

鎖定選項：

  • none
    違約。 未套用鎖定。 如果您已將鎖定放在指定的檔案上，此選項會將其移除。 它不會移除其他人放置的鎖定。

  • checkin
    其他使用者可以簽出指定的專案，但除非您執行簽入來釋放鎖定，否則無法簽入鎖定的檔案修訂。 如果任何其他使用者已鎖定任何一個指定的專案，鎖定作業就會失敗。

  • checkout
    防止其他使用者簽入或取出任何一個指定的專案，直到您執行簽入來釋放鎖定為止。 如果任何其他使用者已鎖定任何一個指定的專案，鎖定作業就會失敗。

/recursive

從指定的目錄刪除符合 itemspec 的所有檔案和/或資料夾和子資料夾。

  • 會刪除 folder1\folder2中包含的所有檔案和子 目錄，folder1\folder2 本身。
  • tf delete <folder1>\<folder2> <filespec> /recursive 會刪除所有符合 <folder1>\<folder2> 及其子目錄中所含 filespec 的檔案和子目錄，以及符合 filespec之任何目錄中所包含的所有檔案和子目錄。

例如，在包含下列專案的工作區中：

Folder1\AVeryLongDirectoryName 內有一些檔案，Folder1\Folder2\AVeryImportantFile.txt、

tf delete Folder1 AVer* /recursive

會刪除 Folder1\AVeryLongDirectoryName 及其所有檔案，並刪除 Folder1\Folder2\AVeryImportantFile.txt，因為它符合通配符。

/login

指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。

言論

delete 命令會針對您指定的專案，記錄工作區中 delete 類型的暫止變更。 當您使用 checkin 命令將類型 delete 暫止變更認可至 Azure DevOps 伺服器時，TFVC 會從 Azure DevOps 伺服器移除專案，但不會永久刪除該專案。 您可以使用 dir 命令，在 Azure DevOps 伺服器中找到已刪除的專案，而且您可以使用 Undelete 命令還原已刪除的專案。

如果您已刪除工作區中的專案，但尚未簽入變更，您可以使用 [復原] 命令，將專案還原至工作區，並從擱置中的變更清單中移除刪除作業，。

您無法刪除有另一個暫止變更的專案。 例如，無法刪除取出的檔案。 若要刪除這類專案，您必須使用 undo 命令復原目前擱置中的變更。

當您簽入擱置的刪除時，TFVC 會將檔案標示為在 Azure DevOps 伺服器中刪除。 接著，從其他工作區執行專案的 get，由您或其他使用者從這些工作區中刪除該專案。

當您的 itemspec 指定資料夾時，TFVC 預設會刪除其所有檔案和子資料夾及其包含的檔案。

如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。

例子

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

tf delete 314.cs