PWA のインスタンスへのチーム プロジェクト コレクションのマップ

Visual Studio Team Foundation Server 2012 とMicrosoft Project Server間でデータを同期する前に、Project Web AccessまたはProject Web App (PWA)のインスタンスにチーム プロジェクト コレクションをマップできますが含まれるいくつかのタスクを実行する必要があります。このマッピングは、TFSAdmin コマンド ライン ツールの次のオプションを使用して管理できます。

• /MapPWAToCollection: チーム プロジェクト コレクションを PWA のインスタンスにマップします。複数のコレクションを 1 つのインスタンスにマップできますが、各コレクションをマップできるインスタンスは 1 つに限られます。コレクションをインスタンスにマップするには、事前にそのインスタンスを登録する必要があります。

• /GetMappedCollections: PWA のインスタンスにマップされているチーム プロジェクト コレクションの一覧を返します。

• /UnmapPWAFromCollection: チーム プロジェクト コレクションと PWA のインスタンスのマッピングを削除します。

これらの製品を統合する方法の全体的な概要については、「Team Foundation Server と Project Server の統合の構成」を参照してください。

TFSAdmin のコマンド ライン ツールを使用するには、またはがインストール Visual Studioチーム エクスプローラー 開き、"コマンド プロンプト ウィンドウを:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

64 ビット版の Windows で、%programfiles% を %programfiles(x86)% に置き換えます。

必要なアクセス許可

これらのコマンドを使用するには、チーム プロジェクト コレクションの [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]

パラメーター

ページのトップへ

解説

コマンドを実行すると、実行中のアクションとその対象となっているオブジェクトを示す確認メッセージが表示されます。たとえば、次のメッセージは、指定した 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/DefulatCollection

マップされているプロジェクト コレクションを一覧表示する

次の例では、AdventureWorksServer に定義されていて、PWA のインスタンスにマップされているチーム プロジェクト コレクションを一覧表示します。

TfsAdmin ProjectServer /GetMappedCollections /tfs:http://AdventureWorksServer:8080/tfs/

チーム プロジェクト コレクションを PWA のインスタンスにマップする

次の例では、AdventureWorksServerで定義されているPWAInstanceにDefaultCollectionをマップします。

TfsAdmin ProjectServer /MapPWAToCollection /pwa:http://PWAServerName/PWAInstance /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

コレクションのマッピングを削除する

次の例ではDefaultCollectionからPWAInstanceのマッピングを削除します。

TfsAdmin ProjectServer /UnmapPWAFromCollection /pwa:http://PWAServerName/PWAInstance /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

ページのトップへ

参照

処理手順

Team Foundation Server と Project Server の統合の構成

概念

データ同期からのコンポーネントの除外

TfsAdmin ProjectServer による Project Server 統合の管理