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

Управление типами связей [witadmin]

  • Статья

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

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

  • deactivatelinktype: отключает указанный тип ссылки. Пользователи больше не смогут создавать ссылки такого типа. Существующие ссылки этого типа продолжат работать.

  • deletelinktype: безвозвратно удаляет указанный тип ссылки из базы данных. Все ссылки, определенные с использованием этого типа ссылок, также удаляются.

  • exportlinktype: экспортирует определения типов ссылок. Вы можете экспортировать определение отдельного типа ссылок или всех типов ссылок, определенных для данного сервера.

  • importlinktype: импортирует определения типов ссылок из XML-файла. Если тип ссылок с таким именем ссылки уже существует, он обновляется для соответствия импортированному типу ссылок. Если тип ссылок еще не существует, создается новый тип.

  • listlinktypes: создает список доступных типов ссылок на сервере.

  • reactivatelinktype: реактивирует указанный тип ссылок и позволяет назначить ему новое имя.

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

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

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

Требования

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

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

  • Для удаления, импорта или реактивации типов ссылок вы должны быть членом группы безопасности Администраторы коллекции проектов либо иметь разрешение Управление типами ссылок рабочих элементов со значением Разрешить.

Для получения дополнительной информации см. Справочник по разрешениям Team Foundation Server.

Примечание

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

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://ServerName: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

Отображает справку по команде в окне командной строки.

Заметки

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

Сведения о том, как можно ограничить типы отношений ссылок, доступные членам команды, см. в разделах Справочник по элементам управления, ограничениям и полям связей и Элементы LinksControlOptions.

Примеры

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

  • URI-адрес коллекции командных проектов: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Имя сервера: AdventureWorksServer

  • Имя входного или выходного файла: myLinkTypes.xml

  • Имя типа ссылок: mylinktype

  • Кодировка по умолчанию: UTF-8

Список типов ссылок

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

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

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

Следующий пример кода выводит определение типа ссылок в окне командной строки:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Отключение и повторная активация типа ссылок

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

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype

Экспорт определения типов ссылок

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

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Импорт определения типов ссылок

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

witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

См. также

Основные понятия

Справочник по элементам типов связей

Справочник по элементам управления, ограничениям и полям связей

Другие ресурсы

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

witAdmin. Настройка объектов для отслеживания рабочих элементов и управление этими объектами