Teilen über


RunVisualStudioTestsusingTestAgent@1: Task "Funktionstests v1" ausführen

RunVisualStudioTestsusingTestAgent@1 und die zugehörige Begleitaufgabe (Visual Studio Test Agent-Bereitstellung) sind veraltet. Verwenden Sie stattdessen den Visual Studio-Testtask. Der VSTest-Task kann sowohl Komponenten- als auch Funktionstests ausführen. Führen Sie Tests für einen oder mehrere Agents mithilfe der Auftragseinstellung mit mehreren Agents aus. Verwenden Sie die Visual Studio-Testplattform-Aufgabe, um Tests auszuführen, ohne Visual Studio auf dem Agent zu benötigen. Der VSTest-Task 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.
# 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.

Eingaben

testMachineGroup - Maschinen
string. Erforderlich.

Eine durch Trennzeichen getrennte Liste von Computer-FQDNs oder IP-Adressen, die die Portnummer enthalten kann. Der Höchstwert beträgt 32 Computer oder 32 Agents. Die Listenelemente können wie folgt sein:

  • Der Name einer Azure-Ressourcengruppe.
  • Eine durch Trennzeichen getrennte Liste von Computernamen. Beispiel: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
  • Eine Ausgabevariable aus einer vorherigen Aufgabe.

dropLocation - Testablageort
string. Erforderlich.

Gibt den Speicherort auf den Testcomputern an, auf denen die Testbinärdateien von einer Windows-Computerdateikopie oder einem Azure-Dateikopiertask kopiert wurden. Systemstufenvariablen der Test-Agent-Computer können zur Angabe des Speicherorts verwendet werden. 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: mithilfe von Testassemblys oder Testplan.


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

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


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

Gibt eine Testsammlung 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 für alle .dll Dateien, **\*test*.dll; die im Dateinamen enthalten test sind.


testFilterCriteria - Kriterien des Testfilters
string. Optional. Verwenden Sie , wenn testSelection = testAssembly.

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


runSettingsFile - Ausführungseinstellungsdatei
string.

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


overrideRunParams - Überschreiben von Testlaufparametern
string.

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

Hinweis

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


codeCoverageEnabled - Code Coverage aktiviert
boolean. Standardwert. false.

Gibt an, ob code coverage für den Task 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 - Plattform
string.

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


configuration - Konfiguration
string.

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


testConfigurations - Testkonfigurationen
string.

Optional. Ordnet einer Testkonfigurations-ID einen Testfallfilter 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 wie W3WP.exeausgeführt werden.


Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf Agent
Forderungen Keine
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Any
Einstellbare Variablen Any
Agent-Version 1.104.0 oder höher
Aufgabenkategorie Testen