共用方式為


刪除指令 (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\usernameusername

選項。

選項

說明

/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