Настройка типов рабочих элементов и управление ими [witadmin]
Управление типами рабочих элементов, определенными для командного проекта, осуществляется с помощью следующих команд witadmin:
destroywitd: уничтожает тип рабочего элемента и уничтожает каждый рабочий элемент этого типа без возможности восстановления.
exportwitd: экспортирует определение типа рабочего элемента в XML-файл или в окно командной строки.
importwitd: импортирует типы рабочих элементов из XML-файла определения в командный проект на сервере, на котором работает Team Foundation Server. Если тип рабочего элемента с таким именем уже существует, новое определение типа рабочего элемента переопределяет существующее. Если тип рабочего элемента еще не существует, эта команда создает новый тип рабочего элемента. Чтобы проверить XML-код, определяющий тип рабочего элемента, но не импортировать этот файл, следует использовать параметр /v.
listwitd: отображает имена типов рабочих элементов в указанном проекте в окне командной строки.
renamewitd: изменяет отображаемое имя типа рабочего элемента в пределах определенного проекта. После выполнения данной команды рабочие элементы этого типа показывают новое имя.
Программа командной строки 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 destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]
witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]
witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]
witadmin listwitd /collection:CollectionURL /p:Project
witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]
Параметры
Параметр |
Описание |
|---|---|
/collection:CollectionURL |
Задает универсальный код ресурса (URI) коллекции командных проектов. URI имеет следующий формат: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции Если виртуальный каталог не используется, URI имеет следующий формат: http://имя_сервера:порт/имя_коллекции |
/p:Проект |
Командный проект, для которого будут управляться типы рабочих элементов. Командный проект должен быть определен в коллекции проектов, указанной параметром /collection. Параметр /p является обязательным, пока не будет выполнена команда importwitd с параметром /v. |
/n:TypeName |
Имя типа рабочего элемента для уничтожения, экспорта, импорта или переименования. |
/f:FileName |
Путь и имя XML-файла определения, содержащего типы рабочих элементов для экспорта или импорта. Если опустить этот параметр при использовании команды exportwitd, то в окне командной строки появляется XML. .gif "Примечание") Примечание
При использовании Windows Vista не обязательно иметь разрешения, установленные для определенных папок.При попытке экспорта типа рабочего элемента в расположение, к которому отсутствуют права доступа, технология виртуализации реестра автоматически перенаправит экспортируемый файл и сохранит его в виртуальном хранилище.Во избежание такого перенаправления можно экспортировать файл в расположение, где действуют разрешения. Дополнительные сведения о виртуализации реестра см. на следующих страницах веб-сайта корпорации Майкрософт: Registry Virtualization и Типовые проблемы виртуализации файлов и реестра в Windows Vista.
|
/e:Кодировка |
Имя формата кодирования .NET Framework 2.0. Команда использует указанную кодировку для экспорта или импорта XML-данных. Например, /e:utf-7 задает кодировку Юникод (UTF-7). Если этот параметр не указан, то witadmin пытается определить кодировку и в случае сбоя обнаружения witadmin использует UTF-8. |
/exportgloballists |
Экспорт определений глобальных списков, на которые ссылается тип рабочего элемента. Определения глобальных списков будут встроены в XML-определение типа рабочего элемента. Если этот параметр не указан, определения глобальных списков пропускаются. |
/v |
Проверяет XML-код, определяющий тип рабочего элемента, но не импортирует файл XML-определения. Примечание
Определение типа можно проверить без указания командного проекта.Ссылки на группы области проекта игнорируются.
|
/new:NewName |
Новое имя типа рабочего элемента. |
/noprompt |
Отключает запрос подтверждения. |
/? или help |
Отображает справку по команде в окне командной строки. |
Заметки
При использовании команда destroywitd уничтожает все следующие объекты:
Тип рабочего элемента
Все рабочие элементы этого типа
Соответствующие записи в таблицах рабочих элементов, таблицах длинных текстов и таблицах ссылок
Объекты в кэше метаданных типа рабочего элемента
Примеры
Если не указано иначе, во всех примерах применяются следующие значения:
URI коллекции командного проекта: http://AdventureWorksServer:8080/AWTeam/Collection1
Имя проекта: AdventureWorks
Имя входного или выходного файла: myworkitems.xml
Имя типа рабочего элемента: myworkitem
Кодировка по умолчанию: UTF-8
Экспорт определения типа рабочего элемента
Следующая команда экспортирует определение myworkitem в файл myworkitems.xml.
witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myworkitems.xml /n:myworkitem
В этом примере тип рабочего элемента экспортируется в кодировке Юникод (UTF-7).
witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7
Экспорт определения типа рабочего элемента и глобальных списков, на которые он ссылается.
В следующем примере экспортируется тип рабочего элемента и глобальные списки, на которые он ссылается.
witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists
Список определений типов рабочих элементов
В следующем примере отображается определение типа рабочего элемента в окне командной строки.
witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /n:myworkitem
Импорт определения типов рабочих элементов
В следующем примере производится импорт определения рабочего элемента из XML-файла.
witadmin importwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks
Проверка XML-определения типов рабочих элементов
В следующем примере выполняется проверка XML-кода, определяющего тип рабочего элемента, но не выполняется импорт определения.
witadmin importwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks /v