ChangeServerID コマンドを使用すると、Visual Studio Team Foundation Server のデータベースに関連付けられたグローバル一意識別子 (GUID: Global Universal Identification) を変更できます。 GUID は、Team Foundation Server の配置内で一意である必要があります。 複数のデータベースに同じ GUID を使用している場合、配置が不安定または使用できない状態になる可能性があります。 構成データベースの GUID、配置内のチーム プロジェクト コレクションのデータベースすべての GUID、またはその両方を変更できます。 通常、このコマンドは、日常的な操作では使用しませんが、次のような場合に使用する可能性があります。
配置を新しいハードウェアに復元した後も、古い配置が引き続き動作しているため、両方の配置を利用する場合。 このシナリオは、サーバーの複製とも呼ばれます。
稼動環境が中断されないように、複製された配置でソフトウェア更新プログラムまたはハードウェア構成をテストする場合。
配置を復元できるように、テスト ラボまたは独立した環境内で新しいハードウェアに対してデータベースの復元を十分にテストする場合。
コレクション データベースの GUID を、その GUID が既に予約されている別の配置に移行した後にリセットする必要がある場合。
注意
ChangeServerID コマンドを実行すると元に戻せません。 GUID が変更された後、そのデータベースの以前のバージョンを復元する場合を除き、変更を元に戻すことはできません。
必要なアクセス許可
ChangeServerID コマンドを使用するには、Team Foundation 管理者セキュリティ グループのメンバーであり、Team Foundation Server で使用される SQL Server データベースの sysadmin セキュリティ グループのメンバーでもある必要があります。 詳細については、「Team Foundation Server のアクセス許可」を参照してください。
注意
管理者の資格情報を使ってログオンしている場合でも、Windows Server 2008 を実行中のサーバーでこの機能を実行するには、昇格した特権でコマンド プロンプト ウィンドウを開く必要があります。 昇格した特権でコマンド プロンプト ウィンドウを開くには、[スタート] ボタンをクリックし、[コマンド プロンプト] を右クリックして、[管理者として実行] をクリックします。 詳細については、Microsoft Web サイトの「ユーザー アカウント制御」を参照してください。
TFSConfig ChangeServerID /SQLInstance:ServerName] /DatabaseName:ConfigurationDatabaseName [/ProjectCollectionsOnly] [/ConfigDBOnly]
パラメーター
プレースホルダー |
説明 |
|---|---|
ServerName |
Team Foundation Server の構成データベースをホストしているサーバーの名前と、既定インスタンス以外のインスタンスを使用する場合は、インスタンスの名前を指定します。 インスタンスを指定する場合は、次の形式を使用する必要があります。 ServerName\InstanceName |
DatabaseName |
構成データベースの名前を指定します。 既定では、このデータベースの名前は TFS_ConfigurationDB です。 |
オプション |
説明 |
|---|---|
/SQLInstance:ServerName |
必ず指定します。 SQL Server を実行しているサーバーの名前と、既定インスタンス以外のインスタンスを使用する場合は、そのインスタンスの名前を指定します。 インスタンスを指定する場合は、次の形式を使用する必要があります。 ServerName\InstanceName |
/DatabaseName:DatabaseName |
必ず指定します。 Team Foundation Server の構成データベースの名前を指定します。 |
/ProjectCollectionsOnly |
コレクションの GUID のみが変更されることを指定します。 |
/ConfigDBOnly |
構成データベースの GUID のみが変更されることを指定します。 |
解説
ChangeServerID コマンドは、テストまたは複製の目的で Team Foundation Server の配置を重複して作成する際に使用します。 ChangeServerID コマンドを使用した後、変更されたサーバーを使用できるように、そのサーバーへの接続を作成するようにクライアントに指示する必要があります。
使用例
Team Foundation Server の Contoso1 配置に含まれるすべてのデータベースの GUID を変更する方法を次の例に示します。ここでは、構成データベースは、SQL Server の名前付きインスタンス "TeamDatabases" 上の "ContosoMain" という名前のサーバーでホストされています。
注意
例として登場する企業、組織、製品、ドメイン名、電子メール アドレス、ロゴ、人物、場所、およびイベントはすべて架空のものです。実在する企業、組織、製品、ドメイン名、電子メール アドレス、ロゴ、人物、場所、またはイベントとは一切関係ありません。
TFSConfig ChangeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB