重新生成客户端缓存

Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018

在进行某些维护操作后,客户端计算机需要缓存刷新。 移动、还原、重命名或故障转移数据层服务器或应用层服务器后,必须刷新缓存以便跟踪工作项,用户必须刷新客户端计算机上的版本控制缓存。

注意

本文适用于本地 Azure DevOps Server 的项目自定义。

您可以在每台客户端计算机下一次连接到项目集合时,使用 witadmin rebuildcache 命令强制重新生成缓存。

重要

若要避免服务器性能问题,请不要在正常工作时间运行此命令。

如何运行 witadmin 命令行工具

若要运行witadmin命令行工具,请打开安装 Visual Studio 的命令提示符窗口。 Witadmin命令行工具安装 Visual Studio 的任何版本。 您可以通过安装Visual Studio Community 或 Visual Studio 团队资源管理器的免费版本来访问此工具。

注意

如果要连接到本地服务器,则必须使用与 Azure DevOps Server 相同或更高版本的 Visual Studio 或团队资源管理器。 例如,如果连接到 TFS 2017 实例,则必须从 Visual Studio 2017 或团队资源管理器2017进行连接。 没有团队资源管理器2015版本。

Visual Studio 2019 或团队资源管理器2019客户端:

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

TeamExplorerEnterpriseProfessional 根据你所安装的版本,或来代替 Community

Visual Studio 2017 或团队资源管理器2017客户端:

%programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

TeamExplorerEnterpriseProfessional 根据你所安装的版本,或来代替 Community

在 Windows 的32位版本中,将% programfiles (x86) %替换为% programfiles%。 可以安装 Visual Studio Community (,以便免费访问团队资源管理器) 或 Visual Studio 团队资源管理器 2017

先决条件

  • 若要使用witadmin rebuildcache命令,你必须是要管理的项目集合的 " Team Foundation Administrators " 组或 " Project Administrators " 组的成员。 请参阅 更改项目集合级别权限

注意

即使你使用管理权限登录,也必须打开提升的命令提示符窗口,才能在运行 Windows server 2008 的服务器上执行此功能。 若要打开提升的命令提示符窗口,请选择 " 开始",打开 " 命令提示符" 的快捷菜单,然后选择 "以 管理员身份运行"。 有关详细信息,请参阅 Microsoft 网站

语法

witadmin rebuildcache /collection:CollectionURL [/noprompt]  

参数

参数 说明
/collectionCollectionURL 指定项目集合的 URI。 例如:
本地 TFS 格式: http://ServerName: Port/VirtualDirectoryName/CollectionName

如果未使用虚拟目录,则 URI 的格式如下所示: http://ServerName: Port/CollectionName
/noprompt 禁用请求确认的提示。
/?帮助 在“命令提示符”窗口中显示有关命令的帮助。

注解

Witadmin rebuildcache命令使指定项目集合的所有客户端上的缓存数据失效。 它会导致客户端下次连接到项目集合时对每个客户端进行缓存刷新。

示例

以下命令将使连接到在名为AdventureWorksServer的服务器上定义的DefaultCollection的所有客户端的元数据缓存失效。 客户端缓存在下次连接到项目集合时更新。

witadmin rebuildcache /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection