取消刪除指令 （Team Foundation 版本控制）
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） undelete 命令會還原先前刪除的專案。
注意
除非您執行簽入作業，否則在其他工作區中看不到此命令的結果。 如需詳細資訊，請參閱 開發程式代碼和管理擱置中的變更。
先決條件
若要使用 undelete 命令：
- 將 [簽出 權限設定為 [允許]。
- 如果您將 [
/lock] 選項與None以外的值包含在 內，請將 [鎖定] 權限設定為 [允許]。 - 您必須擁有工作區，或擁有全域 管理工作區 許可權設定為 Allow。
如需詳細資訊，請參閱 預設 TFVC 權限。
語法
tf undelete [/noget] [/lock:(none|checkin|checkout)]
[/recursive] <item-specification>[;<deletion-ID>] [/login:<username>,[<password>]]
參數
下列各節說明 undelete 命令的自變數和選項。
參數
| 論點 | 描述 |
|---|---|
<item-specification> |
識別要還原的檔案或資料夾。 如需 TFVC 如何剖析 <item-specification> 值以判斷哪些專案在範圍內的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。 |
<deletion-ID> |
指定可釐清多個具有相同名稱之已刪除專案的唯一標識符。 |
<username> |
提供值給 [/login] 選項。 您可以將此值指定為 DOMAIN\<username> 或 <username>。 |
選項
選項
描述
/noget
將已刪除的專案還原至您的工作區。 擱置簽入作業完成時，此選項接著會還原伺服器上的專案，但不會立即擷取專案的實體複本至磁碟。
/lock
防止其他使用者簽入或簽出指定的檔案。 如需詳細資訊，請參閱 瞭解鎖定類型。
鎖定選項：
-
None：此選項是預設值。 未套用鎖定。 -
Checkin：其他使用者可以簽出指定的專案，但除非您簽入鎖定的檔案，才能簽入鎖定的檔案修訂。 如果任何其他使用者已鎖定任何指定的專案，鎖定作業就會失敗。 -
Checkout：此選項可防止其他使用者簽入或簽出任何指定的專案，直到您簽入鎖定的檔案來釋放鎖定為止。 如果任何其他使用者已鎖定任何指定的專案，鎖定作業就會失敗。
/recursive
從指定的目錄還原所有檔案和子資料夾。
/login
指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。
言論
tf 命令行功能的 undelete 命令會排程指定的檔案或資料夾，等待簽入作業完成。 除非您明確包含 /noget 選項，否則也會從伺服器擷取指定的專案到本機磁碟。
當相同名稱的檔案或資料夾已從相同的伺服器資料夾中刪除時，您必須包含 <deletion-ID> 參數的值，以指出您要還原的已刪除專案之哪一個。 您可以使用 dir 命令來取得 <deletion-ID>。
如果您想要在還原檔案之後變更檔案，請如往常使用 checkout 命令查看檔案以進行編輯。
當您的 <item-specification> 值指定資料夾時，TFVC 預設會還原所有資料夾的檔案和子資料夾及其包含的檔案。 如果您不想還原資料夾中的所有專案，您必須先取消刪除資料夾及其項目，然後刪除您不想保留的專案。
如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。
例子
下列範例會將 314.cs 還原至已刪除 314.cs 的伺服器資料夾。 此命令也會擷取目前工作區中最新版本的唯讀複本。
C:\projects>tf undelete c:\math\314.cs
下列範例會顯示伺服器上已刪除一次以上之所有項目的刪除識別碼：
c:\projects>tf dir $/ /deleted
上一個命令的輸出可能看起來像下列範例：
$/projects/math/314.cs;X10
$/projects/math/314.cs;X11
下列範例會將 X11 版的 314.cs 還原至從中刪除檔案的伺服器資料夾。 此命令也會擷取目前工作區中最新版本的唯讀複本。
c:\projects>tf undelete 314.cs;X11