RenameDT 命令

發行項
08/21/2008

更新：2007 年 11 月

使用 RenameDT 可以變更 Team Foundation Server 資料層伺服器的名稱。

重要事項：
為了使 RenameDT 命令成功，下列應用程式集區和程式必須在執行中。

Team Foundation Server 應用程式集區 (應用程式集區)

ReportServer (應用程式集區)

注意事項：
您可以在 Internet Information Services (IIS) 中管理 SQL Server 2005 的 ReportServer 應用程式集區，但是不能管理 SQL Server 2008 的 ReportServer 應用程式集區。

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。

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 檔案 (位於資料層的 Drive:\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\Web Services) 內的 TFSNameUrl 和 TFS Name 字串，必須參考目前的 Team Foundation Server 資料層伺服器。否則，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 指向新的伺服器。