Changeset 命令

  • 發行項

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

顯示和的相關信息，可讓您變更與變更集相關聯的屬性，例如批注和簽入附註。

必要條件

若要使用 changeset 命令，您必須將 [讀取 ] 權限設定為 [允許 ] 變更集中的任何檔案或資料夾，以便顯示完整資訊。 唯一可以修改與變更集相關聯之附注和批注的使用者，就是建立變更集的使用者，或是擁有 修改其他用戶變更 全域許可權的使用者。

如需詳細資訊，請參閱 預設 TFVC 許可權。

語法

tf changeset [/comment:("comment"|@commentfile)] 
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]] 
[changesetnumber | /latest][/login:username,[password]]

參數

引數

Argument 說明
comment 提供簽入的相關批注。
@<commentfile> 指定磁碟上檔案的路徑，其中包含用於簽入的批注。
<NoteFieldName>=<NoteFieldValue> 設定簽入附註欄位的值。 您可以提供多個分號分隔 field=value 表達式。
@<notefile> 提供磁碟上檔案的路徑，該檔案包含每行一行一個的簽入記事域名和值。field=value
<TeamProjectCollectionUrl> 專案集合的 URL，其中包含您要顯示資訊或其屬性要修改之變更集的變更集，例如 http://myserver:8080/tfs/DefaultCollection。
<username> 提供 選項的值 /user 。 您可以將這個自變數指定為 Domain\username 或 username。
<changesetnumber> 識別要檢閱或修改的變更集。 無法與 /latest 搭配使用。

選項

選項 說明
/comment 以新的批註取代簽入程式期間建立的變更集批注。
/notes 提供一或多個簽入附註，以便與變更集產生關聯。
/latest 指定最新的變更集。 無法與 <changesetnumber> 搭配使用。
/noprompt 隱藏您輸入的任何提示。
/collection 指定專案集合。
/login 指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。

備註

變更集是一組已認可至 Team Foundation 版本控制伺服器的檔案和資料夾修訂，做為相同簽入事件的一部分。 如需詳細資訊，請參閱 使用變更集。

您可以使用 changeset 命令來檢視變更集的屬性，並修改其屬性。 您可以使用 history 命令來判斷您想要取得相關信息的變更集。 如需詳細資訊，請參閱 記錄命令。

如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用Team Foundation版本控制命令。

範例

下列範例會在 [Visual Studio Details for Changeset 8675309 - Source Files] 對話框中，以可編輯的格式顯示變更集8675309的詳細資訊，並將現有的批註取代為 [這是新的批注]。

c:\projects>tf changeset /comment:"This is a new comment." 8675309

輸入命令之後，在 [Visual Studio Details for Changeset 8675309 - Source Files ] 對話框中，選取 [ 儲存 ] 以將批注與變更集產生關聯。

下列範例提供兩個簽入附注，以與變更集產生關聯。

c:\projects>tf changeset /notes:reviewer=Jo;Security = checked 8675309

下列範例提供兩個簽入附註，其中包含值和名稱中的空格，以與變更集產生關聯。

c:\projects>tf changeset /notes:"Code Reviewer"="John Smith";"Security Reviewer"="Chen Yang" 8675309

下列範例會將檔案notes.txt中包含的簽入附註與變更集8675309產生關聯。

c:\projects>tf changeset /notes:@notes.txt 8675309

其中notes.txt的格式如下：

field1=value1;
field2=value that
spans multiple
lines;
field3 = value3;

下列範例會取代變更集的現有批註8675309，並在命令提示字元視窗中顯示變更集的相關信息。 此範例不會開啟 [Visual Studio 變更集 ] 對話方塊。

c:\projects>tf changeset /comment:"This is an automatically generated comment." /noprompt 8675309

下列範例會在命令提示字元視窗中顯示變更集8675309不可編輯的資訊。

c:\projects>tf changeset 8675309 /noprompt

範例輸出：

Changeset: 8675309
User: DOMAIN\JohnG
Date: 01/21/2004 21:03:45
Comment:  This check-in fixes issues in several features.  I also refactored some items in buf.c into a new file named bif.c because buf.c was too hard to parse.
Items:
    $/baz/proj/bif.c           Added
    $/baz/proj/buf.c          Modified, Renamed
Work Items:
    34527     The "Access Denied" message isn't descriptive enough.
    35628     The UI flickers when I press the '8', 'y', 'Ctrl', and 'End' buttons at the same time.
Check-in Notes:
    Code Reviewer:  ShellM
    Performance Reviewer: ShellM
    Security Reviewer: ShellM