Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Внимание
Для локальной модели процесса XML можно использовать witadmin для перечисления, импорта, экспорта и изменения процесса для проекта. Для моделей процессов наследуемого и размещенного XML можно использовать только witadmin для перечисления и экспорта сведений о процессе. Общие сведения о моделях процессов и поддерживаемых функциях см. в разделе "Настройка процесса отслеживания работы".
Средство командной строки witadmin позволяет настроить отслеживание работы путем создания, удаления, импорта и экспорта таких объектов, как типы рабочих элементов, категории, глобальные списки, глобальные рабочие процессы и типы ссылок. Вы также можете управлять атрибутами поля рабочего элемента.
Для локального сервера Azure DevOps Server можно также управлять типами разрешений, типом ошибок и типами сбоев, используемыми при управлении тестовых случаев с помощью команды tcm fieldmapping .
На следующей схеме показана область объектов отслеживания работы. Категории и типы рабочих элементов управляются на уровне проекта. Глобальные списки, типы ссылок и поля рабочих элементов управляются на уровне коллекции проектов. Глобальный рабочий процесс можно настроить для проекта или коллекции.
Для выполнения большинства команд witadmin необходимо быть членом группы "Администраторы проектов " или " Администраторы коллекции проектов ". Дополнительные сведения см. в разделе Изменение разрешений на уровне коллекции проекта.
Запустите программу командной строки witadmin
Программа командной строки witadmin устанавливается в Visual Studio. Откройте окно командной строки и перейдите в каталог, в котором установлена Visual Studio. Вы также можете установить бесплатный выпуск Visual Studio Community .
Примечание.
Для Azure DevOps Services используйте последнюю версию Visual Studio.
Примечание.
Для локального сервера Azure DevOps используйте ту же или более позднюю версию Visual Studio. Например, используйте Visual Studio 2019 или более поздней версии для подключения к Azure DevOps Server 2019.
%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
Community
ProfessionalЗамените или в Enterprise зависимости от установленной версии.
В 32-разрядном выпуске Windows замените %programfiles(x86)% на %programfiles%.
Подсказка
Вы можете использовать ИИ, чтобы помочь с задачами Azure DevOps. См. статью "Включение AI-ассистента в сервере MCP Azure DevOps", чтобы начать.
Глобальные параметры
Следующие параметры отображают текст справки для команд witadmin.
| Параметр | Описание |
|---|---|
/? или help |
Отображает синтаксис и параметры для средства командной строки witadmin. |
command /help или command /? |
Отображает синтаксис и параметры для указанной команды witadmin. |
XML-файлы определения
Объекты отслеживания работы настраиваются путем обновления определений XML. Объекты включают типы рабочих элементов, конфигурацию процесса, глобальные списки и типы ссылок. Общие сведения о параметрах настройки см. в разделе "Настройка взаимодействия с отслеживанием работы".
Команды witadmin можно запускать в Azure DevOps Services или Azure DevOps Server. Однако Azure DevOps Services поддерживает только команды, которые перечисляют или экспортируют определения. Операции импорта и изменения доступны только для Azure DevOps Server.
Типы рабочих элементов
Типы рабочих элементов определяют поля и рабочий процесс для отслеживания работы. Доступные типы зависят от процесса проекта (Agile, Scrum, Basic или CMMI). Дополнительные сведения см. в разделе "Сведения о рабочих элементах".
Для модели наследуемого процесса управляйте типами рабочих элементов на веб-портале. Дополнительные сведения см. в разделе "Добавление типов рабочих элементов и управление ими".
Command
Azure DevOps Services
Сервер Azure DevOps
destroywitd: удаление типа рабочего элемента
✔️
exportwitd: экспорт файла типа рабочего элемента
✔️
✔️
importwitd: импорт файла типа рабочего элемента
✔️
listwitd: вывод списка типов рабочих элементов
✔️
✔️
renamewitd: изменение отображаемого имени для типа рабочего элемента
✔️
Поля
Поля хранят состояние и сведения в рабочих элементах. Поля определяются на уровне организации или коллекции. Дополнительные сведения см. в разделах "Поля рабочего элемента" и "Атрибуты" и"Индекс поля рабочего элемента".
Для модели наследуемого процесса управляйте полями с веб-портала. Дополнительные сведения см. в разделе "Добавление полей и управление ими".
Command
Azure DevOps Services
Сервер Azure DevOps
deletefield: удаление поля
✔️
listfields: перечисление атрибутов поля
✔️
✔️
changefield: изменение атрибута поля
✔️
renamewitd: изменение отображаемого имени WIT
✔️
Категории
Категории группировать один или несколько типов рабочих элементов вместе. Azure Boards использует определения категорий, чтобы определить, какие типы рабочих элементов отображаются в невыполненных работах и досках. Дополнительные сведения см. в разделе "Использование категорий для группирования типов рабочих элементов".
Command
Azure DevOps Services
Сервер Azure DevOps
exportcategories: экспорт файла категорий
✔️
✔️
importcategories: импорт файла категорий
✔️
Типы ссылок
Типы ссылок определяют связи между рабочими элементами, такими как родительский или связанный. Пользовательские типы ссылок можно определить для локальных моделей XML и размещенных xml-процессов. Дополнительные сведения см. в разделе "Ссылки рабочих элементов " и справочник по типу ссылок.
Command
Azure DevOps Services
Сервер Azure DevOps
deletelinktype: удаление типа ссылки
✔️
exportlinktype: экспорт файла типа ссылки
✔️
✔️
importlinktype: импорт файла типа ссылки
✔️
listlinktypes: вывод списка определенных типов ссылок
✔️
✔️
reactivatelinktype: повторная активация или переименование типа ссылки
✔️
Глобальные списки
Глобальные списки — это многократно используемые списки выбора, которые можно ссылаться в нескольких полях и определениях типов рабочих элементов в коллекции проектов. Определение глобальных списков с помощью XML-элемента GLOBALLIST . Дополнительные сведения см . в справочнике по элементу GLOBALLIST XML.
Command
Azure DevOps Services
Сервер Azure DevOps
destroygloballist: удаление глобального списка
✔️
exportgloballist: экспорт глобального списка
✔️
✔️
importgloballist: импорт глобального списка
✔️
listgloballist: перечисление всех глобальных имен списков
✔️
✔️
Глобальный рабочий процесс
Глобальный рабочий процесс определяет поля и глобальные списки, которые применяются ко всем типам рабочих элементов в проекте или коллекции. Дополнительные сведения см . в справочнике по ЭЛЕМЕНТу XML глобального рабочего процесса.
Command
Azure DevOps Services
Сервер Azure DevOps
exportglobalworkflow: экспорт глобального файла рабочего процесса
✔️
importglobalworkflow: импорт глобального файла рабочего процесса
✔️
Конфигурация процесса
Конфигурация процесса определяет, какие типы рабочих элементов отображаются в невыполненных работах, досках, невыполненных спринтах и досках задач. Он также управляет столбцами по умолчанию и другими возможностями команды. Дополнительные сведения см. в справочнике по XML-элементу ProcessConfiguration.
Для модели наследуемого процесса настройте невыполненные работы на веб-портале. Дополнительные сведения см. в разделе "Настройка невыполненных работ и досок".
Command
Azure DevOps Services
Сервер Azure DevOps
exportprocessconfig: экспорт файла ProcessConfiguration
✔️
✔️
importprocessconfig: импорт файла ProcessConfiguration
✔️
Кэш клиента
После операций обслуживания сервера, таких как перемещение, восстановление, переименование или отработка отказа серверов, необходимо обновить кэш клиента. Эта команда доступна только для Azure DevOps Server.
-
rebuildcache: перестроение кэша клиента для отслеживания рабочих элементов
Сопоставление полей управления тестом
Настройте типы разрешений, тип рабочего элемента ошибки и типы сбоев, используемые в планах тестирования Azure. Эта команда доступна только для Azure DevOps Server.
-
tcm fieldmapping: импортирует или экспортирует файл, определяющий типы разрешений, тип ошибки или типы сбоев для управления тестовых случаев