dotnet vstestdotnet vstest

Dieses Thema gilt für: ✓ .NET Core SDK 1.x .NET Core SDK 2.0This topic applies to: ✓ .NET Core SDK 1.x .NET Core SDK 2.0

nameName

dotnet-vstest: Führt Tests auf Grundlage der angegebenen Dateien aus.dotnet-vstest - Runs tests from the specified files.

ÜbersichtSynopsis

dotnet vstest [<TEST_FILE_NAMES>] [--Settings|/Settings] [--Tests|/Tests] [--TestAdapterPath|/TestAdapterPath] [--Platform|/Platform] [--Framework|/Framework] [--Parallel|/Parallel] [--TestCaseFilter|/TestCaseFilter] [--logger|/logger] [-lt|--ListTests|/lt|/ListTests] [--ParentProcessId|/ParentProcessId] [--Port|/Port] [--Diag|/Diag] [[--] <args>...]] [-?|--Help|/?|/Help]

descriptionDescription

Der dotnet-vstest-Befehl führt die VSTest.Console-Befehlszeilenanwendung aus, um automatisierte Komponententests und Tests der codierten UI-Anwendung auszuführen.The dotnet-vstest command runs the VSTest.Console command-line application to run automated unit and coded UI application tests.

ArgumenteArguments

TEST_FILE_NAMES

Führt Tests auf Grundlage der angegebenen Assemblys aus.Run tests from the specified assemblies. Trennt mehrere Test-Assemblynamen durch Leerzeichen.Separate multiple test assembly names with spaces.

OptionenOptions

--Settings|/Settings:<Settings File>

Einstellungen, die beim Ausführen von Tests verwendet werden.Settings to use when running tests.

--Tests|/Tests:<Test Names>

Führt Tests aus, die mit den eingegebenen Werten übereinstimmen.Run tests with names that match the provided values. Trennt mehrere Werte per Komma voneinander ab.Separate multiple values with commas.

--TestAdapterPath|/TestAdapterPath

Verwendet benutzerdefinierte Testadapter aus einem angegebenen Pfad (falls vorhanden) im Testlauf.Use custom test adapters from a given path (if any) in the test run.

--Platform|/Platform:<Platform type>

Verwendete Zielplattformarchitektur für die Testausführung.Target platform architecture used for test execution. Gültige Werte sind x86, x64 und ARM.Valid values are x86, x64, and ARM.

--Framework|/Framework:<Framework Version>

.NET Framework-Zielversion, in der der Test ausgeführt wird.Target .NET Framework version used for test execution. Beispiele für gültige Werte sind .NETFramework,Version=v4.6, .NETCoreApp,Version=v1.0 usw. Andere unterstützte Werte sind Framework35, Framework40, Framework45 und FrameworkCore10.Examples of valid values are .NETFramework,Version=v4.6, .NETCoreApp,Version=v1.0, etc. Other supported values are Framework35, Framework40, Framework45, and FrameworkCore10.

--Parallel|/Parallel

Führt Tests parallel aus.Execute tests in parallel. Standardmäßig stehen alle verfügbaren Kerne auf dem Computer zur Nutzung zur Verfügung.By default, all available cores on the machine are available for use. Legt eine explizite Zahl an Kernen mit einer Einstellungsdatei fest.Set an explicit number of cores with a settings file.

--TestCaseFilter|/TestCaseFilter:<Expression>

Führt Tests aus, die mit dem angegebenen Ausdruck übereinstimmen.Run tests that match the given expression. <Expression> hat das Format <property>Operator<value>[|&<Expression>], wobei der Operator =, !=, oder ~ ist.<Expression> is of the format <property>Operator<value>[|&<Expression>], where Operator is one of =, !=, or ~. Operator ~ verfügt über „contains“-Semantik und gilt für Zeichenfolgeneigenschaften wie DisplayName.Operator ~ has 'contains' semantics and is applicable for string properties like DisplayName. Klammern () werden verwendet, um untergeordnete Ausdrücke zu gruppieren.Parenthesis () are used to group sub-expressions.

