Undelete 命令
更新：2007 年 11 月
undelete 命令可還原之前已刪除的項目。
.gif "注意事項") 注意事項： |
|---|
在執行簽入作業後，這個命令的結果才會顯示在其他工作區中。如需詳細資訊，請參閱 HOW TO：簽入暫止的變更。 |
必要的使用權限
若要使用 undelete 命令，您必須將 [簽出] 權限設定為 [允許]。如果加入 /lock 選項並使用 none 以外的值，則必須將 [鎖定] 權限設定為 [允許]。此外，您必須擁有該工作區或將全域 [管理工作區] 權限設定為 [允許]。如需詳細資訊，請參閱 Team Foundation Server 使用權限。
tf undelete [/noget] [/lock:(none|checkin|checkout)] [/newname:name]
[/recursive] itemspec[;deletionID]
參數
引數 |
描述 |
|---|---|
name |
/newname 選項的使用者提供值。您可以指定本機或伺服器路徑。 |
itemspec |
辨別要取消刪除的檔案或資料夾。如需 Team Foundation 如何剖析 itemspecs 以便判斷哪些項目位於範圍內的詳細資訊，請參閱命令列語法 (Team System)。 |
deletionID |
指定唯一的識別項，為具有相同名稱的多個已刪除項目去除混淆。 |
選項 |
描述 |
|---|---|
/noget |
將已刪除的項目還原到工作區，然後在暫止簽入作業完成時還原伺服器上的項目，但不會立即將項目的實體複本擷取到磁碟。 |
/lock |
防止其他使用者簽入或簽出指定的檔案。如需詳細資訊，請參閱瞭解鎖定類型。 鎖定選項：
|
/newname |
在還原項目時將其重新命名。 |
/recursive |
還原指定目錄內的所有檔案和子資料夾。 |
備註
tf 命令行功能的 Undelete 命令會在暫止簽入作業完成時，排程指定的檔案或資料夾以進行還原。它還會從伺服器將指定的項目擷取到本機磁碟，除非有明確包含 /noget 選項。
當具有相同名稱的檔案或資料夾已從相同的伺服器資料夾刪除時，必須包含 deletionID 參數的值以表示要還原的刪除項目。您可以使用 dir 命令取得 deletionID。
若要將項目取消刪除到伺服器資料夾中，而該資料夾中已有相同名稱的項目存在或暫止加入，可以使用 /newname 選項為取消刪除的項目提供新名稱。只能使用 /newname 選項一次取消刪除一個項目。
如果要在還原檔案之後對檔案進行變更，可以照常使用簽出命令簽出檔案進行編輯。
當 itemspec 指定資料夾時，Team Foundation 依預設會還原所有的檔案和子資料夾及其包含的檔案。如果不要還原資料夾中的所有項目，必須首先取消刪除該資料夾及其項目，然後再刪除不要保留的項目。
如需如何尋找 tf 命令列公用程式的詳細資訊，請參閱 Tf 命令列公用程式命令。
範例
下列範例會將 314.cs 還原到從其刪除該檔案的伺服器資料夾，並在目前的工作區中擷取最新版本的唯讀複本。
C:\projects>tf undelete c:\math\314.cs
下列範例會為伺服器上所有已刪除一次以上的項目顯示刪除 ID。
c:\projects>tf dir $/ /deleted
範例輸出：
$/projects/math/314.cs;X10 $/projects/math/314.cs;X11
下列範例會將 314.cs 的 X11 版本還原到從其刪除該檔案的伺服器資料夾，並在目前的工作區中擷取最新版本的唯讀複本。
c:\projects>tf undelete 314.cs;X11
請參閱
概念
參考
Rename 命令 (Team Foundation 版本控制)