다음을 통해 공유


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

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/

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

다음 예제는 AdventureWorksServer에 정의된 PWAInstance에 DefaultCollection을 매핑합니다.

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

컬렉션의 매핑 제거

다음 예제에서는 PWAInstance에서 DefaultCollection의 매핑을 제거합니다.

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

참고 항목

작업

TFS와 Project Server 통합 구성

개념

데이터 동기화에 참여하지 못하도록 구성 요소 제거

통합 구성 요소 매핑[TfsAdmin ProjectServer]