共用方式為

ChangeServerID 命令

  • 發行項

ChangeServerID 命令會變更與 Visual Studio Team Foundation Server (TFS) 之資料庫相關聯的全域萬用識別碼 (GUID)。GUID 在 TFS 部署之內必須是唯一的。如果一個以上的資料庫具有相同的 GUID，您的部署可能會變得不穩定或無法使用。您可以變更組態資料庫的 GUID，部署中所有 Team 專案集合資料庫的 GUID，或者同時變更兩者。儘管您一般不會在日常作業中使用這個命令，卻可以在下列情況中使用此命令：

  • 您將部署還原至新的硬體，舊的部署依然在運作中，而您想要同時利用這兩個部署。這種情況有時候稱為複製伺服器。

  • 您想要在複製的部署上測試軟體更新或硬體組態，以便不會有干擾實際執行環境的風險。

  • 您想要完整測試在實驗室或不同環境中，將資料庫還原至新的硬體，以確保可以還原您的部署。

  • 在將集合資料庫移至另一個部署，而其 GUID 已保留時，您就必須重設該集合資料庫的 GUID。

    注意事項注意事項

    ChangeServerID 命令是不可還原的。GUID 已變更之後，除了還原該資料庫的上一個版本之外，您無法恢復該變更。

必要的使用權限

若要使用 ChangeServerID 命令，您必須是 [Team Foundation Administrators] 安全性群組的成員，而且是 Team Foundation Server 使用之任何 SQL Server 資料庫的 [sysadmin] 安全性群組成員。如需詳細資訊，請參閱Team Foundation Server 使用權限。

注意事項注意事項

即使您是使用系統管理認證登入，還是必須開啟更高權限的命令提示字元視窗來執行此功能。

 
TFSConfig ChangeServerID /SQLInstance:ServerName] /DatabaseName:ConfigurationDatabaseName [/ProjectCollectionsOnly] [/ConfigDBOnly] [/usesqlalwayson]

參數

預留位置

描述

ServerName

指定裝載 TFS 之組態資料庫的伺服器的名稱，如果您要使用預設執行個體以外的執行個體，也需要指定該執行個體的名稱。如果您指定執行個體，就必須使用下列格式：

ServerName\InstanceName

DatabaseName

指定組態資料庫的名稱。預設情況下，此資料庫的名稱會是 TFS_ConfigurationDB。

選項

描述

/SQLInstance:ServerName

必要項。指定在執行 SQL Server 之伺服器的名稱。如果您要使用預設執行個體以外的執行個體，也指定執行個體的名稱。如果您指定執行個體，就必須使用下列格式：

ServerName\InstanceName

/DatabaseName:DatabaseName

必要項。指定 TFS 之組態資料庫的名稱。

/ProjectCollectionsOnly

指定只有集合的 GUID 才會變更。

/ConfigDBOnly

指定只有組態資料庫的 GUID 才會變更。

/usesqlalwayson

指定資料庫在 SQL Server 中是 AlwaysOn 可用性群組的一部分。如果已進行設定，這個選項會設定連接字串中的 MultiSubnetFailover。

如需詳細資訊，請參閱 AlwaysOn 可用性群組 (SQL Server)。

備註

您可以使用 ChangeServerID 命令來建立 Team Foundation Server 部署的相異複本，以進行測試或複製。使用 ChangeServerID 命令之後，您必須指引用戶端建立對於已變更伺服器的連接，然後才能加以使用。

範例

下列範例示範如何變更 TFS 之 Contoso1 部署中所有資料庫的 GUID，其中組態資料庫裝載於 SQL Server 之具名執行個體 "TeamDatabases" 上，名為 "ContosoMain" 的伺服器。

注意事項注意事項

範例僅供解說之用，皆為虛構。沒有影射任何真實存在的人事物，也不應推斷為與其有所關聯。

 
TFSConfig ChangeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

請參閱

工作

Move a Team Project Collection

Split a Team Project Collection

概念

備份和還原您的部署

其他資源

使用 TFSConfig 管理伺服器組態