PWA インスタンスへのチーム プロジェクト コレクションのマッピング
Visual Studio Team Foundation Server 2010 と Microsoft Project Server 2007 Service Pack 2 (SP2) または Project Server 2010 のデータを同期するには、事前にいくつかのタスクを実行して、チーム プロジェクト コレクションを Project Web Access または Project Web App (PWA) のインスタンスにマップする必要があります。 このマッピングは、TFSAdmin コマンド ライン ツールの次のオプションを使用して管理できます。
/MapPWAToCollection: チーム プロジェクト コレクションを PWA のインスタンスにマップします。 複数のコレクションを 1 つのインスタンスにマップできますが、各コレクションをマップできるインスタンスは 1 つに限られます。 コレクションをインスタンスにマップするには、事前にそのインスタンスを登録する必要があります。
/GetMappedCollections: PWA のインスタンスにマップされているチーム プロジェクト コレクションの一覧を返します。
/UnmapPWAFromCollection: チーム プロジェクト コレクションと PWA のインスタンスのマッピングを削除します。
これらの製品を統合する方法の全体的な概要については、「Team Foundation Server と Project Server の統合の構成」を参照してください。
TFSAdmin コマンド ライン ツールを使用するには、チーム エクスプローラーおよび Visual Studio 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 にあります。
必要なアクセス許可
これらのコマンドを使用するには、チーム プロジェクト コレクションの [Project Server の統合の管理] アクセス許可が [許可] に設定されている必要があります。 また、Team Foundation Server のサービス アカウントに、データ同期に参加する PWA のインスタンスと対話するために必要なアクセス許可が付与されている必要があります。 詳細については、「Team Foundation Server と Project Server を統合するために必要なアクセス許可の割り当て」を参照してください。
注意
管理者のアクセス許可を使ってログオンした場合であっても、Windows Server 2008 を実行中のサーバーでこの機能を実行するには、昇格した特権でコマンド プロンプト ウィンドウを開く必要があります。 昇格した特権でコマンド プロンプト ウィンドウを開くには、[スタート] ボタンをクリックし、[コマンド プロンプト] を右クリックして、[管理者として実行] をクリックします。 詳細については、Microsoft Web サイトの「ユーザー アカウント制御」を参照してください。
構文
TfsAdmin ProjectServer /GetMappedCollections /tfs:tfsUrl
TfsAdmin ProjectServer /MapPWAToCollection /pwa:pwaUrl /collection:tpcUrl
TfsAdmin ProjectServer /UnmapPWAFromCollection /pwa:pwaUrl /collection:tpcUrl [/force]
パラメーター
パラメーター |
説明 |
|---|---|
/tfs:tfsUrl |
Team Foundation のアプリケーション層サーバーの URL (Uniform Resource Locator) を指定します。 URL は次の形式で指定します。 http://<サーバー名:ポート>/<仮想ディレクトリ名> 仮想ディレクトリを指定しない場合は、次の形式で URI を指定します。 http://<サーバー名:ポート> |
/pwa:pwaUrl |
PWA のインスタンスの URL を指定します。 URL は次の形式で指定します。 http://<PWA のサーバー名>/<PWA> |
/collection:tpcUrl |
チーム プロジェクト コレクションの URL を指定します。 URL は次の形式で指定します。 http://<サーバー名:ポート>/<仮想ディレクトリ名>/<コレクション名> 仮想ディレクトリを指定しない場合は、次の形式で URI を指定します。 http://ServerName:Port/CollectionName |
/force |
省略可能です。 /UnmapPWAFromCollection オプションを指定した場合にのみ使用できます。 コレクション内のすべてのチーム プロジェクトのすべてのマッピングを削除します。 チーム プロジェクトがマップされているコレクションをマップ解除することはできません。 このオプションは、今後コレクション内のすべてのチーム プロジェクトをデータ同期から除外してもよい場合にのみ指定してください。 |
/? または help |
コマンドに関する情報を表示します。 |
ページのトップへ
解説
コマンドを実行すると、実行中のアクションとその対象となっているオブジェクトを示す確認メッセージが表示されます。 たとえば、次のメッセージは、指定した PWA インスタンスのマップ中であることを示しています。
Mapping Project Web Access:http://MyPWAServer/MyPWAInstance/ . . . Done.
コマンドが終了すると、別のメッセージが表示されます。 たとえば、次のメッセージは、PWA のインスタンスが Team Foundation Server に登録されたことを示します。
Mapping team project collection http://MyTFSServer:8080/tfs/Collection0 to PWA http://MyPWAServer/MyPWAInstance/.
チーム プロジェクト コレクションをマップすると、次の操作が実行されます。
コレクションのロケーション サービスがそのマッピングで更新されます。
コレクションのグローバル規則およびフィールドが作成されます。
同期エンジンがジョブ サービスに登録されます。
PWA のインスタンスからコレクションをマップ解除するには、事前に、そのチーム プロジェクト コレクションに対してマップされているすべてのチーム プロジェクトとエンタープライズ プロジェクト計画をマップ解除する必要があります。 /UnmapPWAFromCollection オプションを実行したときにプロジェクトがマップされている場合、最初に /UnmapPlanFromProject オプションを使用する必要があることを通知するメッセージが表示されます。 別の方法として、/force フラグを使用して、コレクション内のすべてのチーム プロジェクトのすべてのマッピングを削除することもできます。
/GetMappedProjects オプションを実行して、マップされているプロジェクトの一覧を表示できます。 詳細については、「エンタープライズ プロジェクトとチーム プロジェクトの間のマッピングの管理」を参照してください。
プロジェクトがマップされていないコレクションに対して /UnmapPWAFromCollection を実行すると、マッピングだけでなく、グローバル規則も削除されます。
ページのトップへ
例
各例では、次の値が適用されます。
PWA のインスタンスの URL: http://PWAServerName/PWAInstance/
Team Foundation Server の URL: http://AdventureWorksServer:8080/tfs/
チーム プロジェクト コレクションの URL: http://AdventureWorksServer:8080/tfs/Collection0
マップされているプロジェクト コレクションを一覧表示する
次の例では、AdventureWorksServer に定義されていて、PWA のインスタンスにマップされているチーム プロジェクト コレクションを一覧表示します。
TfsAdmin ProjectServer /GetMappedCollections /tfs:http://AdventureWorksServer:8080/tfs/
チーム プロジェクト コレクションを PWA のインスタンスにマップする
次の例では、AdventureWorksServer に定義されている Collection0 を PWAInstance にマップします。
TfsAdmin ProjectServer /MapPWAToCollection /pwa:http://PWAServerName/PWAInstance /collection:http://AdventureWorksServer:8080/tfs/Collection0
コレクションのマッピングを削除する
次の例では、Collection0 と PWAInstance のマッピングを削除しています。
TfsAdmin ProjectServer /UnmapPWAFromCollection /pwa:http://PWAServerName/PWAInstance /collection:http://AdventureWorksServer:8080/tfs/Collection0
ページのトップへ