Changeset 命令

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Visual Studio 2022 |Visual Studio 2019 |Visual Studio 2017 |Visual Studio 2015 |Visual Studio 2013

显示相关信息,并允许更改与更改集关联的属性,例如注释和签入笔记。

先决条件

若要使用 变更集 命令,必须具有 “读取 ”权限集,以 允许 要为其显示完整信息的更改集中的任何文件或文件夹。 唯一可以修改与更改集关联的注释和注释的用户是创建更改集的用户或具有修订其他用户的更改全局权限的用户。

有关详细信息,请参阅 默认 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 命令查看更改集的属性并修改其属性。 可以使用“历史记录”命令确定要获取相关信息的更改集。 有关详细信息,请参阅 历史记录命令

有关如何查找 tf 命令行实用工具的详细信息,请参阅 使用 Team Foundation 版本控制命令

示例

以下示例在 “更改 集”对话框中以可编辑格式显示有关变更集8675309的详细信息,并将现有注释替换为“这是一个新批注”。

按 Enter 后,将显示 Changesetchangeset<number>- 源文件对话框的详细信息。 单击“ 保存 ”将批注与更改集相关联。

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

以下示例提供了两个签入说明,用于与更改集相关联。

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,并在命令提示符窗口中显示有关更改集的信息。 该示例不启动 “更改集 ”对话框。

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 is not 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