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 命令来确定要获取相关信息的变更集。 有关详细信息，请参阅 History 命令。
有关如何使用 tf 命令行实用工具的详细信息，请参阅使用 Team Foundation 版本控制命令。
示例
以下示例在 Visual Studio“变更集 8675309 详细信息 - 源文件”对话框中以可编辑的格式显示有关变更集 8675309 的详细信息，并将现有注释替换为“这是一个新注释”。
c:\projects>tf changeset /comment:"This is a new comment." 8675309
输入命令后，在 Visual Studio“变更集 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
以下示例将 file 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