Opções de linha de comando do MSTest. exe

MSTest.exe é o comando que é usado para executar testes.Este comando tem várias opções que você pode usar para personalizar seu ensaio.Você pode usar muitas dessas opções em conjunto com uma outras; na verdade, você deve usar determinadas opções em conjunto com outras opções, como descrito nas seções.Você pode especificar essas opções em qualquer ordem na linha de comando de MSTest.exe.

MSTest.exe não interpreta as opções ou valores que você especifica para eles em uma maneira maiúsculas de minúsculas.

As tabelas a seguir listam as opções para MSTest.exe e breves descrições de eles.Você pode ver um resumo semelhante digitando MSTest/h em uma linha de comando.

Opções de linha de comando gerais

/testcontainer:[nome de arquivo]	Carregar um arquivo que contém teste. Exemplo: /testcontainer:tests.dll Para obter mais informações, consulte /testcontainer.
/testmetadata:[nome de arquivo]	Carregar um arquivo que contém metadados de teste.Para obter mais informações, consulte /testmetadata.
/testlist:[testar o caminho de lista]	Especificar a lista de teste, conforme especificado no arquivo metadados, para ser executado.Para obter mais informações, consulte /testlist.
/category:[testar o filtro de categoria]	Especificar e filtrar que eles testam categorias para executar.Para obter mais informações, consulte /category.
/test:[testar o nome]	Especifique o nome de um teste a ser executado.Para obter mais informações, consulte /test.
/noisolation	Executar testes dentro do processo de MSTest.exe.Esta opção melhora a velocidade de ensaio mas o risco de gera o processo de MSTest.exe.
/testsettings: [nome de arquivo]	Use o arquivo especificado de configurações de teste. Exemplo: /testsettings:Local.Testsettings Para obter mais informações, consulte /testsettings.
/runconfig:[nome de arquivo]	Use o arquivo de configuração especificado de execução. Exemplo: /runconfig:localtestrun.Testrunconfig Para obter mais informações, consulte /runconfig. Observação Essa opção de linha de comando é mantida para compatibilidade com versões anteriores do Visual Studio.As configurações de ensaio foram substituídas pelas configurações de teste prêmio no Visual Studio.
/resultsfile:[nome de arquivo]	Salvar os resultados de ensaio o arquivo especificado. Exemplo: /resultsfile:testResults.trx Para obter mais informações, consulte /resultsfile.
/detail:[identificação de propriedade]	Especifique o nome da propriedade que você deseja exibir valores para, se houver, além do que o resultado de teste.Para obter mais informações, consulte /detail.
/help	Exibir a mensagem de uso de MSTest.exe (formulário curto: /? ou /h).
/nologo	Não exibir nenhuma mensagem do banner e de direitos autorais de inicialização.
/usestderr	Use o erro padrão para informações de erro de saída.

Opções de linha de comando para publicar resultados de teste

Para obter mais informações sobre essas opções, consulte Opções de linha de comando para publicação de resultados de teste.

/publish:[nome do servidor]	Publicar resultados ao banco de dados para a coleção de projeto de equipe do servidor especificado.
/publishresultsfile:[nome de arquivo]	Especifique o nome de arquivo de resultados sejam publicado.Se nenhum nome de arquivo de resultados é especificado, use o arquivo gerado pela execução do atual.
/publishbuild:[compile a identificação]	Publicar resultados de teste usando essa identificação de compilação
/teamproject:[nome do projeto de equipe]	Especificar o nome do projeto de equipe que pertence a compilação.
/platform:[plataforma]	Especificar a plataforma de compilação versus que os resultados do teste devem ser publicado.
/flavor:[sabor]	Especificar o sabor de compilação versus que os resultados do teste devem ser publicado.

Usando opções de MSTest

As seções a seguir descrevem muitas das opções para MSTest.exe com mais detalhes.As opções que foram usadas publicando resultados de teste não são incluídas aqui.Para obter informações sobre dessas opções, consulte Opções de linha de comando para publicação de resultados de teste.

/testcontainer

/testcontainer:[nome de arquivo]

O recipiente de teste é um arquivo que contém os testes que você deseja executar.Por exemplo, para testes ordenados, o recipiente de teste é o arquivo de .orderedtest que define o teste ordenada.Para testes de unidade, o assembly é compilado de projeto de teste que contém os arquivos de origem de testes de unidade.

Observação
Para testes de unidade, este é o assembly que contém o código de teste, não assembly que contém o código do aplicativo que você está testando.Por exemplo, se sua solução contém um projeto chamado BankAccount e um projeto de teste correspondente denominado BankAccountTest, especifique /testcontainer:BankAccountTest.dll.

Observação
Porque os metadados de teste arquivo também os testes listas que você pode executar, você não deve especificar opções de /testcontainer e de /testmetadata em uma única linha de comando.Isso seria ambíguo e geraria um erro.

/testmetadata

/testmetadata:[nome de arquivo]

Você pode usar a opção de /testmetadata executar testes em vários contêiner de teste.

