Параметры командной строки для VSTest.Console.exe

VSTest.Console.exe — это программа командной строки для выполнения тестов. В командной строке можно указывать несколько параметров в произвольном порядке. Эти параметры перечислены в таблице Общие параметры командной строки ниже.

Примечание.

Адаптер MSTest в Visual Studio также способен работать в прежнем режиме (эквивалентном выполнению тестов с помощью mstest.exe) в целях совместимости. В прежнем режиме невозможно использовать новые возможности компонента TestCaseFilter. Адаптер может переключиться в прежний режим, если задан TESTSETTINGS-файл, параметр forcelegacymode в RUNSETTINGS-файле установлен в значение true, или с помощью атрибутов, таких как HostType.

Для выполнения автоматических тестов на компьютере с архитектурой ARM необходимо использовать VSTest.Console.exe.

Откройте командную строку разработчика, чтобы использовать программу командной строки. Это средство можно также найти в папке %Program Files(x86)%\Microsoft Visual Studio\<версия>\<выпуск>\common7\ide\CommonExtensions\<Платформа | Microsoft>.

Общие параметры командной строки

В следующей таблице перечислены все параметры VSTest.Console.exe и приведено их краткое описание. Аналогичные данные можно получить, введя VSTest.Console/? в командной строке.

Вариант	Описание
[тестовых]	Запускает тесты из указанных файлов. Для разделения имен тестовых файлов используйте пробелы. Примеры: mytestproject.dll, mytestproject.dll myothertestproject.exe
/Settings:[имя файла]	Запуск тестов с дополнительными параметрами, например со сборщиками данных. Дополнительные сведения см. в разделе Настройка модульных тестов с помощью файла .runsettings. Пример: /Settings:local.runsettings
/Tests:[имя теста]	Выполняйте тесты с именами, которые соответствуют заданным значениям. Эта команда соответствует полному имени теста, включая пространство имен. Для предоставления нескольких значений разделите их запятыми. Пример: /Tests:TestMethod1,testMethod2 Параметр командной строки /Tests нельзя использовать с параметром командной строки /TestCaseFilter.
/Parallel	Указывает, что тесты должны выполняться параллельно. По умолчанию могут использоваться все доступные на компьютере ядра. Число ядер для использования можно настроить с помощью файла параметров.
/Enablecodecoverage	Включение адаптера диагностических данных CodeCoverage в тестовом запуске. Параметры по умолчанию используются, если другие параметры не заданы с использованием файла параметров.
/InIsolation	Запуск тестов в изолированном процессе. Эта изоляция существенно снижает вероятность остановки процесса vstest.console.exe при возникновении ошибки в тестах, однако тесты могут выполняться медленнее.
/UseVsixExtensions	Процесс vstest.console.exe будет использовать или пропускать установленные расширения VSIX (если они имеются) при запуске тестов. Этот параметр является устаревшим. Уже в следующем основном выпуске Visual Studio этот параметр может быть удален. Переходите на использование расширений, доступных в виде пакета NuGet. Пример: /UseVsixExtensions:true
/TestAdapterPath:[путь]	Процесс vstest.console.exe в тестовом запуске будет использовать адаптеры пользовательских тестов по указанному пути (если они там есть). Пример: /TestAdapterPath:[pathToCustomAdapters]
/Platform:[тип платформы]	Принудительное использование данной платформы вместо платформы, определенной в текущей среде выполнения. Этот параметр способен принудительно использовать только платформы x86 и x64 в Windows. Параметр ARM не работает и приводит к появлению x64 в большинстве систем. НЕ указывайте этот параметр для запуска в средах выполнения, которые не указаны в списке допустимых значений, таких как ARM64. Допустимые значения — x86, x64 и ARM.
/Framework: [версия платформы]	Целевая версия .NET, которую следует использовать для выполнения тестов. Примеры значений: Framework35, Framework40, Framework45, FrameworkUap10, .NETCoreApp,Version=v1.1. TargetFrameworkAttribute используется для автоматического обнаружения этого параметра в сборке, его значение по умолчанию Framework40, если отсутствует атрибут. Этот параметр необходимо указывать явно, если из сборок .NET Core.удален TargetFrameworkAttribute. Если целевая версия платформы задана как Framework35, тесты выполняются в "режиме совместимости" среды CLR 4.0. Пример: /Framework:framework40
/TestCaseFilter:[выражение]	Запуск тестов, соответствующих заданному выражению. <Выражение> имеет формат <свойство>=<значение>[|<Выражение>]. Пример: /TestCaseFilter:"Priority=1" Пример: /TestCaseFilter:"TestCategory=Nightly|FullyQualifiedName=Namespace.ClassName.MethodName" Параметр командной строки /TestCaseFilter нельзя использовать с параметром командной строки /Tests. Сведения о создании и использовании выражений см. в разделе Фильтр TestCase.
/?	Отображает сведения об использовании.
/Logger:[uri/понятное имя]	Укажите средство ведения журнала результатов тестирования. Укажите параметр несколько раз, чтобы включить несколько средств ведения журнала. Пример. Чтобы войти в файл результатов теста Visual Studio (TRX), используйте /Logger:trx [;LogFileName=<По умолчанию уникальное имя файла>]
/ListTests:[имя файла]	Перечисление обнаруженных тестов из указанного контейнера тестов. Примечание. Параметр не действует при перечислении тестов. Он /TestCaseFilters управляет только тем, какие тесты выполняются.
/ListDiscoverers	Перечисление установленных средств обнаружения тестов.
/ListExecutors	Перечисление установленных исполнителей тестов.
/ListLoggers	Перечисление установленных средств ведения журнала тестирования.
/ListSettingsProviders	Перечисление установленных поставщиков параметров тестирования.
/Blame	Выполнение тестов в режиме обвинения. Этот параметр полезен при изоляции проблемных тестов, которые приводят к аварийному завершению хоста для тестов. При обнаружении сбоя он создает файл последовательности в TestResults/<Guid>/<Guid>_Sequence.xml, который фиксирует порядок тестов, выполненных до сбоя. Дополнительные сведения: Запуск cборщика данных в режиме обвинения.
/Diag:[имя файла]	Записывает диагностические журналы трассировки в указанный файл.
/ResultsDirectory:[path]	По указанному пути будет создан каталог с результатами теста, если этот путь не существует. Пример: /ResultsDirectory:<pathToResultsDirectory>
/ParentProcessId:[parentProcessId]	Идентификатор родительского процесса, отвечающего за запуск текущего процесса.
/Port:[port]	Порт для подключения через сокет и получения сообщений о событиях.
/Collect:[dataCollector friendlyName]	Включает сборщик данных для тестового запуска. Дополнительные сведения.

