RunVisualStudioTestsusingTestAgent@1 - Functionele tests uitvoeren v1-taak

Artikel
2025-03-24

RunVisualStudioTestsusingTestAgent@1 en de bijbehorende bijbehorende taak (Implementatie van Visual Studio Test Agent) zijn afgeschaft. Gebruik in plaats daarvan de Visual Studio Test-taak. De VSTest-taak kan eenheid en functionele tests uitvoeren. Voer tests uit op een of meer agents met behulp van de instelling voor meerdere agenttaken. Gebruik de taak Visual Studio Test Platform om tests uit te voeren zonder Visual Studio op de agent te hoeven gebruiken. VsTest-taak biedt ook nieuwe mogelijkheden, zoals het automatisch opnieuw uitvoeren van mislukte tests.

Syntaxis

# 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.

Invoer

testMachineGroup - Machines
string. Verplicht.

Een door komma's gescheiden lijst met FQDN's of IP-adressen van computers, waaronder het poortnummer. Het maximum is 32 machines of 32 agents. De lijstitems kunnen het volgende zijn:

De naam van een Azure-resourcegroep.
Een door komma's gescheiden lijst met computernamen. Voorbeeld: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
Een uitvoervariabele van een vorige taak.

dropLocation - locatie voor neerzetten testen
string. Verplicht.

Hiermee geeft u de locatie op van de testcomputer(s) waar de binaire testbestanden zijn gekopieerd door een Windows-machinebestand kopiëren of een Azure File Copy- taak. Systeemfasevariabelen van de testagentcomputers kunnen worden gebruikt om de locatie voor neerzetten op te geven. Voorbeelden: c:\tests en %systemdrive%\Tests.

testSelection - selectie testen
string. Verplicht. Toegestane waarden: testAssembly (testassembly), testPlan (testplan). Standaardwaarde: testAssembly.

Hiermee geeft u op hoe tests worden uitgevoerd: met behulp van testassembly's of testplan.

testPlan - testplan
string. Vereist wanneer testSelection = testPlan.

Hiermee geeft u een testplan op dat al is geconfigureerd voor deze organisatie.

testSuite - Test Suite-
string. Vereist wanneer testSelection = testPlan.

Hiermee geeft u een testpakket op uit het geselecteerde testplan.

testConfiguration - configuratie testen
string. Vereist wanneer testSelection = testPlan.

Hiermee geeft u een testconfiguratie van het geselecteerde testplan op.

sourcefilters - testassembly
string. Vereist wanneer testSelection = testAssembly. Standaardwaarde: **\*test*.dll.

Hiermee geeft u de binaire testbestanden op waarop tests moeten worden uitgevoerd. U kunt jokertekens gebruiken. Bijvoorbeeld **\*test*.dll; voor alle .dll bestanden met test in de bestandsnaam.

testFilterCriteria - Filtercriteria testen
string. Facultatief. Gebruiken wanneer testSelection = testAssembly.

Het filter waarmee de tests worden opgegeven die in de testassemblybestanden moeten worden uitgevoerd. Werkt op dezelfde manier als de optie /TestCaseFilter in vstest.console.exe. Voorbeeld: Owner=james&Priority=1.

runSettingsFile - Bestand met instellingen uitvoeren
string.

Hiermee geeft u het bestandspad naar het runsettings- of testsettings-bestand dat moet worden gebruikt met de tests.

overrideRunParams - Testuitvoeringsparameters overschrijven
string.

Hiermee geeft u de onderdrukkingsparameters op die zijn gedefinieerd in de TestRunParameters sectie van het runsettings bestand of de Properties sectie van het testsettings bestand. Voorbeeld: AppURL=$(DeployURL);Port=8080.

Notitie

De eigenschappen die zijn opgegeven in het testsettings-bestand, kunnen worden geopend via TestContext met Test Agent 2017 Update 4 of hoger.

codeCoverageEnabled - codedekking ingeschakeld
boolean. Standaardwaarde: false.

Hiermee geeft u op of codedekking is ingeschakeld voor de taak.

customSlicingEnabled - tests distribueren op aantal machines
boolean. Standaardwaarde: false.

Wanneer de waarde van deze Booleaanse waarde is ingesteld op true, worden de tests gedistribueerd op basis van het aantal machines dat is opgegeven in plaats van het aantal testcontainers.

Notitie

Tests binnen een .dll kunnen ook worden gedistribueerd naar meerdere computers.

titel van testRunTitle - testuitvoering
string.

Hiermee geeft u een naam voor de testuitvoering.

platform - Platform-
string.

Hiermee geeft u het platform waarop de tests moeten worden gerapporteerd. Als u een variabele hebt gedefinieerd voor platform in uw build-taak, gebruikt u de variabele als de waarde.

configuration - configuratie
string.

Hiermee geeft u de configuratie op waarmee de tests moeten worden gerapporteerd. Als u een variabele hebt gedefinieerd voor configuration in uw build-taak, gebruikt u de variabele als de waarde.

testConfigurations - configuraties testen
string.

Facultatief. Koppelt een testcasefilter aan een testconfiguratie-id. Syntaxis: <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>. Voorbeeld: FullyQualifiedName~Chrome:12.

autMachineGroup - toepassing onder testmachines
string.

Een door komma's gescheiden lijst met machines, uitvoervariabelen of computergroepnamen waarop serverprocessen, zoals W3WP.exe, worden uitgevoerd.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Vertegenwoordiger
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	1.104.0 of hoger
Taakcategorie	Testen

Delen via