分享方式：

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

  • 文章

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

Visual Studio 2019 |Visual Studio 2022

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

注意

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

必要條件

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

語法

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

參數

引數

Argument

說明

<itemspec>

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

注意

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

<username>

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

選項。

選項

說明

/lock

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

鎖定選項：

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

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

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

/recursive

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

  • tf delete <folder1>\<folder2> /recursive會刪除 folder1\<folder2 和 folder1>>\<folder2>> 本身所包含的<所有檔案和<子目錄。
  • tf delete <folder1>\<folder2> <filespec> /recursive 會刪除符合 filespec<folder1>\<folder2> 及其每個子目錄中所有檔案和子目錄的所有檔案和子目錄，以及符合 的所有目錄中 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 伺服器移除專案，但不會永久刪除該專案。 您可以使用 命令在 Azure DevOps 伺服器dir中找到已刪除的專案，而且您可以使用 Undelete 命令還原已刪除的專案。

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

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

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

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

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

範例

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

tf delete 314.cs