Walkthrough: Using the Command-line Test Utility

This walkthrough shows you how to run unit tests from a command-line prompt and then view the results.


Use the Command-line Test Utility

To use the command-line test utility

  1. Open a Visual Studio command prompt.

    To do this, click Start, point to All Programs, point to Microsoft Visual Studio 2010, point to Visual Studio Tools, and then click Visual Studio 2010 Command Prompt.

    The command prompt opens to the folder: <drive>:\Program Files\Microsoft Visual Studio 10.0\VC

  2. Change directory to the folder that contains the assembly built from your test project.

    To do this, first change directory to your solution folder. For the Bank solution that was created in the prerequisite walkthrough, this folder is: <drive>:\Documents and Settings\<username>\My Documents\Visual Studio\Projects\Bank. Then change directory to the folder for your test project by typing the following command at the command prompt:

    cd TestProject1\bin\Debug

    This folder contains the test project you created in the procedures for creating and running unit tests. The test project assembly, TestProject1.dll, contains just a few unit tests.


    Your production code project and your test project will produce distinct assemblies. Make sure to run the command-line utility on the assembly of the test project, not on the assembly of your production code project.

  3. MSTest.exe is a command-line utility that lets you start and control the execution of tests. You can view the choices that MSTest.exe makes available through its options by typing the following at the command prompt:

    MSTest /?

  4. Use the command-line utility to test the application.

    Type the following at the command prompt:

    MSTest /testcontainer:TestProject1.dll

    This command runs all three tests and returns results such as the following:

    Loading TestProject1.dll...

    Starting Execution...

    Results Top Level Tests

    -------- ------------------

    Inconclusive TestProject1.BankAccountTest.CreditTest

    Passed TestProject1.BankAccountTest.DebitTest

    Passed TestProject1.BankAccountTest.FreezeAccountTest

    2/3 test(s) Passed, 1 Inconclusive



    Test Run Inconclusive.

    Inconclusive 1

    Passed 2


    Total 3

    Results file: <path>\<test run name>.trx

    Test Settings: Default Test Settings


    If you complete the procedure, "Create and Run a Unit Test for a Private Method" in Walkthrough: Creating and Running Unit Tests, this command will also show results for the GetAccountTestType unit test.

  5. Run the tests again and save test results to a specified file.

    Type the following at the command prompt:

    MSTest /testcontainer:TestProject1.dll /resultsfile:testResults1.trx

    This command runs all three tests and returns the same results as in the previous step. It also creates a file that is named testResults1.trx, and writes test results to that file, formatted for viewing in an XML viewer such as Microsoft Internet Explorer or Microsoft Visual Studio. If testResults1.trx already exists, MSTest.exe will not run and will show an error stating that a file with that name already exists.


    For more information about the full range of options you can use with the MSTest command, see MSTest.exe Command-Line Options.

  6. (Optional) View the test results file. Type the following at the command prompt:


    This opens Internet Explorer and displays the test results. Alternatively, you can open this file in the Visual Studio integrated development environment (IDE), as follows:

    1. Click File, point to Open and then click File.

    2. In the Open File dialog box, open the folder that contains the .xml file.

    3. Double-click testResults1.xml.

The command-line utility MSTest.exe is especially useful for automating test runs, to be started in batch files or other utilities.

See Also


How to: Run Automated Tests from the Command Line Using MSTest

Walkthrough: Creating and Running Unit Tests


MSTest.exe Command-Line Options