RunVisualStudioTestsusingTestAgent@1 - İşlevsel testler çalıştırma v1 görevi

2025-06-24

RunVisualStudioTestsusingTestAgent@1 ve yardımcı görevi (Visual Studio Test Aracısı Dağıtımı) kullanım dışıdır. Bunun yerine Visual Studio Test görevini kullanın. VSTest görevi hem birim hem de işlevsel testler çalıştırabilir. Çok aracılı iş ayarını kullanarak bir veya daha fazla aracıda test çalıştırma. Aracıda Visual Studio'ya gerek kalmadan testleri çalıştırmak için Visual Studio Test Platformu görevini kullanın. VSTest görevi, başarısız testleri otomatik olarak yeniden çalıştırma gibi yeni özellikler de getirir.

Sözdizimi

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

Girişler

testMachineGroup - Makineleri
string. Gerekli.

Bağlantı noktası numarasını içerebilen makine FQDN'lerinin veya IP adreslerinin virgülle ayrılmış listesi. Maksimum değer 32 makine veya 32 aracıdır. Liste öğeleri şu şekilde olabilir:

Azure Kaynak Grubu adı.
Makine adlarının virgülle ayrılmış listesi. Örnek: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
Önceki görevlerden bir çıkış değişkeni.

dropLocation - Test Bırakma Konumu
string. Gerekli.

Test makinelerinde test ikili dosyalarının bir Windows Machine Dosya Kopyalama veya Azure Dosya Kopyalama görevi tarafından kopyalandığı konumu belirtir. Bırakma konumunu belirtmek için test aracısı makinelerinden sistem aşaması değişkenleri kullanılabilir. Örnekler: c:\tests ve %systemdrive%\Tests.

testSelection - Test Seçimi
string. Gerekli. İzin verilen değerler: testAssembly (Test Derlemesi), testPlan (Test Planı). Varsayılan değer: testAssembly.

Testlerin nasıl çalıştırılacaklarını belirtir: test derlemeleri veya Test Planı kullanılarak.

Test PlanıtestPlan -
string. testSelection = testPlangerekir.

Bu kuruluş için zaten yapılandırılmış bir test planını belirtir.

Test PaketitestSuite -
string. testSelection = testPlangerekir.

Seçili test planından bir test paketi belirtir.

Test YapılandırmasıtestConfiguration -
string. testSelection = testPlangerekir.

Seçili test planından bir test yapılandırmasını belirtir.

sourcefilters - Test Derlemesi
string. testSelection = testAssemblygerekir. Varsayılan değer: **\*test*.dll.

Testleri çalıştırılacak test ikili dosyalarını belirtir. Joker karakterler kullanılabilir. Örneğin, dosya adında **\*test*.dll; içeren tüm .dll dosyaları için test.

Test Filtresi ölçüttestFilterCriteria -
string. Opsiyonel. testSelection = testAssemblyolduğunda kullanın.

Test derleme dosyaları içinde yürütülecek testleri gösteren filtre. /TestCaseFilter'daki vstest.console.exe seçeneğiyle aynı şekilde çalışır. Örnek: Owner=james&Priority=1.

runSettingsFile - Ayarları Dosya
string.

Testlerle kullanılacak runsettings veya testsettings dosyasının dosya yolunu belirtir.

overrideRunParams - Test Çalıştırması Parametrelerini Geçersiz Kılma
string.

TestRunParameters dosyasının runsettings bölümünde veya Properties dosyasının testsettings bölümünde tanımlanan geçersiz kılma parametrelerini belirtir. Örnek: AppURL=$(DeployURL);Port=8080.

Uyarı

testsettings dosyasında belirtilen özelliklere Test Aracısı 2017 Güncelleştirme 4 veya üzeri kullanılarak TestContext aracılığıyla erişilebilir.

codeCoverageEnabled - Kod Kapsamı Etkin
boolean. Varsayılan değer: false.

Görev için Kod Kapsamı'nın etkinleştirilip etkinleştirilmediğini belirtir.

customSlicingEnabled - Testleri makine sayısına göre dağıtma
boolean. Varsayılan değer: false.

Bu boole değerinin değeri trueolarak ayarlandığında, testler test kapsayıcılarının sayısı yerine sağlanan makine sayısına göre dağıtılır.

Uyarı

Bir .dll içindeki testler de birden çok makineye dağıtılabilir.

Test Çalıştırma başlığıtestRunTitle -
string.

Test çalıştırması için bir ad belirtir.

platform - Peron
string.

Testlerin raporlanması gereken platformu belirtir. Derleme görevinizde platform için bir değişken tanımladıysanız, değişkenini değer olarak kullanın.

configuration - Yapılandırma
string.

Testlerin raporlanması gereken yapılandırmayı belirtir. Derleme görevinizde configuration için bir değişken tanımladıysanız, değişkenini değer olarak kullanın.

testConfigurations - Test Yapılandırmaları
string.

Opsiyonel. Test çalışması filtrelerini test yapılandırma kimliğiyle ilişkilendirir. Sözdizimi: <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>. Örnek: FullyQualifiedName~Chrome:12.

Test MakineleriAltında Uygulamayı autMachineGroup -
string.

W3WP.exegibi sunucu işlemlerinin çalıştığı makinelerin, çıkış değişkenlerinin veya makine grubu adlarının virgülle ayrılmış listesi.

Görev denetimi seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz. Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Temsilci
Talepleri	Hiç kimse
Özellikleri	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Herhangi bir
Ayarlanabilir değişkenleri	Herhangi bir
Aracı sürümü	1.104.0 veya üzeri
Görev kategorisi	Sınav