Opções da linha de comando de VSTest.Console.exe
Publicado: abril de 2016
O VSTest.Console.exe é o comando de 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 posteriormente neste tópico.
vstest.console.exe interpreta esses valores e opções que você especificar 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 tirar proveito dos novos recursos do VS11 TestCaseFilter.O adaptador pode alternar para modo herdado quando o arquivo de .testsettings é especificado, forcelegacymode é definido para true no arquivo de .runsettings ou usando atributos como HostType.
Dica
Para executar testes automatizados em um computador baseado na arquitetura ARM, você deve usar o VSTest.Console.exe.
Opções gerais de linha de comando
/Settings:[ nome do 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 Aviso A opção de linha de comando de /Tests não pode ser usada com a opção de linha de comando de /TestCaseFilter . |
/Enablecodecoverage |
Permite o adaptador de diagnóstico de dados CodeCoverage no ensaio. As configurações padrão são usadas se não for especificado o uso do 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 torna 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 de 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 ] |
Marque a versão do .NET Framework a ser usada para a 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. <Expressão> é o formato <propriedade>=<valor>[|<Expressão>]. Exemplo: /TestCaseFilter:"Priority=1" Exemplo: /TestCaseFilter:"TestCategory=Nightly|FullyQualifiedName=Namespace.ClassName.MethodName" Aviso A opção de linha de comando de /TestCaseFilter não pode ser usada com a opção de linha de comando de /Tests . |
/Logger:[ URI/friendlyname ] |
Especifica um agente para resultados de teste. Exemplo: Registrar os resultados em um arquivo de resultados de teste do Visual Studio (TRX) /Logger:trx. Exemplo: Publicar resultados de 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>] Dica O agente TfsPublisher exige Visual Studio 2012 com [Visual Studio 2012.1] ou posterior. |
/ListTests:[ nome do arquivo ] |
Lista testes descobertos do contêiner de teste determinado. |
/ListDiscoverers |
Lista detectores de testes instalados. |
/ListExecutors |
Lista os executores de testes instalados. |
/ListLoggers |
Lista os agentes de log de testes instalados. |
/ListSettingsProviders |
Lista os provedores de configurações de testes instalados. |
Usando VSTest.Console.exe com arquivos de teste
O uso de vstest.console.exe é:
Vstest.console.exe [TestFileNames] [Options]
A seguir, temos um exemplo de como usar VSTest.Console.exe da linha de comando:
Vstest.console.exe myTestProject.dll
A seguir, temos 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, filtrará situações de casos de teste para a execução com base na" Prioridade 1", e efetua logon dos resultados em um arquivo de .trx.
vstest.console.exe myTestFile.dll /Settings:Local.RunSettings /InIsolation /TestCaseFilter:"Priority=1" /Logger:trx
Consulte também
Executando testes automatizados a partir da linha de comando
Usando VSTest.Console na linha de comando