RunVisualStudioTestsusingTestAgent@1 – Ausführen von Funktionstests v1-Aufgabe

Artikel
2025-03-24

RunVisualStudioTestsusingTestAgent@1 und die zugehörige Begleitaufgabe (Visual Studio Test Agent Deployment) sind veraltet. Verwenden Sie stattdessen die Visual Studio-Testaufgabe. Die VSTest-Aufgabe kann Komponenten sowie Funktionstests ausführen. Führen Sie Tests für einen oder mehrere Agents mit der Einstellung für den Multi-Agent-Auftrag aus. Verwenden Sie die Visual Studio Test Platform-Aufgabe, um Tests auszuführen, ohne Visual Studio für den Agent zu benötigen. Die VSTest-Aufgabe bietet auch neue Funktionen, z. B. das automatische Erneute Ausführen fehlgeschlagener Tests.

Syntax

# Run functional tests v1
# Deprecated: This task and it’s companion task (Visual Studio Test Agent Deployment) are deprecated. Use the 'Visual Studio Test' task instead. The VSTest task can run unit as well as functional tests. Run tests on one or more agents using the multi-agent job setting. Use the 'Visual Studio Test Platform' task to run tests without needing Visual Studio on the agent. VSTest task also brings new capabilities such as automatically rerunning failed tests.
- task: RunVisualStudioTestsusingTestAgent@1
  inputs:
  # Setup Options
    testMachineGroup: # string. Required. Machines. 
    dropLocation: # string. Required. Test Drop Location. 
  # Execution Options
    testSelection: 'testAssembly' # 'testAssembly' | 'testPlan'. Required. Test Selection. Default: testAssembly.
    #testPlan: # string. Required when testSelection = testPlan. Test Plan. 
    #testSuite: # string. Required when testSelection = testPlan. Test Suite. 
    #testConfiguration: # string. Required when testSelection = testPlan. Test Configuration. 
    sourcefilters: '**\*test*.dll' # string. Required when testSelection = testAssembly. Test Assembly. Default: **\*test*.dll.
    #testFilterCriteria: # string. Optional. Use when testSelection = testAssembly. Test Filter criteria. 
    #runSettingsFile: # string. Run Settings File. 
    #overrideRunParams: # string. Override Test Run Parameters. 
    #codeCoverageEnabled: false # boolean. Code Coverage Enabled. Default: false.
    #customSlicingEnabled: false # boolean. Distribute tests by number of machines. Default: false.
  # Reporting Options
    #testRunTitle: # string. Test Run Title. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #testConfigurations: # string. Test Configurations. 
    #autMachineGroup: # string. Application Under Test Machines.

Eingänge

testMachineGroup - Computer
string. Erforderlich.

Eine durch Trennzeichen getrennte Liste von Computer-FQDNs oder IP-Adressen, die möglicherweise die Portnummer enthalten. Das Maximum beträgt 32 Computer oder 32 Agents. Die Listenelemente können folgendes sein:

Der Name einer Azure Resource Group.
Eine durch Trennzeichen getrennte Liste von Computernamen. Beispiel: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
Eine Ausgabevariable aus einem vorherigen Vorgang.

dropLocation - Testablageort
string. Erforderlich.

Gibt den Speicherort auf dem/den Testcomputern an, an dem die Testbinärdateien von einer Windows Machine File Copy oder einer Azure File Copy Aufgabe kopiert wurden. Systemstufenvariablen von den Test-Agent-Computern können verwendet werden, um den Speicherort anzugeben. Beispiele: c:\tests und %systemdrive%\Tests.

testSelection - Testauswahl
string. Erforderlich. Zulässige Werte: testAssembly (Testassembly), testPlan (Testplan). Standardwert: testAssembly.

Gibt an, wie Tests ausgeführt werden: Verwenden von Testassemblys oder Testplan.

testPlan - Testplan
string. Erforderlich, wenn testSelection = testPlan.

Gibt einen Testplan an, der bereits für diese Organisation konfiguriert ist.

testSuite - Test Suite
string. Erforderlich, wenn testSelection = testPlan.

Gibt eine Testsuite aus dem ausgewählten Testplan an.

testConfiguration - Testkonfiguration
string. Erforderlich, wenn testSelection = testPlan.

Gibt eine Testkonfiguration aus dem ausgewählten Testplan an.

sourcefilters - Testassembly
string. Erforderlich, wenn testSelection = testAssembly. Standardwert: **\*test*.dll.

Gibt die Testbinärdateien an, für die Tests ausgeführt werden sollen. Platzhalter können verwendet werden. Beispielsweise **\*test*.dll; für alle .dll Dateien, die test im Dateinamen enthalten.

testFilterCriteria - Testfilterkriterien
string. Wahlfrei. Wird verwendet, wenn testSelection = testAssembly.

Der Filter, der die Tests angibt, die in den Testassemblydateien ausgeführt werden sollen. Funktioniert auf die gleiche Weise wie die option /TestCaseFilter in vstest.console.exe. Beispiel: Owner=james&Priority=1.

runSettingsFile - Einstellungsdatei ausführen
string.

Gibt den Dateipfad zur runsettings oder testsettings Datei an, die mit den Tests verwendet werden soll.

overrideRunParams - Außerkraftsetzen von Testausführungsparametern
string.

Gibt die Außerkraftsetzungsparameter an, die im Abschnitt TestRunParameters der runsettings Datei oder im abschnitt Properties der testsettings Datei definiert sind. Beispiel: AppURL=$(DeployURL);Port=8080.

Hinweis

Auf die in der testsettings Datei angegebenen Eigenschaften kann über TestContext mit Test Agent 2017 Update 4 oder höher zugegriffen werden.

codeCoverageEnabled - Codeabdeckung aktiviert
boolean. Standardwert: false.

Gibt an, ob die Codeabdeckung für die Aufgabe aktiviert ist.

customSlicingEnabled - Verteilen von Tests nach Anzahl von Computern
boolean. Standardwert: false.

Wenn der Wert dieses booleschen Werts auf truefestgelegt ist, werden die Tests basierend auf der Anzahl der bereitgestellten Computer anstelle der Anzahl der Testcontainer verteilt.

Hinweis

Tests innerhalb eines .dll können auch auf mehrere Computer verteilt werden.

testRunTitle - Titel der Testausführung
string.

Gibt einen Namen für die Testausführung an.

platform - Platform
string.

Gibt die Plattform an, für die die Tests gemeldet werden sollen. Wenn Sie eine Variable für platform in Der Buildaufgabe definiert haben, verwenden Sie die Variable als Wert.

configuration - Configuration
string.

Gibt die Konfiguration an, für die die Tests gemeldet werden sollen. Wenn Sie eine Variable für configuration in Der Buildaufgabe definiert haben, verwenden Sie die Variable als Wert.

testConfigurations - Testkonfigurationen
string.

Wahlfrei. Ordnet einen Testfallfilter einer Testkonfigurations-ID zu. Syntax: <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>. Beispiel: FullyQualifiedName~Chrome:12.

autMachineGroup - Anwendung unter Testcomputern
string.

Eine durch Trennzeichen getrennte Liste von Computern, Ausgabevariablen oder Computergruppennamen, auf denen Serverprozesse ausgeführt werden, z. B. W3WP.exe.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	1.104.0 oder höher
Vorgangskategorie	Testen

Freigeben über