-?|--Help|/?|/Help

Druckt eine kurze Hilfe für den Befehl.Prints out a short help for the command.

--logger|/logger:<Logger Uri/FriendlyName>

Geben Sie eine Protokollierung für die Testergebnisse an.Specify a logger for test results.

  • Verwenden Sie den TfsPublisher-Protokollierungsanbieter zum Veröffentlichen von Testergebnissen in Team Foundation Server:To publish test results to Team Foundation Server, use the TfsPublisher logger provider:

    /logger:TfsPublisher;
        Collection=<team project collection url>;
        BuildName=<build name>;
        TeamProject=<team project name>
        [;Platform=<Defaults to "Any CPU">]
        [;Flavor=<Defaults to "Debug">]
        [;RunTitle=<title>]
    
  • Verwenden Sie zum Protokollieren von Ergebnissen in einer Visual Studio-Testergebnisdatei (TRX) den trx-Protokollierungsanbieter.To log results to a Visual Studio Test Results File (TRX), use the trx logger provider. Dieser Schalter erstellt eine Datei im Verzeichnis mit den Testergebnissen mit dem angegebenen Protokolldateinamen.This switch creates a file in the test results directory with given log file name. Wenn LogFileName nicht angegeben wird, wird ein eindeutiger Dateiname erstellt, um die Testergebnisse aufzunehmen.If LogFileName isn't provided, a unique file name is created to hold the test results.

    /logger:trx [;LogFileName=<Defaults to unique file name>]
    

-lt|--ListTests|/lt|/ListTests:<File Name>

Listet gefundene Tests aus dem angegebenen Testcontainer auf.Lists discovered tests from the given test container.

--ParentProcessId|/ParentProcessId:<ParentProcessId>

Prozess-ID des übergeordneten Prozesses, der für den Start des aktuellen Prozesses verantwortlich ist.Process Id of the parent process responsible for launching the current process.

--Port|/Port:<Port>

Gibt den Port für die Socketverbindung an und empfängt die Ereignismeldungen.Specifies the port for the socket connection and receiving the event messages.

--Diag|/Diag:<Path to log file>

Aktiviert die ausführlichen Protokolle für die Testplattform.Enables verbose logs for the test platform. Protokolle werden in die angegebene Datei geschrieben.Logs are written to the provided file.

args

Gibt zusätzliche Argumente an, die an den Adapter übergeben werden sollen.Specifies extra arguments to pass to the adapter. Argumente werden als Name-Wert-Paare des Formulars <n>=<v> angegeben, wobei <n> der Argumentname und <v> der Argumentwert ist.Arguments are specified as name-value pairs of the form <n>=<v>, where <n> is the argument name and <v> is the argument value. Trennt mehrere Argumente durch Leerzeichen.Use a space to separate multiple arguments.

BeispieleExamples

Führt Tests in mytestproject.dll aus:Run tests in mytestproject.dll:

dotnet vstest mytestproject.dll

Führen Sie Tests in mytestproject.dll aus, und exportieren Sie sie in den benutzerdefinierten Ordner mit benutzerdefiniertem Namen:Run tests in mytestproject.dll, exporting to custom folder with custom name:

dotnet vstest mytestproject.dll --logger:"trx;LogFileName=custom_file_name.trx" --ResultsDirectory:custom/file/path

Führt Tests in mytestproject.dll und myothertestproject.exe aus:Run tests in mytestproject.dll and myothertestproject.exe:

dotnet vstest mytestproject.dll myothertestproject.exe

Führt TestMethod1-Tests aus:Run TestMethod1 tests:

dotnet vstest /Tests:TestMethod1

Führt TestMethod1- und TestMethod2-Tests aus:Run TestMethod1 and TestMethod2 tests:

dotnet vstest /Tests:TestMethod1,TestMethod2