Сопоставление коллекции командных проектов с экземпляром PWA

Статья
02/20/2013

Прежде чем можно будет синхронизировать данные между Visual Studio Team Foundation Server 2012 и проектов сервера Microsoft, необходимо выполнить несколько задач, которые включают сопоставления коллекцию командных проектов, к экземпляру доступа через интернет проекта или Project App Web (PWA).Можно управлять данным сопоставлением с помощью следующих параметров инструмента командной строки TFSAdmin:

/MapPWAToCollection: Сопоставляет коллекцию командного проекта с экземпляром веб-клиента Project.Можно сопоставить несколько коллекций с экземпляром, но каждая коллекция может быть сопоставлена только с одним экземпляром.Перед сопоставлением коллекции с экземпляром необходимо зарегистрировать экземпляр.
/GetMappedCollections: Возвращает список коллекций командного проекта, которые были сопоставлены с экземпляром веб-клиента Project.
/UnmapPWAFromCollection Удаляет сопоставление коллекции командного проекта из экземпляра веб-клиента Project.

Более подробные сведения о способах интеграции этих продуктов см. в разделе Настройка интеграции Team Foundation Server и Project Server.

Для использования программы командной строки TFSAdmin, откройте окно командной строки, в которой Visual Studio или установлены или Team Explorer и ввод:

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

В 64-разрядной версии Windows замените %programfiles% на %programfiles(x86)%.

Необходимые разрешения

Для использования этих команд разрешению Администрирование интеграции Project Server для коллекции командного проекта должно быть присвоено значение Разрешить.Кроме того, учетной записи службы Team Foundation Server необходимо предоставить соответствующие разрешения на взаимодействие с экземпляром PWA, который будет участвовать в синхронизации данных.Дополнительные сведения см. в разделе Назначение разрешений для поддержки интеграции Project Server и Team Foundation Server.

Примечание
Даже если вход в систему выполнен с разрешениями администратора, чтобы выполнить эту функцию на сервере с операционной системой Windows Server 2008, необходимо открыть окно командной строки с повышенными привилегиями.Чтобы открыть окно командной строки с повышенными привилегиями, выберите Пуск, откройте контекстное меню пункта Командная строка и выберите команду Запуск от имени администратора.Дополнительные сведения см. на следующей странице веб-сайта Майкрософт: Контроль учетных записей.

Даже если вход в систему выполнен с разрешениями администратора, чтобы выполнить эту функцию на сервере с операционной системой Windows Server 2008, необходимо открыть окно командной строки с повышенными привилегиями.Чтобы открыть окно командной строки с повышенными привилегиями, выберите Пуск, откройте контекстное меню пункта Командная строка и выберите команду Запуск от имени администратора.Дополнительные сведения см. на следующей странице веб-сайта Майкрософт: Контроль учетных записей.

Синтаксис

TfsAdmin ProjectServer /GetMappedCollections /tfs:tfsUrl 

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

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

Параметры

Параметр	Описание
/tfs:tfsUrl	Задает URL-адрес сервера уровня приложений для Team Foundation.Для указания URL-адреса применяется следующий формат: http://имя_сервера:порт/имя_виртуального_каталога Если не указан виртуальный каталог, необходимо задать URI в следующем формате: http://имя_сервера:порт
/pwa:Url_pwa	Задает URL экземпляра PWA.Для указания URL-адреса применяется следующий формат: http://имя_сервера_PWA/PWA
/collection:tpcUrl	Указывает универсальный код ресурса (URL) коллекции командных проектов.Для указания URL-адреса применяется следующий формат: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции Если не указан виртуальный каталог, необходимо задать URI в следующем формате: http://имя_сервера:порт/имя_коллекции
/force	Необязательный параметр.Доступно только для параметра /UnmapPWAFromCollection.Удаляет все сопоставления для всех проектов рабочей группы в коллекции.Необходимо задать этот параметр, только если точно известно, что больше не требуются командные проекты в коллекции для продолжения участия в синхронизации данных.
/? или help	Отображает информацию о команде.

К началу

Заметки

При выполнении команды возникающее сообщение подтверждает выполняемое действие и объект этого действия.Например следующее сообщение указывает, что заданный экземпляр PWA сопоставляется:

Mapping Project Web Access:http://MyPWAServer/MyPWAInstance/ . . . Done.

После завершения работы команды появится еще одно сообщение.Например, следующее сообщение указывает, что экземпляра веб-клиента Project зарегистрирован с Team Foundation Server:

Mapping team project collection http://MyTFSServer:8080/tfs/Collection0 to PWA http://MyPWAServer/MyPWAInstance/.

При сопоставлении коллекции командных проектов, выполняются следующие операции:

Служба расположения для коллекции обновляется с сопоставлением.
Глобальные правила и поля в коллекции созданы.
Механизм синхронизации регистрируется в службе задания.

Прежде чем можно удалить сопоставление коллекции из экземпляра веб-клиента Project, вы должны сначала удалить сопоставление всех командных проектов и планов проекта предприятия, которые сопоставлены для коллекции командного проекта.Если существует сопоставление проектов при запуске параметра /UnmapPWAFromCollection, сообщение уведомит, что необходимо сначала использовать параметр /UnmapPlanFromProject.В качестве альтернативы можно использовать флаг /force, чтобы удалить все сопоставления для всех проектов рабочей группы в коллекции.

Можно отобразить список сопоставленных проектов, запустив параметр /GetMappedProjects.Дополнительные сведения см. в разделе Управление сопоставлениями между корпоративным и командным проектами.

При использовании /UnmapPWAFromCollection на коллекцию, к которой нет сопоставленных проектов, команда удаляет не только сопоставления, но также глобальные правила.

К началу

Примеры

В каждом примере применяются следующие значения:

URL-адрес для экземпляра веб-клиента Project: http:// имя_сервера_веб-клиента_Project/экземпляр_веб-клиента_Project/
URL-адрес для Team Foundation Server: http://AdventureWorksServer:8080/tfs/
URL-адрес для коллекции командных проектов: http://AdventureWorksServer:8080/tfs/DefulatCollection

Список коллекций проектов, для которых выполнено сопоставление.

В следующем примере перечисляются коллекции командных проектов, которые определены в AdventureWorksServer и сопоставляются с экземпляром веб-клиента Project.

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