通过

RenameDT 命令

  • 项目

更新：2007 年 11 月

使用 RenameDT 可以更改 Team Foundation Server 数据层服务器的名称。

重要说明：

为了使 RenameDT 命令成功，下列应用程序池和程序必须正在运行。

  • Team Foundation Server Application Pool（应用程序池）

  • ReportServer（应用程序池）

    说明：

    对于 SQL Server 2005，您需要在 Internet 信息服务 (IIS) 中管理 ReportServer 应用程序池；对于 SQL Server 2008，则不需要这样做。

  • SQL Server Reporting Services（程序）

必需的权限

若要使用 RenameDT 命令，您必须是 Team Foundation 应用层服务器上“Team Foundation Administrators”组的成员，并且必须是 Team Foundation 数据层服务器上 SQL Server 的“sysadmin”组的成员。有关更多信息，请参见 Team Foundation Server 权限。

说明：

即使您是以管理凭据登录的，也必须使用提升的权限打开命令提示窗口，才能在正在运行 Windows Server 2008 的服务器上执行此功能。若要使用提升的权限打开命令提示窗口，请单击“开始”，右击“命令提示符”，再单击“以管理员身份运行”。有关更多信息，请参见 Microsoft 网站。

 
TFSAdminUtil RenameDT servername

参数

参数

说明

servername

指定目标数据层计算机名称。可以按以下类型标识计算机：

  • IP 地址

    IP 地址必须使用以下格式：aaa.bbb.ccc.ddd。

  • 计算机名称

    不允许空格或 ";:<>* 等特殊字符，只可使用 [A-Z | 0-9 | -] 字符，并且不能全部为数字；普通 ASCII 最多包含 15 个字符，较大的字符编码最多包含 7 个字符。有关更多信息，请参见 Team Foundation Server 的命名限制。

  • 域地址

    例如，Myserver.location.mycompanyt.com。

备注

重要说明：

建议您备份 Team Foundation Server 数据层服务器中的数据库。

服务 Web.config 文件中的 TFSNameUrl 和 TFS Name 字符串必须引用当前的 Team Foundation Server 数据层服务器，该文件位于数据层上的驱动器:\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\Web Services 中。否则，RenameDT 命令将失败且不给出任何提示。

Team Foundation Server 应用层需要知道数据层服务器的确切名称或地址，才能到达它。数据层名称和地址存储在整个 Team Foundation Server 的应用层和数据层数据库中的多个位置。当需要切换到新的数据层时，管理员必须确保 Team Foundation Server 指向新的数据层名称或地址。

TFSAdminUtil 命令行实用工具的 RenameDT 命令通过更新 Team Foundation Server 指向新的名称或地址，来实现数据层重命名过程的自动化。RenameDT 命令还可以通过脚本实现数据层重命名过程自动或定期进行。

RenameDT 命令只能运行于应用层上，因为它会在运行所在的计算机上搜索 web.config 文件。它既没有远程处理能力，也不会使用任何其他参数来指定目标应用层计算机。

使用情形示例

管理员可以在多种情形下使用 RenameDT 命令。下面列出了这些示例情形：

  • 管理员需要在数据层上执行例程维护，使数据层脱机并将它替换为其他临时数据层以避免出现停机。

  • 管理员运行 TFSAdminUtil 命令行实用工具的 RenameDT 命令，这样 Team Foundation Server 即可连接到新的临时数据层。完成维护时，管理员再次运行该实用工具以恢复使用以前的数据层。

  • 数据层出现故障并且不起作用。

  • 管理员运行 RenameDT 命令，以使 Team Foundation Server 指向新的备份服务器。

  • 正在将数据层升级到新的服务器。

  • 管理员运行 RenameDT 命令，以使 Team Foundation Server 指向新的数据层服务器。

  • 新操作策略表明数据层必须遵循的特定计算机命名标准。

  • 管理员使用 RenameDT 命令，将数据层重命名为更合适的名称。

  • 组织或业务规模扩大，需要从单服务器解决方案迁移到双服务器解决方案。

  • 新的独立数据层设置完毕后，管理员运行 RenameDT 命令，以使 Team Foundation Server 指向新的服务器。

示例

下面的示例将 Team Foundation Server 中数据层名称的所有实例重命名为 NewName。

>TFSAdminUtil RenameDT NewName

请参见

其他资源

TFSAdminUtil 命令行命令

使用 Team Foundation Server 命令行工具

管理 Team Foundation Server

管理 Team Foundation Server 服务和服务帐户

管理 Team Foundation Server 数据层服务器