查看同步引擎错误消息
若要帮助对 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。
请参见
概念
映射集成组件 [TfsAdmin ProjectServer]