RemapDBs コマンド
RemapDBs コマンドを使用すると、Visual Studio Team Foundation Server (TFS) のデータベースが複数のサーバーに格納されている場合や、復元や移動などにより配置の構成を変更する場合に、特定のデータベースにリダイレクトできます。たとえば、チーム プロジェクト コレクションのデータベースが構成データベースとは別のサーバーでホストされている場合は、TFS をこれらのデータベースにリダイレクトする必要があります。また、これらのデータベースが構成データベースとは異なるサーバーやインスタンスでホストされている場合は、TFS を SQL Server Analysis Services または SQL Server Reporting Services を実行しているサーバーにリダイレクトする必要もあります。
必要なアクセス許可
RemapDBs コマンドを使用するには、Team Foundation 管理者セキュリティ グループのメンバーであり、Team Foundation Server が使用する SQL Server データベースの sysadmin セキュリティ グループのメンバーでもある必要があります。詳細については、「Team Foundation Server のアクセス許可」を参照してください。
[!メモ]
管理資格情報を使ってログオンしている場合でも、この機能を実行するには、昇格した特権でコマンド プロンプト ウィンドウを開く必要があります。
TFSConfig RemapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2 [/AnalysisInstance:ServerName] [/AnalysisDatabaseName:DatabaseName] [/preview] [/continue] [/usesqlalwayson]
パラメーター
引数 |
説明 |
|---|---|
ServerName |
TFS の 1 つ以上のデータベースをホストするサーバーとしてマップするサーバーの名前を指定します。既定インスタンス以外のインスタンスがデータベースをホストする場合は、次の形式でそのインスタンスの名前を指定する必要もあります。 ServerName\InstanceName |
DatabaseName |
TFS にマップするデータベースの名前を指定します。 |
オプション |
説明 |
|---|---|
/DatabaseName |
TFS のためにマップするデータベースをホストするサーバーの名前と、データベース自体の名前を指定します。 |
/SQLInstances:ServerName1,ServerName2 |
SQL Server を実行しているサーバーの名前と、既定インスタンス以外のインスタンスを使用する場合は、そのインスタンスの名前を指定します。 複数のサーバーを指定する場合は、コンマを使用して複数のサーバー名とインスタンス名の組を区切ります。 |
/AnalysisInstance:ServerName |
省略可能。SQL Server Analysis Services をホストするサーバー名およびインスタンス名を指定します。このオプションを使用して、Analysis Services データベースをホストするサーバーおよびインスタンスを指定します。 |
/AnalysisDatabaseName:DatabaseName |
省略可能。/AnalysisInstance オプションで指定したサーバーにこのようなデータベースが複数ある場合は、TFS で使用する Analysis Services データベースの名前を指定します。 |
/preview |
省略可能。構成を更新する必要のあるアクションを表示します。 |
/continue |
省略可能。1 つ以上のデータベースを検索しようとしたときにエラーが発生しても、RemapDB コマンドを続行する必要があることを指定します。/continue オプションを使用する場合、指定した 1 つ以上のサーバーにデータベースが見つからないコレクションは、構成データベースをホストするサーバーおよびインスタンスを使用するように再構成されます。 |
/usesqlalwayson |
Optional.Specifies that the databases are part of an AlwaysOn Availability Group in SQL Server.If configured, this option sets MultiSubnetFailover in the connection string. For more information, see AlwaysOn Availability Groups (SQL Server). |
解説
RemapDBs コマンドを使用すると、TFS が、元のインストールのサーバーとインスタンスとは異なる SQL Server のサーバーとインスタンスを使用するように構成できます。
使用例
TFS をその構成データベース TFS_Configuration にリダイレクトする方法を次の例に示します。このデータベースは、指定されたインスタンス TeamDatabases の ContosoMain でホストされています。また、このプロジェクト コレクションのデータベースは、ContosoMain\TeamDatabases および Contoso2 の既定インスタンスの両方に格納されています。
[!メモ]
これらの例は、例示のみを目的としており、架空のものです。実際のものとは一切関係ありません。
TFSConfig RemapDBs /DatabaseName:ContosoMain\TeamDatabases;TFS_Configuration /SQLInstances:ContosoMain\TeamDatabases,Contoso2