擱置集指令 (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\usernameusername

選項。

選項 說明
/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:*