擱置集指令 （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
參數
引數
| Argument | 說明 |
|---|---|
<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 不會保留誰修訂專案、何時或操作方式的記錄。 如需決定是否擱置或簽入一組擱置變更，以及擱置的一般概觀的詳細資訊，請參閱 使用擱置集。
如需特定擱置集中個別來源檔案修訂的詳細資訊，您可以使用 Status 命令 搭配 /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:*