Options de ligne de commande VSTest.Console.exe

VSTest.Console.exe est la commande de ligne de commande qui est utilisée pour exécuter des tests.Vous pouvez spécifier plusieurs options dans un ordre quelconque dans la ligne de commande MSTest.exe.Ces options sont répertoriées dans le tableau général d'options de ligne de commande plus loin dans cette rubrique.

vstest.console.exe interprète ces options et valeurs spécifiées d'une façon qui respecte la casse.

Le tableau suivant répertorie les options de VSTest.Console.exe et courtes descriptions de eux.Vous pouvez afficher un résumé semblable en tapant VSTest.Console/? sur une ligne de commande.

[!REMARQUE]

L'adaptateur MSTest dans Visual Studio 2012 fonctionne également en mode CAS hérité (équivalent de l'exécution de tests avec mstest.exe) pour la compatibilité.En mode CAS hérité, il ne peut pas tirer parti des nouvelles fonctionnalités VS11 TestCaseFilter.L'adaptateur peut basculer en mode hérité lorsque le fichier de .testsettings est spécifié, forcelegacymode a la valeur true dans le fichier de .runsettings ou des attributs de utilisation comme HostType.

[!REMARQUE]

Pour exécuter des tests automatisés sur un ordinateur basé sur une architecture ARM, vous devez utiliser VSTest.Console.exe.

Options de ligne de commande générales

/Settings:[nom du fichier]	Pour exécuter les tests avec d'autres paramètres tels que des collecteurs de données : Par exemple : /Settings:Local.RunSettings
/Tests:[nom du test]	Exécutez les tests avec les noms qui correspondent aux valeurs fournies. Pour fournir plusieurs valeurs, séparez les par des virgules. Par exemple : /Tests:TestMethod1,testMethod2 Attention L'option de ligne de commande des /Tests ne peut pas être utilisée avec l'option de ligne de commande des /TestCaseFilter .
/Enablecodecoverage	Active l'adaptateur de données de diagnostic 'CodeCoverage' dans la série de tests. Le paramètres par défaut sont utilisés s'ils ne sont pas spécifiés à l'aide du fichier de paramètres.
/InIsolation	Exécute les tests dans un processus isolé. Cela rend le processus vstest.console.exe moins probable pour être arrêté sur une erreur dans les tests, mais les tests peuvent s'exécuter plus lentement.
/UseVsixExtensions	Cela fait en sorte que le processus vstest.console.exe utilise ou ignore les extensions VSIX installées (le cas échéant) dans la série de tests. Par exemple : /UseVsixExtensions:true
/Platform:[type de plateforme]	Architecture de plateforme cible à utiliser pour l'exécution des tests. Les valeurs valides sont x86, x64 et ARM.
/Framework: [FrameworkVersion]	Version .Net Framework cible à utiliser pour l'exécution des tests. Les valeurs valides sont Framework35, Framework40 et Framework45. Par exemple : /Framework:framework40
/TestCaseFilter:[expression]	Exécutez des tests qui correspondent à l'expression donnée. <Expression> est au format <property>= [<value>|<Expression>]. Par exemple : /TestCaseFilter:"Priority=1" Par exemple : /TestCaseFilter:"TestCategory=Nightly|Name=Namespace.ClassName.MethodName" Attention L'option de ligne de commande des /TestCaseFilter ne peut pas être utilisée avec l'option de ligne de commande des /Tests .
/Logger:[friendlyName]	Spécifiez un journal pour les résultats de tests. Exemple : Pour stocker les résultats dans un fichier de résultats des tests de Visual Studio (TRX) utilisez /Logger:trx. Exemple : Pour publier les résultats des tests dans Team Foundation Server, utilisez 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>] Remarque Le journal de TfsPublisher a besoin d' Visual Studio 2012 avec [Visual Studio 2012,1] ou version ultérieure.
/ListTests:[nom du fichier]	Répertorie les tests détectés dans le conteneur de tests donné.
/ListDiscoverers	Répertorie les découvreurs de test installés.
/ListExecutors	Répertorie les exécuteurs de test installés.
/ListLoggers	Répertorie les journaux de test installés.
/ListSettingsProviders	Répertorie les fournisseurs de paramètres installés.

Utilisation VSTest.Console.exe avec des fichiers de test

L'utilisation de vstest.console.exe est :

Vstest.console.exe [TestFileNames] [Options]

Voici un exemple de l'utilisation de la ligne de commande VSTest.Console.exe :

Vstest.console.exe myTestProject.dll

Voici un exemple de l'utilisation de la ligne de commande VSTest.Console.exe à l'aide de plusieurs fichiers de test.Cela est fait en séparant les noms de fichiers de test avec des espaces :

Vstest.console.exe myTestFile.dll myOtherTestFile.dll

Exemple

L'exemple suivant illustre l'utilisation de certaines des options pour exécuter Vstest.console.exe.Dans ce cas, il va exécute les tests dans le fichier myTestFile.dll, tout en collectant les données spécifiées dans le fichier Local.RunSettings et dans un processus isolé.En outre, il filtrera les cas de test à exécuter en se basant sur « priorité 1 ", et stocke les résultats dans un fichier .trx.

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

Voir aussi

Concepts

Exécution de tests automatisés à partir de la ligne de commande

Utilisation de VSTest.Console à partir de la ligne de commande