O arquivo de metadados de teste é criado para sua solução quando você cria listas de teste usando a janela editor de lista de teste.Este arquivo contém informações sobre todos os testes listados na janela editor de lista de teste.Esses são todos os testes que existem em todos os projetos de teste em sua solução.

O arquivo de metadados de teste é um arquivo XML que é criado na pasta de solução.Este arquivo é mostrado no solution Explorer no nó de Itens de Solução .Um arquivo de metadados de teste tem a extensão .vsmdi, e é associado com a janela do editor de lista de teste.Isto é, se você clicar duas vezes em um arquivo de .vsmdi no Windows Explorer (ou no gerenciador de Arquivos), o arquivo é aberto Visual Studio e seu conteúdo.Todos os testes em projetos de teste de uma solução são exibidos na janela editor de lista de teste.

Você pode alterar os metadados de teste apenas os arquivos fazendo alterações que são refletidas na janela editor de lista de teste, como criar ou excluir de teste, ou alterar as propriedades de um teste.

Observação
Porque o contêiner de teste contém os testes que você pode executar, você não deve especificar opções de /testcontainer e de /testmetadata em uma única linha de comando.Isso seria ambíguo e geraria um erro.

Quando você usa a opção de /testmetadata , é recomendável que você indica testes específicos para a execução usando a opção de /test ou a opção de /testlist , ou ambos.

/testlist

/testlist:[testar o caminho de lista]

A opção de /testlist é uma lista de teste, conforme especificado nos metadados de teste arquivos, para ser executada.Para executar testes que estão contidos em vários listas de teste, use a opção de /testlist várias vezes.Todos os testes ordenados na lista de teste serão executados.

Observação
Você pode usar a opção de /testlist somente se também usa a opção de /testmetadata .

Você pode usar a opção de /testlist e a opção de /test juntos.Isso é equivalente a selecione uma lista de teste e um ou mais testes individuais na janela editor de lista de teste e então escolha a Executar Testes.

/category

/category:[testar o filtro de categoria]

Use a opção de especificar que /category testam a categoria para executar.

Observação
Você deve usar a opção de /testcontainer para usar a opção de /category .

Você pode usar a opção de /category uma vez por linha de comando, mas você pode especificar várias categorias de teste com o filtro de categoria de teste.O filtro de categoria de teste consiste em um ou vários nomes de categoria de teste separado pelos operadores lógicos &”, “|”, “! ”, “&!”.Os operadores lógicos &” e “|” não pode ser usado junto para criar um filtro de categoria de teste.

Por exemplo:

• /category:group1 realiza teste na categoria “group1” de teste.

• /category:"group1&group2" executa os testes que estão em ambas as categorias “group1” e “group2 de teste.” Os testes que só estão em uma das categorias especificadas de teste não serão executados.

• /category:"group1|group2" executa os testes que estão na categoria “group1” ou “group2” de teste.Os testes que estão em ambas as categorias de teste serão executados também.

• /category:"group1&!group2" executa o teste de categoria “group1” de teste que não estão na categoria “group2 de teste.” Um teste que é tanto na categoria “group1” e “group2” de teste não será executado.

  Observação
  Se seu filtro consiste em uma única categoria como /category:group1, você não precisa incluir o filtro entre aspas.No entanto, se seu filtro referência mais de uma categoria como /category:"group1&group2" no filtro tem que estar entre aspas.

/test

/test:[testar o nome]

Use a opção de especificar /test teste individuais para executar.Para executar um teste de vários, use a opção de /test várias vezes.

Observação
Você pode usar a opção de /test com a opção de /testcontainer ou com a opção de /testmetadata com, mas não ambos.

Você pode usar a opção de /testlist e a opção de /test juntos.Isso é equivalente a selecione uma lista de teste e um ou mais testes individuais na janela editor de lista de teste e então escolha a Executar Testes.

A cadeia de caracteres que você especifica com a opção de /test é usado para coincidir com os nomes dos testes em metadados de um contêiner de teste ou um teste arquivos.Isso significa que você pode especificar mais testes usando um único valor para /test.Por exemplo, especificando /test:ittest produziria correspondências para os testes nomeados DebitTest e CreditTest porque os dois nomes de teste contém a subcadeia de caracteres “a” mais ittest.

Observação
O valor especificado com a opção de /test é testada contra não apenas o nome de teste, mas também o caminho do teste, como visto no solution Explorer, ou, com testes de unidade, a seu nome totalmente qualificado.

Dois exemplos de uso seguir:

exemplo de Unidade- teste: O arquivo UnitTest1.cs no projeto TestProject2 contém um teste de unidade TestMethod1 chamado.Especificando um valor de “maior ittest” para a opção de /test também corresponde a esse teste, porque a cadeia de caracteres é testada contra o nome totalmente qualificado “TestProject2.UnitTest1.TestMethod1” e a cadeia de caracteres “a” mais ittest também aparece em UnitTest1 “”.

