I can't figure out how to run a single test case

I want to run a single [Fact] in my test assembly. I should be able to figure out how to do this using dotnet test --help without having to go to the internet where there is no documentation for this yet.

Here are my steps:

$dotnet test --help

Additional Arguments:
 Any extra command-line runsettings arguments that should be passed to vstest. See 'dotnet vstest --help' for available options.

$dotnet vstest --help

Options:

--Tests|/Tests:<Test Names>
      Run tests with names that match the provided values. To provide multiple
      values, separate them by commas.
      Examples: /Tests:TestMethod1
                /Tests:TestMethod1,testMethod2

$dotnet test --Tests:MyTest

MSBUILD : error MSB1001: Unknown switch.
Switch: --Tests:myTest

For switch syntax, type "MSBuild /help"

[eerhardt]

Does this address the concern?

No. The Additional Arguments section doesn’t work, as pointed out above.

People coming from the project.json world are used to using the underlying test runner args (like xunit specific args) at the end of the command and those args getting passed through to the underlying test runner.

We should update the additional args message, or make the vstest args work correctly.

[livarcocc]

The help has since been updated and particularly the runsettings now explicitly determines the – separator before passing commands to the runner directly.

I tried dotnet test -- --Tests:Test1 after creating a xunit project and it worked.