Undelete 命令
undelete 命令可還原之前已刪除的項目。
.gif "注意事項") 注意事項 |
|---|
在執行簽入作業後，這個命令的結果才會顯示在其他工作區中。 如需詳細資訊，請參閱 簽入暫止的變更。 |
必要的使用權限
若要使用 undelete 命令，您必須將 [簽出] 權限設定為 [允許]。 如果加入 /lock 選項並使用 none 以外的值，則必須將 [鎖定] 權限設定為 [允許]。 此外，您必須擁有該工作區或將全域 [管理工作區] 權限設定為 [允許]。 如需詳細資訊，請參閱Team Foundation Server 使用權限。
tf undelete [/noget] [/lock:(none|checkin|checkout)]
[/recursive] itemspec[;deletionID] [/login:username,[password]]
參數
引數 |
描述 |
|---|---|
itemspec |
辨別要取消刪除的檔案或資料夾。 如需 Team Foundation 如何剖析 itemspecs 以便判斷哪些項目位於範圍內的詳細資訊，請參閱命令列語法 (版本控制)。 |
deletionID |
指定唯一的識別項，為具有相同名稱的多個已刪除項目去除混淆。 |
username |
提供 /login 選項的值。 您可以將使用者名稱值指定成網域\ 使用者名稱或使用者名稱的格式。 |
選項 |
描述 |
|---|---|
/noget |
將已刪除的項目還原到工作區，然後在暫止簽入作業完成時還原伺服器上的項目，但不會立即將項目的實體複本擷取到磁碟。 |
/lock |
防止其他使用者簽入或簽出指定的檔案。 如需詳細資訊，請參閱認識鎖定類型。 鎖定選項：
|
/recursive |
還原指定目錄內的所有檔案和子資料夾。 |
/login |
指定使用者名稱和密碼，以便透過 Visual Studio Team Foundation Server 驗證使用者。 |
備註
tf 命令行功能的 Undelete 命令會在暫止簽入作業完成時，排程指定的檔案或資料夾以進行還原。 它還會從伺服器將指定的項目擷取到本機磁碟，除非有明確包含 /noget 選項。
當具有相同名稱的檔案或資料夾已從相同的伺服器資料夾刪除時，必須包含 deletionID 參數的值以表示要還原的刪除項目。 您可以使用 dir 命令取得 deletionID。
如果要在還原檔案之後對檔案進行變更，可以照常使用簽出命令簽出檔案進行編輯。
當 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 版本控制)