共用方式為

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