Team Foundation Server への PWA インスタンスの登録
Visual Studio Team Foundation Server 2010 と Microsoft Project Server 2007 または Project Server 2010 との間でデータを同期するには、製品間で複数の統合ポイントを構成しておく必要があります。 最初に、エンタープライズ プロジェクト計画をサポートする Project Web Access または Project Web App (PWA) のインスタンスをチーム プロジェクトを含むチーム プロジェクト コレクションをホストするアプリケーション層サーバーに登録する必要があります。 PWA のインスタンスの登録を管理するには、TFSAdmin ProjectServer コマンド ライン ツールの以下のオプションを使用します。
/RegisterPWA: PWA のインスタンスを Team Foundation Server に登録します。
/GetRegisteredPWA: 登録された PWA のインスタンスとインスタンスが登録されている Team Foundation Server を実行しているサーバーの名前を一覧表示します。
/UnregisterPWA: PWA のインスタンスと Team Foundation Server との間の登録済みの関連付けを削除します。 チーム プロジェクト コレクションまたは Team Foundation Server の配置を移動すると、PWA のインスタンスの登録を削除し、移動後に再登録することが可能になります。
Project Server と Team Foundation Server の構成と統合の詳細については、「Team Foundation Server と Project Server の統合の構成」を参照してください。
TFSAdmin コマンド ライン ツールを使用するには、チーム エクスプローラーおよび Visual Studio Team Foundation Server 2010 Service Pack 1 を実行しているコンピューターでコマンド プロンプト ウィンドウを開きます。Drive:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE ディレクトリからツールを実行します。 64 ビット コンピューターの場合、ツールは Drive:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE にあります。
必要なアクセス許可
コマンドを使用するには、Team Foundation 管理者グループに属している必要があります。 PWA のインスタンスを登録する、または登録を解除するには、インスタンスの管理者グループに属している必要があります。 詳細については、「Team Foundation Server と Project Server を統合するために必要なアクセス許可の割り当て」を参照してください。
注意
管理者のアクセス許可を使ってログオンした場合であっても、Windows Server 2008 を実行中のサーバーでこの機能を実行するには、昇格した特権でコマンド プロンプト ウィンドウを開く必要があります。 昇格した特権でコマンド プロンプト ウィンドウを開くには、[スタート] ボタンをクリックし、[コマンド プロンプト] を右クリックして、[管理者として実行] をクリックします。 詳細については、Microsoft Web サイトの「ユーザー アカウント制御」を参照してください。
構文
TfsAdmin ProjectServer /GetRegisteredPWA /tfs:tfsUrl
TfsAdmin ProjectServer /RegisterPWA /pwa:pwaUrl /tfs:tfsUrl [/previousPwa:pwaUrl] [/force]
TfsAdmin ProjectServer /UnregisterPWA /pwa:pwaUrl /tfs:tfsUrl
パラメーター
パラメーター |
説明 |
|---|---|
/tfs:tfsUrl |
Team Foundation のアプリケーション層サーバーの URL (Uniform Resource Locator) を指定します。 URI は次の形式で指定します。 http://<サーバー名:ポート>/<仮想ディレクトリ名> 仮想ディレクトリを指定しない場合は、次の形式で URL を指定します。 http://<サーバー名:ポート> |
/pwa:pwaUrl |
PWA のインスタンスの URL を指定します。 URL は次の形式で指定します。 http://<PWA のサーバー名>/<PWA のインスタンス> |
/previousPwa:pwaUrl |
PWA のインスタンスについて最後に登録された URL を指定します。 登録されている PWA の URL が変更された場合は、このスイッチを使用して PWA を再登録できます。 URL は次の形式で指定します。 http://<PWA のサーバー名>/<PWA のインスタンス> |
/force |
Team Foundation Server を実行する別のサーバーで PWA のインスタンスを登録し、このインスタンスが最後に登録されたサーバーの登録を解除します。 たとえば、プロジェクト コレクションを別のアプリケーション層サーバーに移動する場合、このコレクションに対応する PWA を新しいサーバーに再登録する必要があります。 |
/? または help |
コマンドに関する情報を表示します。 |
ページのトップへ
解説
TFSAdmin ProjectServer コマンドを実行すると、コマンドが実行中であることを示すメッセージが表示されます。 たとえば、次のメッセージは、Project Web Access のインスタンスが登録中であることを示します。
Registering PWA http:// PWAServerName/PWAInstance/
コマンドが終了すると、別のメッセージが表示されます。 たとえば、次のメッセージは、Project Web Access のインスタンスが Team Foundation Server に登録されたことを示します。
You have successfully registered PWA http://PWAServerName/PWAInstance/
PWA のインスタンスを登録できるのは、Team Foundation の 1 つのアプリケーション層サーバーのみです。 インスタンスをチーム プロジェクト コレクションに関連付けるには、インスタンスをあらかじめ登録しておく必要があります。 インスタンスを登録すると、Team Foundation Server のロケーション サービスがこの情報で更新されます。 さらに、PWA のインスタンスが、統合に必要なカスタム フィールドとルックアップ テーブルで更新されます。
登録コマンドを実行すると、次の操作が発生します。
/RegisterPWA を複数回実行し、登録のレコードが既に存在している場合、次のメッセージが表示されます。
The following PWA instance has already been registered: <PWAInstance>.
/GetRegisteredPWA を実行すると、次の情報が表示されます。
The following PWA instances are registered: PWA URL 1 PWA URL 2/UnRegisterPWA オプションを使用すると、マップされた関連付けだけでなく、PWA のインスタンスからカスタム フィールドとルックアップ テーブルも削除されます。
ページのトップへ
例
各例では、次の値が適用されます。
PWA のインスタンスの URL: http://PWAServerName/PWAInstance/
Team Foundation Server の URL: http://AdventureWorksServer:8080/tfs/
PWA の登録済みインスタンスを一覧表示する
次の例では、AdventureWorksServer に登録された PWA のインスタンスが一覧表示されます。
TfsAdmin ProjectServer /GetRegisteredPWA /tfs:http://AdventureWorksServer:8080/tfs/
PWA のインスタンスを登録する
次の例では、PWAInstance を AdventureWorksServer に登録します。
TfsAdmin ProjectServer /RegisterPWA /pwa:http://PWAServerName/PWAInstance /tfs:http://AdventureWorksServer:8080/tfs/
PWA のインスタンスの登録を削除する
次の例では、AdventureWorksServer から PWAInstance の登録を削除します。
TfsAdmin ProjectServer /UnregisterPWA /pwa:http://PWAServerName/PWAInstance/ /tfs:http://AdventureWorksServer:8080/tfs/
ページのトップへ