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