擱置集命令 （Team Foundation 版本控制）
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） shelvesets 命令會顯示一組擱置變更的相關信息。
先決條件
若要使用 shelvesets 命令，請具有 讀取 許可權，以及 簽出 許可權設定為 [允許擱置集中專案的]。 如需詳細資訊，請參閱 預設 TFVC 權限。
語法
tf shelvesets [/owner:ownername] [/format:(brief|detailed)] [/collection:TeamProjectCollectionUrl]] [/login:username,[password]] shelvesetname
參數
參數
| 自變數 | 描述 |
|---|---|
<ownername> |
提供值，例如 * 或 DOMAIN\username 至 /owner 選項。 |
<shelvesetname> |
擱置集的名稱。 |
<TeamProjectCollectionUrl> |
專案集合的 URL，其中包含一組您要顯示資訊的擱置變更，例如 http://myserver:8080/tfs/DefaultCollection。 |
<username> |
提供值給 [/login] 選項。 您可以將使用者名稱值指定為 DOMAIN\username 或 username。 |
選項
| 選項 | 描述 |
|---|---|
/owner |
指定一或多個擱置集擁有者。 您可以使用通配符。 |
/format |
指定要顯示擱置集資訊的格式類型。Brief 會顯示擱置集名稱、建立擱置集的用戶名稱，以及存在擱置集批注。 除了相關聯的工作專案清單和任何簽入筆記之外，Detailed 也會顯示擱置集名稱、擁有者和批註。
Brief 是預設值。 |
/collection |
指定專案集合。 |
/login |
指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。 |
言論
擱置集是由 Shelve 命令所建立。 擱置集會儲存在 Azure DevOps 伺服器上，而且任何具有足夠許可權的使用者都可以使用 Unshelve 命令擷取至工作區。
不同於變更集，擱置集是非版本設定的實體。 如果您或其他使用者取消擱置集中的專案，請編輯數個檔案，然後重新保存擱置集，TFVC 不會建立新版本的專案以供日後比較。 TFVC 不會保留誰修訂專案、何時或操作方式的記錄。 如需決定是否擱置或簽入一組擱置變更的詳細資訊，以及擱置的一般概觀，請參閱 使用擱置集。
如需特定擱置集中個別來源檔案修訂的詳細資訊，您可以使用 [狀態] 命令 搭配 [/shelveset] 選項。
您可以將擱置的修訂與其基底擱置集版本進行比較，而不需要將專案解除保護到您的工作區中。 您可以使用此功能進行快速對等程式代碼檢閱。
如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。
例子
下列範例會顯示目前目錄所對應之 Azure DevOps 伺服器 BuddyTest_23 擱置集的相關信息：
c:\projects>tf shelvesets BuddyTest_23
下列範例會列出 Pat所擁有的擱置集：
c:\projects>tf shelvesets /owner:Pat
下列範例會顯示目前目錄對應之 Azure DevOps 伺服器上所有擱置集的相關信息：
c:\projects>tf shelvesets /owner:*