查看同步引擎错误消息

若要帮助对 Visual Studio Team Foundation Server (TFS) 和 Microsoft Project 的集成进行疑难解答,您可以显示最近同步错误的列表。 可以使用 TFSAdmin ProjectServer 命令行工具的 /GetSyncMessages 选项显示为团队项目集合记录的最新错误。

备注

有关同步的信息,请参见TFS-Project Server 集成功能的概述

若要运行 TfsAdmin 命令行工具, 请在安装了Visual Studio 或 团队资源管理器 的情况下打开命令提示符窗口,然后输入:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

在 32 位 Windows 版本上,将 %programfiles(x86)% 替换为 %programfiles%.

要求

若要使用此命令,必须将团队项目集合的**“管理 Project Server 集成”权限设置为“允许”**。 此外,还必须向 Team Foundation Server 服务帐户授予与参与数据同步的 Project Web Access 或 Project Web App (PWA) 实例进行交互的必需权限。 有关详细信息,请参阅分配权限以支持 TFS-Project Server 集成

语法

TfsAdmin ProjectServer /GetSyncMessages /collection:tpcUrl

参数

Parameter

描述

/collection: tpcUrl

指定团队项目集合的统一资源定位器 (URL)。 可以按以下格式指定 URI:

http://ServerName:Port/VirtualDirectoryName/CollectionName

如果不指定虚拟目录,则必须按以下格式指定 URI:

http://ServerName:Port/CollectionName

/?help

显示有关此命令的信息。

返回值

/GetSyncMessages 选项显示一组用制表符分隔且具有列标题的消息。 对于每个消息都显示以下信息:

  • Date:记录消息的日期。

  • “团队项目集合名称\团队项目名称”:团队项目集合和团队项目的名称。

  • “项目名称”:企业项目计划的名称。

  • Message:消息的内容。

这些消息从同步功能日志中提取。 /GetSyncMessages 选项截断比平均值长的消息。 当发生此截断时,将显示以下消息:

已从日志中截断其他一些错误。 可在应用层服务器的事件日志中查看这些错误。

可以通过打开相应应用层服务器的事件日志中来查看完整的消息。

示例

下面的示例检索已为在 MyTFSServer 应用层服务器上定义的 DefaultCollection 记录的错误消息。

TfsAdmin ProjectServer /GetSyncMessages /collection:http://MyTFSServer:8080/tfs/DefaultCollection

提示

可以使用标准命令行语法将输出发送到文件。例如,可以指定 >c:\output.txt

请参见

概念

TFS-Project Server 集成功能的概述

映射集成组件 [TfsAdmin ProjectServer]

其他资源

TFS-Project Server 集成支持的已知问题和解决方法