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

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

  • Статья

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

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

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

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

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

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

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

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

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

cd %programfiles(x86)%\Microsoft Visual Studio 14.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. Настройка объектов для отслеживания рабочих элементов и управление этими объектами