Настройка категорий для типов рабочих элементов [witadmin]
Управление категориями типов рабочих элементов, определенными для командного проекта, осуществляется с помощью следующих команд witadmin:
exportcategories: экспортирует XML-определения категорий, заданные на сервере, на котором запущен Team Foundation Server.
importcategories: импортирует XML-файл определения типа рабочего элемента в командный проект на сервере, на котором работает Team Foundation Server.
Если категория с тем же именем уже существует, эта команда переопределяет существующее определение. Если тип рабочего элемента еще не существует, эта команда создает новую категорию.
Программа командной строки 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, необходимо открыть окно командной строки с повышенными привилегиями.Чтобы открыть окно командной строки с повышенными привилегиями, нажмите кнопку Пуск, щелкните правой кнопкой мыши пункт Командная строка и выберите команду Запуск от имени администратора.Дополнительные сведения см. в разделе Контроль учетных записей на веб-сайте корпорации Майкрософт.
witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding]
witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding]
Параметры
Параметр |
Описание |
|---|---|
/collection:CollectionURL |
Задает универсальный код ресурса (URI) коллекции командных проектов. URI имеет следующий формат: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции Если виртуальный каталог не используется, URI имеет следующий формат: http://ИмяСервера:Порт/ИмяКоллекции. |
/p:Project |
Имя командного проекта, из которого экспортируются категории или в который они импортируются. |
/f:FileName |
Путь и имя XML-файла определения, содержащего категории для экспорта или импорта. Если опустить этот параметр при использовании команды exportcategories, то команда выводит список категорий в окне командной строки. |
/e:кодирование |
Имя формата кодирования .NET Framework 2.0. Указанное кодирование будет использоваться для экспорта или импорта XML-данных. Например, /e: utf-7 задает кодировку Юникод (UTF-7). Если этот параметр не указан, то witadmin пытается определить кодировку и в случае сбоя обнаружения witadmin использует UTF-8. |
/? или help |
Отображает справку по команде в окне командной строки. |
Заметки
Импорт файла категорий создает категории, если они еще не существуют. Если категории уже существуют, команда witadmin importcategories предупредит об опасности перезаписи текущего списка. Можно написать собственную программу для обновления существующего набора категорий или самостоятельно обновить глобальный список, используя новые данные.
Сведения о структуре категорий XML-файлов см. в разделе Справочник по схеме определения категорий.
Примеры
Если не указано иначе, во всех примерах применяются следующие значения:
URI коллекции командного проекта: http://AdventureWorksServer:8080/AWTeam/Collection1
Имя проекта: AdventureWorks
Имя входного или выходного файла: myCategories.xml
Кодировка по умолчанию: UTF-8
Список категорий типов рабочих элементов
Следующая команда отображает список категорий типов рабочих элементов, определенных для проекта AdventureWorks.
witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks
Экспорт категорий типов рабочих элементов
Следующая команда экспортирует категории типов рабочих элементов, определенных для проекта AdventureWorks, в XML-файл myCategories.
witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml
Импорт категорий типов рабочих элементов
В следующем примере производится импорт категорий из XML-файла myCategories в проект AdventureWorks.
witadmin importcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml
См. также
Другие ресурсы
Группирование типов рабочих элементов по категориям
Работа с категориями типов рабочих элементов
witAdmin. Администрирование объектов для отслеживания рабочих элементов