Changeset 命令
显示有关信息并让您更改特性，例如与某个变更集相关的注释和签入说明。
所需权限
若要使用 changeset 命令，您必须针对要显示其完整信息的变更集中的任何文件或文件夹将**“读”权限设置为“允许”**。 只有创建变更集或具有“修订其他用户的更改”全局权限的用户才能修改与变更集相关联的说明和注释。 有关更多信息，请参见 Team Foundation Server 权限。
tf changeset [/comment:("comment"|@commentfile)]
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]]
[changesetnumber | /latest][/login:username,[password]]
参数
参数 |
说明 |
|---|---|
comment |
提供关于签入的注释。 |
@commentfile |
指定包含用于签入的注释的文件在磁盘上的路径。 |
NoteFieldName=NoteFieldValue |
设置签入说明字段的值。 可以提供多个分号分隔的“字段=值”表达式。 |
@notefile |
提供磁盘上文件的路径，该文件包含“字段=值”格式的签入说明的字段名称和值（每行一个字段名称和值）。 |
TeamProjectCollectionUrl |
您要显示其信息或修改其属性的变更集所在的团队项目集合的 URL（例如，http://myserver:8080/tfs/DefaultCollection）。 |
username |
向 /user 选项提供值。 可以按域\用户名或用户名的格式指定此参数。 |
changesetnumber |
标识要查看或修改的变更集。 不能与 /latest 一起使用。 |
选项 |
说明 |
|---|---|
/comment |
用新的注释替换在签入过程中创建的变更集注释。 |
/notes |
提供要与变更集相关联的一个或多个签入说明。 |
/latest |
指定最新的变更集。 不能与 变更集号 一起使用。 |
/noprompt |
取消显示需要您输入的任何提示。 |
/collection |
指定团队项目集合。 |
/login |
指定用于在 Visual Studio Team Foundation Server 中验证用户身份的用户名和密码。 |
备注
“变更集”是作为同一签入事件的一部分提交到 Team Foundation 版本控制 服务器的一组文件或文件夹修订。 有关更多信息，请参见使用变更集。
您可以使用 changeset 命令查看变更集的特性并修改其属性。 您可以使用 History 命令来确定要获取哪个变更集的相关信息。 有关更多信息，请参见 History 命令。
有关指向其他 Team Foundation 命令的链接（这些命令提供关于 Team Foundation 版本控制 服务器和映射到其中的所有工作区中的项的附加信息），请参见 信息性命令。
有关如何查找 tf 命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。
示例
下面的示例在**“变更集”**对话框中以可编辑格式显示有关变更集 8675309 的详细信息，并将现有的注释替换为“This is a new comment”（这是一个新的注释）。
在按 Enter 之后，会出现**“<变更集编号> 号变更集的详细信息 - 源文件”对话框。 单击“保存”**将注释与变更集相关联。
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