Совет

Регистр в параметрах и значениях не учитывается.

Примеры

Синтаксис для запуска vstest.console.exe имеет следующий вид:

vstest.console.exe [TestFileNames] [Options]

По умолчанию команда возвращает 0 при нормальном выходе, даже если тесты не обнаружены. Если вы хотите вернуть ненулевое значение, если тесты не обнаружены, используйте <TreatNoTestsAsError>true</TreatNoTestsAsError> параметр runsettings.

Следующая команда запускает vstest.console.exe для библиотеки тестов myTestProject.dll:

vstest.console.exe myTestProject.dll

Следующая команда запускает vstest.console.exe с множеством тестовых файлов. Для разделения имен тестовых файлов используйте пробелы.

vstest.console.exe myTestFile.dll myOtherTestFile.dll

Следующая команда запускает vstest.console.exe с несколькими параметрами. Она запускает тесты в файле myTestFile.dll в изолированном процессе и использует параметры, заданные в файле Local.RunSettings. Кроме того, она запускает только тесты с меткой "Priority=1" и записывает результаты в TRX-файл.

vstest.console.exe myTestFile.dll /Settings:Local.RunSettings /InIsolation /TestCaseFilter:"Priority=1" /Logger:trx

Следующая команда запускает vstest.console.exe с параметром /blame для библиотеки тестов myTestProject.dll:

vstest.console.exe myTestFile.dll /blame

В случае сбоя узла тестов создается файл sequence.xml. Этот файл содержит полные имена тестов в порядке их выполнения вплоть до конкретного теста, который выполнялся во время сбоя.

При отсутствии сбоя узла тестов файл sequence.xml не создается.

Пример созданного файла sequence.xml:

<?xml version="1.0"?>
<TestSequence>
  <Test Name="TestProject.UnitTest1.TestMethodB" Source="D:\repos\TestProject\TestProject\bin\Debug\TestProject.dll" />
  <Test Name="TestProject.UnitTest1.TestMethodA" Source="D:\repos\TestProject\TestProject\bin\Debug\TestProject.dll" />
</TestSequence>

Пример UWP

Для UWP необходимо ссылаться на файл appxrecipe, а не на DLL.

vstest.console.exe /Logger:trx /Platform:x64 /framework:frameworkuap10 UnitTestsUWP\bin\x64\Release\UnitTestsUWP.build.appxrecipe