取消刪除指令 （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 - 您必須擁有工作區，或將全域 管理員 註冊工作區許可權設定為 [允許]。
如需詳細資訊，請參閱 預設 TFVC 許可權。
語法
tf undelete [/noget] [/lock:(none|checkin|checkout)]
[/recursive] <item-specification>[;<deletion-ID>] [/login:<username>,[<password>]]
參數
下列各節說明 命令的 undelete 自變數和選項。
引數
| Argument | 描述 |
|---|---|
<item-specification> |
識別要還原的檔案或資料夾。 如需 TFVC 如何剖析 <item-specification> 值以判斷哪些專案在範圍內的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。 |
<deletion-ID> |
指定可釐清多個具有相同名稱之已刪除專案的唯一標識符。 |
<username> |
提供 選項的值 /login 。 您可以指定此值指定為 DOMAIN\<username> 或 <username>。 |
選項。
選項
說明
/noget
將已刪除的專案還原至您的工作區。 擱置簽入作業完成時，此選項接著會還原伺服器上的專案，但不會立即擷取專案的實體複本至磁碟。
/lock
防止其他使用者簽入或簽出指定的檔案。 如需詳細資訊，請參閱 瞭解鎖定類型。
鎖定選項：
None：此選項是預設值。 未套用鎖定。Checkin：其他使用者可以簽出指定的專案，但在您簽入鎖定的檔案以釋出鎖定之前，他們無法簽入鎖定的檔案修訂。 如果任何其他使用者已鎖定任何指定的專案，鎖定作業就會失敗。Checkout：此選項可防止其他使用者簽入或簽出任何指定的專案，直到您簽入鎖定的檔案來釋放鎖定為止。 如果任何其他使用者已鎖定任何指定的專案，鎖定作業就會失敗。
/recursive
從指定的目錄還原所有檔案和子資料夾。
/login
指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。
備註
undelete命令行功能的命令tf會排程指定的檔案或資料夾，以便還原，等待簽入作業完成。 除非您明確包含 /noget 選項，否則也會從伺服器擷取指定的專案到本機磁碟。
當具有相同名稱的檔案或資料夾從相同的伺服器資料夾中刪除時，您必須包含 參數的值 <deletion-ID> ，以指出您要還原的已刪除專案之哪一個。 您可以使用 命令取得 <deletion-ID> dir 。
如果您想要在還原檔案之後變更檔案，請如往常一樣查看檔案以供編輯 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