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

Статья
06/10/2015

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

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

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

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

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

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

Требования

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

Примечание

Даже если вход в систему выполнен с разрешениями администратора, чтобы выполнить эту функцию на сервере с операционной системой 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://ServerName:Port/VirtualDirectoryName Если не указан виртуальный каталог, необходимо задать URI в следующем формате: http://ServerName:Port
/pwa:pwaUrl	Задает URL экземпляра PWA. Для указания 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.

После завершения работы команды появится еще одно сообщение. Например, следующее сообщение указывает, что экземпляра веб-клиента 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-адрес экземпляра PWA. http:// PWAServerName/PWAInstance/
URL-адрес для Team Foundation Server: http://AdventureWorksServer:8080/tfs/
URL-адреса для коллекции командных проектов. http://AdventureWorksServer:8080/tfs/DefulatCollection

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

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

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