exemplo de Genérico- teste: A seguinte linha de comando executa o teste genérico especificado e, nos resultados de teste, exibe o caminho completo de teste.

mstest /testcontainer:"C:\Documents and Settings\<user name>\My Documents\Visual Studio\Projects\TestProject2\TestProject2\generictest1.generic" /test:testproject32\generic

/noisolation

/noisolation

Use esta opção para executar testes dentro do processo de MSTest.exe.Usar esta opção não causa outras alterações na configuração de ensaio.O objetivo dessa opção é aumentar a velocidade de ensaio.No entanto, aumenta o risco para ensaio no conjunto porque uma exceção não tratada lançada pelo código de teste causaria o processo de MSTest.exe falhar.

/testsettings

/testsettings:[nome de arquivo]

Use esta opção para especificar um arquivo de configurações de teste.Por exemplo: /testsettings:local.Testsettings

Você pode especificar configurações de um teste arquivos de outras maneiras, como com a opção de /testmetadata.Regras que regem a especificação de arquivos de configurações de teste são descritas aqui.

• Se você usar a opção de /testsettings , especificando o arquivo será usado, se você também usa a opção de /testmetadata .

• Se você usar a opção de /testmetadata apontar para o arquivo de metadados que especifica as configurações ativas de teste arquivos, que as configurações do teste o arquivo será usado se você não usar a opção de /testsettings .

• Se você não usar a opção de /testsettings e você também não especificar configurações de um teste arquivos nos metadados de teste arquivos, o ensaio usa o arquivo de configurações padrão de teste.

  Observação
  Para obter mais informações sobre arquivos de configuração de teste, consulte Criar configurações de teste para testes de sistema automatizados usando o Microsoft Test Manager.

/runconfig

/runconfig:[nome de arquivo]

Observação Essa opção de linha de comando é mantido para compatibilidade com versões anteriores do Visual Studio.As configurações de ensaio foram substituídas pelas configurações de teste prêmio no Visual Studio.

Use esta opção para especificar um arquivo de configuração de execução.Por exemplo: /runconfig:localtestrun.Testrunconfig

Você pode especificar um arquivo de configuração de execução em outras formas, como com a opção de /testmetadata.Regras que regem a especificação de arquivos de configuração de execução são descritas aqui.

• Se você usar a opção de /runconfig , especificando o arquivo será usado, mesmo se também usa a opção de /testmetadata .

• Se você usar a opção de /testmetadata apontar para o arquivo de metadados que especifica o arquivo de configuração ativo de execução, o arquivo de configuração de execução será usado se você não usar a opção de /runconfig .

• Se você não usar a opção de /runconfig e você também não especifica um arquivo de configuração de execução nos metadados de teste arquivos, o ensaio usa o arquivo de configuração padrão de execução.

/resultsfile

/resultsfile:[nome de arquivo]

Use esta opção salvar os resultados de ensaio para o arquivo chamado.Por exemplo: /resultsfile:testResults.trx.

/usestderr

/usestderr

Usar esta opção que as seguintes informações a ser gravado para o erro padrão:

• Testando com um resultado de falha, anuladas, de erro, expirado, não possível, ou não executado.

• Erros de nível de execução.

• Erros de analisar os argumentos de linha de comando.

• Resumo de execução quando o ensaio tem um resultado falhando.

Sem esta opção todas as saídas são enviadas para saída padrão.

/detail

/detail:[identificação de propriedade]

Essa opção é usada exibir propriedades adicionais de situação de teste, se existirem.Você pode passar mais de uma instância padrão de /detail , cada um com apenas uma identificação de propriedade, na linha de comando.As identificações válidos de propriedade para a opção de /detail seguir:

adaptador	identificação	projectrelativepath
computername	isautomated	readonly
debugtrace	link	spoolmessage
descrição	longtext	stderr
displaytext	name	stdout
duração	outcometext	storage
errormessage	proprietário	testcategoryid
errorstacktrace	parentexecid	testname
executionid	prioridade	testtype
grupos	projectname	traceinfo

Observação

A seleção atual de IDs de propriedades que você pode usar com a opção de /detail varia de acordo com o tipo de teste.Como consequência, essa lista é apenas uma aproximação.Em particular, se você estiver usando tipos personalizados de teste, a seleção de propriedades será diferente.Para saber que propertyIDs você pode usar, examine os resultados do teste arquivo gerado pelo ensaio.Para obter mais informações sobre arquivos de resultados de teste, consulte Como: salvar e abrir os resultados de teste em Visual Studio.

Se uma propriedade existe para a situação de teste especificada, a informação está incluída no resumo do resultado de saída.

Por exemplo, a linha de comando:

mstest /testcontainer:Errors.dll /detail:testtype

produz a saída a seguir, que contém informações sobre o tipo de teste:

...
Results Top Level Tests
-------- -----------------
Inconclusive TestProject2.BankAccountTest.CreditTest
[testtype] = Unit Test
...

Consulte também

Conceitos

Revisando resultados de testes no Microsoft Test Manager

Execução automatizada de testes na linha de comando