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

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

vstest.console.exe интерпретирует указываемые параметры и значения без учета регистра.

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

Примечание

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

Примечание

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

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

/Settings:[ имя файла ]

Запуск тестов с дополнительными параметрами, например со сборщиками данных.

Пример: /Settings:Local.RunSettings

/Tests:[ имя теста ]

Выполните тесты с именами, которые соответствуют предусмотренным значениям.

Для предоставления нескольких значений разделите их запятыми.

Пример: /Tests:TestMethod1,testMethod2

Предупреждающее замечаниеВнимание
Параметр командной строки /Tests невозможно использовать с параметром командной строки /TestCaseFilter.

/Enablecodecoverage

Включение адаптера диагностических данных CodeCoverage в тестовом запуске.

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

/InIsolation

Запуск тестов в изолированном процессе.

Это снижает вероятность остановки процесса vstest.console.exe при возникновении ошибки в тестах, однако тесты могут выполняться медленнее.

/UseVsixExtensions

Процесс vstest.console.exe будет использовать или пропускать установленные расширения VSIX (если они имеются) при запуске тестов.

Пример: /UseVsixExtensions:true

/Platform:[ тип платформы ]

Архитектура целевой платформы, которая должна использоваться для выполнения тестов.

Допустимые значения — x86, x64 и ARM.

/Framework: [ версия платформы ]

Целевая версия .NET Framework, которую следует использовать для выполнения тестов.

Допустимые значения — Framework35, Framework40 и Framework45.

Пример: /Framework:framework40

/TestCaseFilter:[ выражение ]

Запуск тестов, соответствующих заданному выражению.

<Выражение> формата <свойство>=<значение>[|<Выражение>].

Пример: /TestCaseFilter:"Priority=1"

Пример: /TestCaseFilter:"TestCategory=Nightly|FullyQualifiedName=Namespace.ClassName.MethodName"

Предупреждающее замечаниеВнимание
Параметр командной строки /TestCaseFilter невозможно использовать с параметром командной строки /Tests.

/Logger:[ uri/понятное_имя ]

Укажите средство ведения журнала результатов тестирования.

Пример: чтобы записать результаты в файл результатов теста Visual Studio (TRX), воспользуйтесь /Logger:trx.

Пример: чтобы опубликовать результаты теста в TFS, используйте TfsPublisher:

/logger:TfsPublisher;

Collection=<team project url>;

BuildName=<build name>;

TeamProject=<team project name>;

[;Platform=<Defaults to “Any CPU”>]

[;Flavor=<Defaults to “Debug”>]

[;RunTitle=<title>]

ПримечаниеПримечание
Для работы средства ведения журнала TfsPublisher требуется Visual Studio 2012 с [Visual Studio 2012.1] или более поздней версии.

/ListTests:[ имя файла ]

Перечисление обнаруженных тестов из указанного контейнера тестов.

/ListDiscoverers

Перечисление установленных средств обнаружения тестов.

/ListExecutors

Перечисление установленных исполнителей тестов.

/ListLoggers

Перечисление установленных средств ведения журнала тестирования.

/ListSettingsProviders

Перечисление установленных поставщиков параметров тестирования.

Использование VSTest.Console.exe с файлами тестов

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

Vstest.console.exe [TestFileNames] [Options]

Ниже приведен пример использования VSTest.Console.exe из командной строки.

Vstest.console.exe myTestProject.dll

Ниже приведен пример использования VSTest.Console.exe из командной строки с помощью нескольких тестовых файлов. Это делается разделением имен тестовых файлов с помощью пробелов.

Vstest.console.exe myTestFile.dll myOtherTestFile.dll

Пример

В следующем примере показано использование некоторых параметров для запуска Vstest.console.exe. В этом случае система выполнит тесты в файле myTestFile.dll, собирая данные, заданные в файле Local.RunSettings и в изолированном процессе. Кроме того, система отфильтрует тестовые случаи для выполнения на основе параметра "Приоритет 1" и запишет результаты в TRX-файл.

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

См. также

Основные понятия

Запуск автоматических тестов из командной строки

Использование VSTest.console из командной строки