刪除指令 （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