Настройка типов связей и управление ими [witadmin]

Статья
08/11/2011

Управление типами связей, определенными для коллекции командных проектов, осуществляется с помощью следующих команд witadmin:

deactivatelinktype: деактивирует указанный тип связи. Пользователи больше не смогут создавать связи данного типа. Существующие ссылки этого типа будут продолжать работать правильно.
deletelinktype: окончательно удаляет указанный тип связи из базы данных. Также удаляются все ссылки, определенные с помощью этого типа связи.
exportlinktype: экспортирует определения типов связей. Экспортировать можно определение одного типа связи или всех типов связей, определенных для сервера.
importlinktype: импортирует определения типов связей из XML-файла. Если тип связи с тем же именем ссылки уже существует, он будет обновлен для соответствия импортированному типу связи. Если тип связи еще не существует, то будет создан новый тип связи.
listlinktypes: приводит доступный набор типов связей на сервере.
reactivatelinktype: повторно активирует указанный тип связи и при необходимости назначает новое имя.

Программа командной строки witadmin расположена в каталоге Диск:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE на клиентском компьютере, на котором работает Сред. Командный обозреватель.

Примечание

Можно создавать и изменять типы ссылок, используя редактор процесса, автоматический инструмент для Visual Studio.Это средство не поддерживается.Дополнительные сведения см. на следующей странице веб-сайта Майкрософт: Team Foundation Server Power Tools April 2010.

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

Для коллекции проекта, где определены типы ссылок, необходимо иметь следующий набор разрешений:

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

Дополнительные сведения см. в разделах Разрешения Team Foundation Server и Группы по умолчанию, права и роли в Team Foundation Server.

Примечание

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

witadmin deactivatelinktype /collection:CollectionURL /n:LinkName

witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]

witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding] 

witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]

witadmin listlinktypes /collection:CollectionURL

witadmin reactivatelinktype /collection:CollectionURL /n:LinkName

Параметры

Параметр	Описание
/collection:CollectionURL	Задает универсальный код ресурса (URI) коллекции командных проектов. URI имеет следующий формат: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции Примеры. http: //ИмяСервера:8080/tfs/Collection0 Если виртуальный каталог не используется, то универсальный код ресурса (URI) имеет следующий формат: http://имя_сервера:порт/имя_коллекции
/n:LinkName	Имя или имя ссылки типа связи для отключения или удаления.
/f:FileName	XML-файл типов связей. Требуется для импорта, необязательно для экспорта. Если опустить этот параметр, то на экране появляется выходной результат команды.
/e:encoding	Имя формата кодирования .NET Framework 2.0. Указанное кодирование будет использоваться для экспорта или импорта XML-данных. Например, /e:utf-7 задает кодировку Юникод (UTF-7). Если этот параметр не указан, то witadmin пытается определить кодировку и в случае сбоя обнаружения witadmin использует UTF-8.
/v	Проверяет тип связи XML без ее импорта.
/noprompt	Отключает запрос подтверждения.
/? или help	Отображает справку по команде в окне командной строки.

Заметки

Структуру схемы определения типов связей см. в разделе Работа с типами связей.

Примеры

Если не указано иначе, во всех примерах применяются следующие значения:

URI коллекции командного проекта: http://AdventureWorksServer:8080/AWTeam/Collection1
Имя сервера: AdventureWorksServer
Имя входного или выходного файла: myLinkTypes.xml
Имя типа связи: mylinktype
Кодировка по умолчанию: UTF-8

Список типов связей

Следующая команда отображает пользовательские типы связей, определенные для AdventureWorksServer Team Foundation.

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Список определений типов связей

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

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Деактивация и повторная активация типа связи

В следующих примерах выполняется деактивация типа связи mylinktype, а затем повторная его активация.

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype

Экспорт определения типа связи.

Следующая команда экспортирует определение всех типов связей в файл mylinktype.xml:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml

Импорт определения типов связей

В следующем примере производится импорт определения типов связей, заданных в XML-файле:

witadmin importlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml

См. также

Поделиться через