RunVisualStudioTestsusingTestAgent@1 — выполнение функциональных тестов задачи версии 1

2025-06-24

RunVisualStudioTestsusingTestAgent@1 и сопутствующая ему задача (развертывание агента тестирования Visual Studio) являются устаревшими. Вместо этого используйте задачу "Тест Visual Studio". Задача VSTest может выполнять единицы, а также функциональные тесты. Выполните тесты на одном или нескольких агентах с помощью параметра задания с несколькими агентами. Используйте задачу "Тестовая платформа Visual Studio" для выполнения тестов без использования Visual Studio в агенте. Задача VSTest также предоставляет новые возможности, такие как автоматический повторный запуск неудачных тестов.

Синтаксис

# Run functional tests v1
# Deprecated: This task and it’s companion task (Visual Studio Test Agent Deployment) are deprecated. Use the 'Visual Studio Test' task instead. The VSTest task can run unit as well as functional tests. Run tests on one or more agents using the multi-agent job setting. Use the 'Visual Studio Test Platform' task to run tests without needing Visual Studio on the agent. VSTest task also brings new capabilities such as automatically rerunning failed tests.
- task: RunVisualStudioTestsusingTestAgent@1
  inputs:
  # Setup Options
    testMachineGroup: # string. Required. Machines. 
    dropLocation: # string. Required. Test Drop Location. 
  # Execution Options
    testSelection: 'testAssembly' # 'testAssembly' | 'testPlan'. Required. Test Selection. Default: testAssembly.
    #testPlan: # string. Required when testSelection = testPlan. Test Plan. 
    #testSuite: # string. Required when testSelection = testPlan. Test Suite. 
    #testConfiguration: # string. Required when testSelection = testPlan. Test Configuration. 
    sourcefilters: '**\*test*.dll' # string. Required when testSelection = testAssembly. Test Assembly. Default: **\*test*.dll.
    #testFilterCriteria: # string. Optional. Use when testSelection = testAssembly. Test Filter criteria. 
    #runSettingsFile: # string. Run Settings File. 
    #overrideRunParams: # string. Override Test Run Parameters. 
    #codeCoverageEnabled: false # boolean. Code Coverage Enabled. Default: false.
    #customSlicingEnabled: false # boolean. Distribute tests by number of machines. Default: false.
  # Reporting Options
    #testRunTitle: # string. Test Run Title. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #testConfigurations: # string. Test Configurations. 
    #autMachineGroup: # string. Application Under Test Machines.

Входные данные

testMachineGroup - компьютеры
string. Обязательное.

Разделенный запятыми список полных доменных имен или IP-адресов компьютеров, который может включать номер порта. Максимум – 32 машины или 32 агента. В список могут входить:

Имя группы ресурсов Azure.
Список имен компьютеров с разделителями-запятыми. Пример: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
Выходная переменная из предыдущей задачи.

dropLocation - Тестовое место сброса
string. Обязательное.

Указывает расположение на тестовых компьютерах, где тестовые двоичные файлы были скопированы с помощью задачи копирования файлов компьютера Windows или задачи копирования файлов Azure . Для указания места сброса можно использовать переменные системного этапа с компьютеров агента тестирования. Примерами являются события c:\tests и %systemdrive%\Tests.

testSelection - Выбор теста
string. Обязательное. Допустимые значения: testAssembly (Тестовая сборка), testPlan (План тестирования). Значение по умолчанию: testAssembly.

Указывает, как выполняются тесты: с помощью тестовых сборок или плана тестирования.

testPlan - План тестирования
string. Требуется, если testSelection = testPlan.

Указывает план тестирования, который уже настроен для данной организации.

testSuite - Набор тестов
string. Требуется, если testSelection = testPlan.

Указывает набор тестов из выбранного плана тестирования.

testConfiguration - Тестовая конфигурация
string. Требуется, если testSelection = testPlan.

Указывает конфигурацию теста из выбранного плана тестирования.

sourcefilters - Тестовая сборка
string. Требуется, если testSelection = testAssembly. Значение по умолчанию: **\*test*.dll.

Указывает тестовые двоичные файлы для выполнения тестов. Подстановочные знаки могут быть использованы. Например, для всех .dll файлов, **\*test*.dll; содержащих test в имени файла.

testFilterCriteria - Критерии тестового фильтра
string. Необязательно. Используется при testSelection = testAssembly.

Фильтр, определяющий тесты для выполнения в файлах тестовой сборки. Работает так же, как опция /TestCaseFilter в vstest.console.exe. Пример: Owner=james&Priority=1.

runSettingsFile - Файл настроек запуска
string.

Указывает путь к файлу или runsettingstestsettings для использования с тестами.

overrideRunParams - Переопределение параметров тестового прогона
string.

Указывает параметры переопределения, определенные в TestRunParameters разделе runsettings файла или Properties в разделе testsettings файла. Пример: AppURL=$(DeployURL);Port=8080.

Замечание

Доступ к свойствам, указанным в файле testsettings , можно получить с помощью TestContext Test Agent 2017 Update 4 или более поздней версии.

codeCoverageEnabled - Покрытие кода включено
boolean. Значение по умолчанию: false.

Указывает, включено ли покрытие кода для задачи.

customSlicingEnabled - Распределение тестов по количеству машин
boolean. Значение по умолчанию: false.

Когда значение этого логического значения равно true, тесты распределяются на основе количества предоставленных компьютеров, а не количества тестовых контейнеров.

Замечание

Тесты в одном компьютере .dll также могут быть распределены на несколько компьютеров.

testRunTitle - заголовок тестового запуска
string.

Задает имя тестового запуска.

platform - платформы
string.

Указывает платформу, на которой должны быть составлены отчеты о тестах. Если в задаче сборки определена переменная for platform , используйте ее в качестве значения.

конфигурации configuration -
string.

Указывает конфигурацию, по которой должны создаваться отчеты о тестах. Если в задаче сборки определена переменная for configuration , используйте ее в качестве значения.

testConfigurations - Тестовые конфигурации
string.

Необязательно. Связывает фильтр тестового случая с идентификатором конфигурации теста. Синтаксис: <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>. Пример: FullyQualifiedName~Chrome:12.

autMachineGroup - Испытательные машины для применения
string.

Разделенный запятыми список компьютеров, выходных переменных или имен групп компьютеров, на которых выполняются серверные процессы, такие как W3WP.exe, .

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Нет.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент
Требования	Отсутствует
Возможности	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	1.104.0 или более поздней версии
Категория задач	Тест