Unshelve 命令 （Team Foundation 版本控制）
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） unshelve 命令會將擱置的檔案修訂、簽入筆記、批注和工作項目關聯還原至目前工作區。 您也可以使用 unshelve 命令，從伺服器中移除現有的擱置集。
先決條件
- 若要使用
unshelve命令：- 將 讀取 權限設定為 Allow。
- 將擱置集中項目設定為 [允許]的 [取出] 許可權。
- 若要刪除擱置集，請將其擁有者或擁有 管理擱置變更， 設定為 [允許]的全域許可權。
如需詳細資訊，請參閱 預設 TFVC 權限。
語法
tf unshelve [/move] [<shelveset-name>[;<owner-name>]] <item-spec>
[/recursive] [/noprompt][/login:<username>,[<password>]]
參數
下列各節說明 unshelve 命令的自變數和選項。
參數
自變數
描述
<shelveset-name>
指定要還原的擱置集名稱。
<owner-name>
指定擱置集擁有者的用戶名稱。
<item-spec>
識別檔案或資料夾修訂，以將檔案或資料夾修訂取消存留至目前的工作區。 如果未包含此參數，則指定擱置集中的所有暫止變更預設為未保全。 不允許伺服器路徑。
如需 TFVC 如何剖析 <item-spec> 值以判斷哪些專案在範圍內的詳細資訊，請參閱 使用 Team Foundation 版本控制命令 - 使用選項來修改命令函式的方式。
注意
您可以指定多個 <item-spec> 自變數。
<username>
提供值給 [/login] 選項。 您可以將此值指定為 DOMAIN\<username> 或 <username>。
<password>
提供值給 [/login] 選項。
選項
選項
描述
/move
成功取消擱置集之後，從 Azure DevOps 伺服器刪除指定的擱置集。 此選項無法與 <item-spec> 值結合。
您也可以使用 shelve 命令來刪除擱置集。
/recursive
指定應該以遞歸方式比對 <item-spec> 值。
/noprompt
指定 TFVC 不應該提示您輸入。
/login
指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。
言論
tf 命令行公用程式的 unshelve 命令會從 Azure DevOps 伺服器擷取所有擱置的檔案修訂或已定義之所有擱置的檔案修訂子集。 命令接著會將修訂儲存在目前的工作區中。
若要取消擱置專案，目的地工作區中不得有任何擱置中的修訂。
當您取消擱置擱置集時，TFVC 會將每個擱置的修訂還原到目的地工作區，因為只要修訂與工作區中已擱置的變更不衝突，就會將每個擱置的修訂還原為擱置中的變更。 如需未維持程式期間所發生狀況的詳細資訊，請參閱 使用擱置集。
您可以使用 unshelve 命令，將個別檔案修訂從擱置集還原到工作區。 執行 unshelve 命令之後，請執行 get 命令，以協調在建立擱置集之後簽入伺服器的任何變更。
如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。
回收擱置的變更
如果您想要將擱置修訂整合到您目前的工作區中，以便進行進行中的修訂，請取消維持所需的擱置集。 最佳做法是，在未啟用之後，也取得版本控制檔案的最新版本。
取消保存並檢閱其他用戶的程序代碼
您也可以取消擱置集，以檢閱其他使用者工作區的變更。 若要基於這個理由而取消支援，您有兩個選項：
第一個選項適用於擱置專案和相關專案尚未修訂，或只是自架子集建立後才輕修改。 在此情況下，您可以從擱置集擁有者的工作區擷取所有相關專案的基底版本。 若要使用此選項，請執行下列命令的變化：
tf get \* /version;W<workspace-name>，其中<workspace-name>是其他使用者建立擱置集的來源工作區名稱。建立擱置集之後，第二個選項適合在工作區中經過大量時間或多個修訂。 在此情況下，您可以從伺服器擷取從建立擱置集的日期和時間起，擷取所有相關專案的版本。
您可以將使用者名稱附加至擱置集名稱，以取消擱置其他使用者的擱置變更。 不過，如果您有 AdminShelvedChangesets 許可權，您只能從其他使用者所建立的 Azure DevOps 伺服器中移除擱置集。
如果您嘗試在目的地工作區中取消擱置變更的專案，TFVC 不會合併專案之間的差異，也不會將修訂擷取到您的工作區。
您可以使用 tf shelve /delete刪除擱置集。 如需詳細資訊，請參閱 Shelve 命令。 若要在取消整個擱置集之後自動刪除擱置集，請使用 tf unshelve /move。
例子
下列範例會開啟 [[未維持] 對話框，讓您可以在目前的工作區中找到擱置集並解除擱置。 您也可以選擇在對話框中刪除擱置集，以在未關閉的作業完成時刪除擱置集。
c:\>tf unshelve
下列範例會解除擱置集buddytest_1256到目前的工作區，並從 Azure DevOps Server 中移除它：
c:\>tf unshelve /move buddytest_1256