Opções da linha de comando de VSTest.Console.exe

O VSTest.Console.exe é o comando da linha de comando usado para executar testes. É possível especificar várias opções em qualquer ordem na linha de comando VSTest.Console.exe. Essas opções são listadas na tabela Opções gerais de linha de comando, mais adiante neste tópico.

vstest.console.exe interpreta esses valores e opções que você especifica em um modo sem diferenciação de maiúsculas e minúsculas.

A tabela a seguir lista todas as opções para VSTest.Console.exe e breves descrições sobre elas. É possível ver um resumo semelhante digitando VSTest.Console /? na linha de comando.

Dica

O adaptador MSTest no Visual Studio 2012 também funciona no modo herdado (equivalente à execução de testes com mstest.exe) para compatibilidade.No modo herdado, não é possível aproveitar os novos recursos do VS11 TestCaseFilter.O adaptador pode alternar para modo herdado quando o arquivo .testsettings é especificado, forcelegacymode é definido para true no arquivo .runsettings ou usando atributos como HostType.

Dica

Para executar testes automatizados em um computador baseado na arquitetura ARM, use o VSTest.Console.exe.

Opções gerais de linha de comando

/Settings:[nome de arquivo]	Execute testes com configurações adicionais, como coletores de dados. Exemplo: /Settings:Local.RunSettings
/Tests:[nome do teste]	Execute testes com nomes que correspondam aos valores fornecidos. Para fornecer vários valores, separe-os por vírgulas. Exemplo: /Tests:TestMethod1,testMethod2 Cuidado A opção de linha de comando /Tests não pode ser usada com a opção de linha de comando /TestCaseFilter.
/Enablecodecoverage	Permite o adaptador de diagnóstico de dados CodeCoverage na execução de teste. As configurações padrão serão usadas se não forem especificadas usando o arquivo de configurações.
/InIsolation	Executa os testes em um processo isolado. Isso torna o processo vstest.console.exe menos suscetível a ser interrompido por engano nos testes. Entretanto, os testes podem ser executados de forma mais lenta.
/UseVsixExtensions	Isso faz com que o processo vstest.console.exe use ou ignore as extensões VSIX instaladas (se houver) na execução de teste. Exemplo: /UseVsixExtensions:true
/Platform:[tipo de plataforma]	Arquitetura da plataforma de destino a ser usada para a execução de teste. Os valores válidos são x86, x64 e ARM.
/Framework: [versão do Framework]	Versão do .NET Framework de destino a ser usada na execução de teste. Os valores válidos são Framework35, Framework40 e Framework45. Exemplo: /Framework:framework40
/TestCaseFilter:[expressão]	Execute testes que correspondam à expressão fornecida. < expression > está no formato < propriedade > = < valor > [| < Expression >]. Exemplo: /TestCaseFilter:"Priority=1" Exemplo: /TestCaseFilter:"TestCategory=Nightly|FullyQualifiedName=Namespace.ClassName.MethodName" Cuidado A opção de linha de comando /TestCaseFilter não pode ser usada com a opção de linha de comando /Tests.
/Logger:[URI/friendlyname]	Especificar um agente para resultados do teste. Exemplo: para registrar os resultados em um arquivo de resultados do teste do Visual Studio (TRX), use /Logger:trx. Exemplo: para publicar resultados do teste no Team Foundation Server, use 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>] Observação O agente TfsPublisher exige o Visual Studio 2012 com [Visual Studio 2012.1] ou posterior.
/ListTests:[nome de arquivo]	Lista testes descobertos do contêiner de teste fornecido.
/ListDiscoverers	Lista detectores de testes instalados.
/ListExecutors	Lista executores de testes instalados.
/ListLoggers	Lista agentes de testes instalados.
/ListSettingsProviders	Lista provedores de configurações de teste instalados.

Usando VSTest.Console.exe com arquivos de teste

O uso de vstest.console.exe é:

Vstest.console.exe [TestFileNames] [Options]

Veja a seguir um exemplo de como usar VSTest.Console.exe da linha de comando:

Vstest.console.exe myTestProject.dll

Veja a seguir um exemplo de como usar VSTest.Console.exe da linha de comando usando vários arquivos de teste. Isso é feito separando nomes de arquivos de teste por espaços:

Vstest.console.exe myTestFile.dll myOtherTestFile.dll

Exemplo

O exemplo a seguir mostra o uso de algumas das opções para a execução de Vstest.console.exe. Nesse caso, o comando executará os testes no arquivo myTestFile.dll, enquanto coleta dados especificados no arquivo Local.RunSettings e em um processo isolado. Além disso, o comando filtrará os casos de teste a serem executados com base em "Prioridade 1" e registrará os resultados em um arquivo .trx.

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

Consulte também

Conceitos

Executando testes automatizados a partir da linha de comando

Usando VSTest.Console na linha de comando