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]]
参数
论点
| 参数 | 说明 |
|---|---|
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 Changeset 8675309 -“源文件”对话框的可编辑格式显示有关变更集8675309的详细信息，并将现有注释替换为 这是一个新的注释。
c:\projects>tf changeset /comment:"This is a new comment." 8675309
输入命令后，在 Visual Studio Changeset 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的现有注释，并在命令提示符窗口中显示有关变更集的信息。 此示例未打开 Visual Studio Changeset 对话框。
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