RunVisualStudioTestsusingTestAgent@1 – Kör funktionstester v1-uppgift

Artikel
2025-03-24

RunVisualStudioTestsusingTestAgent@1 och dess tillhörande uppgift (Distribution av Visual Studio-testagent) är inaktuella. Använd Visual Studio-testaktiviteten i stället. VSTest-aktiviteten kan köra enheten och funktionella tester. Kör tester på en eller flera agenter med hjälp av jobbinställningen för flera agenter. Använd uppgiften Visual Studio Test Platform för att köra tester utan att behöva Visual Studio på agenten. VSTest-uppgiften ger också nya funktioner, till exempel automatisk omkörning av misslyckade tester.

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.

Ingångar

testMachineGroup - Datorer
string. Obligatoriskt.

En kommaavgränsad lista över dator-FQDN eller IP-adresser, som kan innehålla portnumret. Maximalt är 32 datorer eller 32 agenter. Listobjekten kan vara:

Namnet på en Azure-resursgrupp.
En kommaavgränsad lista över datornamn. Exempel: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
En utdatavariabel från en tidigare aktivitet.

dropLocation - Test Drop Location
string. Obligatoriskt.

Anger den plats på testdatorerna där test binärfilerna har kopierats av en Windows Machine File Copy eller en Azure File Copy uppgift. Systemstegvariabler från testagentdatorerna kan användas för att ange släppplatsen. Exempel: c:\tests och %systemdrive%\Tests.

testSelection - testval
string. Obligatoriskt. Tillåtna värden: testAssembly (testsammansättning), testPlan (testplan). Standardvärde: testAssembly.

Anger hur tester körs: med hjälp av testsammansättningar eller testplan.

testPlan - testplan
string. Krävs när testSelection = testPlan.

Anger en testplan som redan har konfigurerats för den här organisationen.

testSuite - Test Suite
string. Krävs när testSelection = testPlan.

Anger en testsvit från den valda testplanen.

testConfiguration - testkonfiguration
string. Krävs när testSelection = testPlan.

Anger en testkonfiguration från den valda testplanen.

sourcefilters - testsammansättning
string. Krävs när testSelection = testAssembly. Standardvärde: **\*test*.dll.

Anger de test binärfiler som ska köras tester på. Jokertecken kan användas. Till exempel **\*test*.dll; för alla .dll filer som innehåller test i filnamnet.

testFilterCriteria - testfiltervillkor
string. Valfritt. Använd när testSelection = testAssembly.

Filtret som anger vilka tester som ska köras i testsammansättningsfilerna. Fungerar på samma sätt som alternativet /TestCaseFilter i vstest.console.exe. Exempel: Owner=james&Priority=1.

runSettingsFile - Kör
string.

Anger filsökvägen till den runsettings- eller testsettings fil som ska användas med testerna.

overrideRunParams - åsidosätt testkörningsparametrar
string.

Anger de åsidosättningsparametrar som definieras i avsnittet TestRunParameters i filen runsettings eller Properties i testsettings-filen. Exempel: AppURL=$(DeployURL);Port=8080.

Anmärkning

De egenskaper som anges i testsettings-filen kan nås via TestContext med testagenten 2017 Uppdatering 4 eller senare.

codeCoverageEnabled - kodtäckning aktiverat
boolean. Standardvärde: false.

Anger om kodtäckning är aktiverat för aktiviteten.

customSlicingEnabled - Distribuera tester efter antal datorer
boolean. Standardvärde: false.

När värdet för det här booleska värdet är inställt på truedistribueras testerna baserat på antalet datorer som tillhandahålls i stället för antalet testcontainrar.

Anmärkning

Tester inom en .dll kan också distribueras till flera datorer.

testRunTitle - testkörningsrubrik
string.

Anger ett namn för testkörningen.

platform - Platform
string.

Anger den plattform som testerna ska rapporteras mot. Om du har definierat en variabel för platform i din bygguppgift använder du variabeln som värde.

configuration - Konfiguration
string.

Anger den konfiguration som testerna ska rapporteras mot. Om du har definierat en variabel för configuration i din bygguppgift använder du variabeln som värde.

testConfigurations - testkonfigurationer
string.

Valfritt. Associerar ett testfallsfilter mot ett testkonfigurations-ID. Syntax: <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>. Exempel: FullyQualifiedName~Chrome:12.

autMachineGroup - program under testdatorer
string.

En kommaavgränsad lista över datorer, utdatavariabler eller datorgruppnamn som serverprocesser, till exempel W3WP.exe, körs på.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Ombud
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	1.104.0 eller senare
Aktivitetskategori	Test

Dela via