PWA 인스턴스에 팀 프로젝트 컬렉션 매핑

아티클
06/10/2015

Visual Studio Team Foundation Server 및 Microsoft Project Server 간의 데이터를 동기화하기 전에 팀 프로젝트를 컬렉션을 Project Web Access 또는 PWA(Project Web App)의 인스턴스에 매핑하는 작업을 포함한 몇 가지 작업을 수행해야 합니다. TFSAdmin 명령줄 도구의 다음 옵션을 사용하여 이 매핑을 관리할 수 있습니다.

/MapPWAToCollection: 팀 프로젝트 컬렉션을 PWA의 인스턴스에 매핑합니다. 인스턴스에 여러 컬렉션을 매핑할 수 있지만 각 컬렉션을 하나의 인스턴스에만 매핑할 수 있습니다. 컬렉션을 인스턴스에 매핑하려면 먼저 인스턴스를 등록해야 합니다.
/GetMappedCollections: PWA의 인스턴스에 매핑된 팀 프로젝트 컬렉션의 목록을 반환합니다.
/UnmapPWAFromCollection: PWA의 인스턴스에서 팀 프로젝트 컬렉션의 매핑을 제거합니다.

이 제품들을 통합하는 방법에 대한 포괄적인 개요를 보려면 TFS와 Project Server 통합 구성을 참조하십시오.

TFSAdmin 명령줄 도구를 사용하려면 Visual Studio 또는 팀 탐색기 가 설치된 명령 프롬프트 창을 열고 다음을 입력합니다.

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

32비트 버전의 Windows에서는 %programfiles(x86)% 를 **%programfiles%**로 바꿉니다.

요구 사항

이러한 명령을 사용하려면 팀 프로젝트 컬렉션에 대한 사용자의 Administer Project Server integration 권한을 허용으로 설정해야 합니다. 그리고 Team Foundation Server 서비스 계정에 데이터 동기화에 참여할 PWA 인스턴스와 상호 작용하는 데 필요한 권한을 부여해야 합니다. 자세한 내용은 TFS와 Project Server 통합을 지원하기 위한 권한 할당을 참조하십시오.

참고

관리자 권한으로 로그온한 경우에도 Windows Server 2008을 실행하는 서버에 대해 이 기능을 수행하려면 관리자 명령 프롬프트 창을 열어야 합니다.관리자 권한의 명령 프롬프트 창을 열려면 시작을 선택하고 명령 프롬프트에 대한 상황에 맞는 메뉴를 연 후 관리자 권한으로 실행을 선택합니다.자세한 내용은 Microsoft 웹 사이트의 User Access Control 페이지를 참조하십시오.

구문

TfsAdmin ProjectServer /GetMappedCollections /tfs:tfsUrl

TfsAdmin ProjectServer /MapPWAToCollection /pwa:pwaUrl /collection:tpcUrl

TfsAdmin ProjectServer /UnmapPWAFromCollection /pwa:pwaUrl /collection:tpcUrl [/force]

매개 변수

Parameter	설명
/tfs:tfsUrl	Team Foundation용 응용 프로그램 계층 서버의 URL(Uniform Resource Locator)을 지정합니다. URL을 다음 형식으로 지정합니다. http://ServerName:Port/VirtualDirectoryName 가상 디렉터리를 지정하지 않을 경우 다음 형식으로 URI를 지정해야 합니다. http://ServerName:Port
/pwa:pwaUrl	PWA 인스턴스의 URL을 지정합니다. URL을 다음 형식으로 지정합니다. http://PWAServerName/PWA
/collection:tpcUrl	팀 프로젝트 컬렉션의 URL을 지정합니다. URL을 다음 형식으로 지정합니다. http://ServerName:Port/VirtualDirectoryName/CollectionName 가상 디렉터리를 지정하지 않을 경우 다음 형식으로 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의 인스턴스에서 컬렉션을 매핑 해제하기 전에 팀 프로젝트 컬렉션에 대해 매핑된 모든 팀 프로젝트와 Enterprise 프로젝트 계획을 먼저 매핑 해제해야 합니다. /UnmapPWAFromCollection 옵션을 실행할 때 프로젝트가 매핑되는 경우 메시지는 /UnmapPlanFromProject 옵션을 먼저 사용해야 한다고 알려줍니다. 또는 /force 플래그를 사용하여 컬렉션에서 모든 팀 프로젝트의 모든 매핑을 제거할 수 있습니다.

/GetMappedProjects 옵션을 실행하여 매핑된 프로젝트 목록을 표시할 수 있습니다. 자세한 내용은 Enterprise 프로젝트와 팀 프로젝트 간의 매핑 관리을 참조하십시오.

프로젝트가 매핑되지 않은 컬렉션에서 /UnmapPWAFromCollection 을 실행하면 명령은 매핑 뿐만 아니라 전역 규칙도 제거합니다.

예제

각 예제에서 다음 값이 적용됩니다.

Pwa 인스턴스에 대 한 URL: http:// PWAServerName/PWAInstance/
Team Foundation Server용 URL: http://AdventureWorksServer:8080/tfs/
팀 프로젝트 컬렉션 URL: http://AdventureWorksServer:8080/tfs/DefaultCollection

매핑된 프로젝트 컬렉션 목록

다음 예제에서는 AdventureWorksServer에 정의되어 있고 PWA의 인스턴스에 매핑되는 팀 프로젝트 컬렉션의 목록을 표시합니다.

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