復原指令 （Team Foundation 版本控制）
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） undo 命令會捨棄一或多個暫止的檔案或資料夾變更。
必要條件
根據預設，項目 參與者 群組的成員具有參與存放庫的許可權，並在自己的工作區中使用 undo 命令。 若要復原其他使用者工作區中暫止的變更，您必須將 管理員 ister workspaces 許可權設定為 [允許]。 如需詳細資訊，請參閱 預設 TFVC 許可權。
語法
tf undo [/workspace:<workspace-name>[;<workspace-owner>]]
[/recursive] <item-specification> [/noprompt] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>]
參數
參數
描述
/collection:<team-project-collection-url>
指定包含專案之專案集合的網址，例如 https://myserver:8080/tfs/DefaultCollection。
如果您沒有使用 /workspace 選項，預設會使用包含對應目前目錄之工作區的專案集合。
<item-specification>
指定項目的範圍。 您可以指定多個 <item-specification> 自變數。 如需語法，請參閱 使用Team Foundation版本控制命令。
/login
指定要用來執行命令的用戶帳戶。 請參閱 使用Team Foundation版本控制命令。
/noprompt
隱藏視窗和對話框的顯示，並將輸出數據重新導向至命令提示字元。 請參閱 使用Team Foundation版本控制命令。
/recursive
遞歸地復原指定目錄中專案和任何子目錄中的項目變更。
/workspace <workspace-name>[;<workspace-owner>]
指定要復原擱置中變更的工作區名稱。 如果未指定，則會使用對應目前目錄的工作區。
您可以指定 <workspace-owner> 在屬於特定使用者的工作區中復原暫止的變更。 如果您未提供此自變數，預設會使用目前使用者所擁有的工作區。 但是，如果您以用戶名稱提供 /login 自變數，則會使用該用戶所擁有的工作區。 您必須將 [復原 ] 權限設定為 [允許 ] 以復原其他使用者工作區中的變更。
注意
您可以使用 undo 命令，在仍在使用的遠端工作區中復原擱置中的變更。 在繼續在該工作區中工作之前，用戶必須登入裝載工作區的計算機，並取得受復原作業影響的專案。 如需命令及其/all自變數的詳細資訊get，請參閱 Get 命令。
備註
對於每個具有暫止 編輯 變更的專案， undo 命令會決定檔案是否已在磁碟上修改。 如果檔案已修改，但 /noprompt 尚未指定 選項，系統會提示您確認要繼續。 在鍵盤上，選取：
- N 以保留變更。
- Y ，只繼續進行目前的變更。
- ，以繼續進行此檔案和偵測到的任何其他已修改檔案。
命令 undo 會移除指定專案上的任何 鎖定 。
範例
下列命令會移除program.cs檔案的暫止變更：
c:\code\SiteApp\Main\SolutionA\Project1>tf undo program.cs
下列命令會移除 c：\code\SiteApp\Main 資料夾及其子資料夾中所有專案的暫止變更：
c:\code\SiteApp\Main>tf undo * /recursive
下列命令會移除指定集合和遠端工作區中program.cs檔案的暫止變更：
c:\>tf undo /collection:https://fabrikam-3:8080/tfs/DefaultCollection
/workspace:FABRIKAM-1;PatI $/SiteApp/Main/SolutionA/Project1/program.cs
提示
- 若要檢視目前工作區或遠端工作區中暫止變更的清單，請使用
status命令。 如需詳細資訊，請參閱 Status 命令。 - 您可以使用
/workspace選項，並視需要/collection使用 選項，在遠端開發計算機上復原變更。 當檔案已取出且可能鎖定在您無法存取的開發計算機上時，這項功能特別有用。 如需詳細資訊，請參閱本文稍早的/workspace自變數說明。 - 有時候您需要清除工作區，例如，當您的工作因更緊急的工作而中斷時。 如果您想要保留暫止的變更，而不是復原這些變更，您可以使用 命令來暫停變更
shelve。 如需詳細資訊，請參閱 Shelve 命令。 您也可以保留開啟視窗、斷點和其他重要提示的位置。如需詳細資訊，請參閱 暫停您的工作和管理擱置集。 - 除了復原擱置中的變更，您也可以捨棄已簽入的變更。 如需詳細資訊，請參閱取消刪除命令和復原命令 （Team Foundation 版本控制）。