MSTest.exe komut satırı seçenekleri

Makale
08/07/2016

Yayýmlanma: Nisan 2016

MSTest.exe testleri çalıştırmak için kullanılan komut satırı komutudur. Bu komut, test çalışmasını özelleştirmek için kullanabileceğiniz birkaç seçeneğe sahiptir. Bu seçeneklerden birçoğunu birbirleriyle kullanabilirsiniz. Aslında, aşağıdaki bölümlerde gösterildiği gibi belirli seçenekleri diğer seçeneklerle birlikte kullanmalısınız. MSTest.exe komut satırında bu seçenekleri herhangi bir sırada belirleyebilirsiniz.

MSTest.exe seçenekleri veya bunlar için küçük büyük harf duyarlı bir şekilde belirtin değerleri yorumlamaz.

Aşağıdaki tablolar, MSTest.exe için tüm seçenekleri ve bunların kısa açıklamalarını listeler. Komut satırına MSTest /h yazarak benzer bir özeti görebilirsiniz.

Genel komut satırı seçenekleri

/testcontainer:[ Dosya adı ]	Testleri içeren bir dosya yükler. Örnek: /testcontainer:tests.dll Daha fazla bilgi için, bkz. /testcontainer.
/testmetadata:[ Dosya adı ]	Test meta verilerini içeren bir dosya yükleyin. Daha fazla bilgi için, bkz. /testmetadata.
/testlist:[ test listesi yolu ]	Çalıştırılacak test listesini meta veri dosyasında belirtildiği gibi belirtin. Daha fazla bilgi için bkz. /testlist.
/category:[ test kategori filtresi ]	Çalıştırılacak test kategorilerini belirtin ve filtreleyin. Daha fazla bilgi için, bkz. /category.
/test:[ test adı ]	Çalıştırılacak testin adını belirtin. Daha fazla bilgi için, bkz. /test.
/noisolation	Testleri MSTest.exe işlemiyle çalıştırın. Bu seçim, test çalışması hızını artırır ancak MSTest.exe işlemine ilişkin riski de artırır.
/testsettings: [ Dosya adı ]	Belirtilen testi ayarları dosyasını kullanın. Örnek: /testsettings:Local.Testsettings Daha fazla bilgi için bkz. /testsettings (test ayarları).
/runconfig:[ Dosya adı ]	Belirtilen çalışma yapılandırma dosyasını kullanın. Örnek: /runconfig:localtestrun.Testrunconfig Daha fazla bilgi için, bkz. /runconfig. Not Bu komut satırı seçeneği, Visual Studio'nun önceki sürümüyle uyumlu olması açısından korunur.Visual Studio Enterprise test ayarlarında test çalışması yapılandırmaları almıştır.
/resultsfile:[ Dosya adı ]	Belirtilen dosyaya sonuçları testi kaydedin. Örnek: /resultsfile:testResults.trx Daha fazla bilgi için, bkz. /resultsfile.
/detail:[ özellik kimliği ]	Değerlerini göstermek istediğiniz özelliğin adını ve varsa buna ek olarak, test çıktısını belirtin. Daha fazla bilgi için, bkz. /detail.
/help	MSTest.exe kullanım iletisini görüntüleyin (kısa form: /? veya /h).
/nologo	Hiç başlangıç başlığı ve telif hakkı iletisi görüntüler.
/usestderr	Hata bilgilerinin çıktısını almak için standart hata kullanın.

Test Sonuçlarını Yayınlamak için Komut Satırı Seçenekleri

Bu seçenekleri hakkında daha fazla bilgi için Test sonuçlarını yayımlamak için Komut Satırı seçenekleri.

/publish:[ Sunucu adı ]	Belirtilen sunucunun ekip projesi koleksiyonu için veritabanlarına sonuçları yayımlayın.
/publishresultsfile:[ Dosya adı ]	Yayımlanacak sonuç dosyası adını belirtin. Hiç sonuç dosya adı belirtilmemişse, geçerli çalışma tarafından üretilen dosyayı kullanın.
/publishbuild:[ yapı kimliği ]	Bu yapı kimliğini kullanarak test sonuçlarını yayımlayın.
/teamproject:[ Ekip projesi adını ]	Yapının ait olduğu ekip projesi adını belirtin.
/platform:[ platformu ]	Test sonuçlarının yayımlanmasına karşılık yapı platformu belirtin.
/flavor:[ özellik ]	Test sonuçlarının yayımlanmasına karşılık yapı tercihini belirtin.

MSTest Seçeneklerini Kullanma

Aşağıdaki bölümlerde, MSTest.exe için seçeneklerin çoğu daha ayrıntılı açıklanmaktadır. Test sonuçlarını yayımlamak üzere kullanılan seçenekler buraya dahil edilmez. Bu seçenekleri hakkında daha fazla bilgi için bkz Test sonuçlarını yayımlamak için Komut Satırı seçenekleri.

/testcontainer

/testcontainer:[ Dosya adı ]

Test kapsayıcı, çalıştırmak istediğiniz testleri içeren bir dosyadır. Örneğin, düzenli testler için, test kapsayıcı düzenli testi tanımlayan .orderedtest dosyasıdır. Birim testler için, birim testi kaynak dosyalarını içeren test projesinden bütünleştirilmiş kod yapısı olur.

Not

Birim testler için, test kodunu içeren bütünleştirilmiş koddur, test ettiğiniz uygulamanın kodunu içeren bütünleştirilmiş kod değil.Örneğin, çözümünüz BankAccount adında bir proje ve BankAccountTest adlı karşılık gelen bir test projesi içeriyorsa /testcontainer:BankAccountTest.dll belirtin.

Not

Test meta veriler dosyası çalıştırabileceğiniz testleri de listelediği için, /testcontainer ve /testmetadata seçeneklerini aynı komut satırında belirlememeniz gerekir.Bunu yapmanız belirsizlik yaratır ve hataya neden olabilir.

/testmetadata

/testmetadata:[ Dosya adı ]

Testleri birden çok test kapsayıcıda çalıştırmak için /testmetadata seçeneğini kullanabilirsiniz.

Test meta veri dosyası, Test Listesi Düzenleyici penceresini kullanarak test listeleri oluşturduğunuzda, çözümünüz için oluşturulur. Bu dosya Test Listesi Düzenleyicisi penceresinde listelenen tüm testler hakkında bilgileri içerir. Bunlar, çözümünüzdeki tüm test projelerinde mevcut olan tüm testlerdir.

Test meta veri dosyası, çözüm klasöründe oluşturulan bir XML dosyasıdır. Bu dosya Çözüm Gezgini'nde Çözüm Öğeleri düğümü altında görüntülenir. Bir test meta verisinin dosya uzantısı .vsmdi'dir ve Test Listesi Düzenleyicisi penceresiyle ilişkilidir. Yani Windows Explorer (veya Dosya Gezgini) içinde .vsmdi dosyasını çift tıklarsanız dosya Visual Studio ve onun içeriğini açar. Çözümün test projelerindeki tüm testler, Test Listesi Düzenleyicisi penceresinde görüntülenir.

Test meta veri dosyası yalnızca bir özelliklerini değiştirme oluşturma veya testleri silme gibi Test Listesi Düzenleyicisini, yansıtılır değişiklikler yaparak değiştirebilirsiniz.

Not

Test kapsayıcı çalıştırabileceğiniz testleri içerdiği için, /testcontainer ve /testmetadata seçeneklerini aynı komut satırında belirlememeniz gerekir.Bunu yapmanız belirsizlik yaratır ve hataya neden olabilir.

Kullandığınızda /testmetadata seçeneğini kullanarak çalıştırmak için belirli testleri belirtmek önerilir /test seçeneği veya /testlist seçeneği veya her ikisi de.

/testlist

/testlist:[ test listesi yolu ]

/testlist seçeneği, test meta veri dosyasında belirtildiği gibi çalıştırılacak testlerin bir listesidir. Birden çok test listesinde bulunan testleri çalıştırmak için /testlist seçeneğini birden çok kez kullanın. Test listesindeki tüm düzenli testler çalıştırılacak.

Not

/testlist seçeneğini yalnızca /testmetadata seçeneği ile birlikte kullanabilirsiniz.

/testlist seçeneğini ve /test seçeneğini birlikte kullanabilirsiniz. Bu, Test Listesi Düzenleyicisi penceresinde bir test listesini ve bir veya daha fazla testi ayrı ayrı seçmeye, ardından Testleri Çalıştır öğesini tıklamaya eşdeğerdir.

/category

/category:[ test kategori filtresi ]

Kullanım /category hangi test kategorisinin çalışacağını belirtmek için seçeneği.

Not

/testcontainer seçeneğini kullanmak için /category seçeneğini kullanmalısınız.

/category seçeneğini her komut satırı için bir kez kullanabilirsiniz, ancak test kategorisi filtresinde birden çok test kategorisi belirleyebilirsiniz. Mantıksal işleçler tarafından ayrılmış bir veya daha fazla test kategori adları test kategori filtresi oluşan 've', ' | ','!', '&!'. Mantıksal işleçler 've' ve ' |' birlikte bir test kategori filtresi oluşturmak için kullanılamaz.

Örnek:

/category:group1 "grup1" test kategorisinde olan testleri çalıştırır.
/category:"group1&group2" test kategorileri "group1" ve "group2." testleri çalıştırır Belirtilen test kategorileri yalnızca biri olan testler çalışmaz.
/category:"group1|group2" "grup1" veya "grup2" test kategorisinde olan testleri çalıştırır. Her iki test kategorisindeki testler de çalıştırılır.
/category:"group1&!group2" test kategorisi "group1" "group2." test kategorisi olmayan testleri çalıştırır Test kategorisi "group1" ve "group2" içinde bir test çalışmaz.

Not

Filtreniz, /category:group1 gibi tek bir kategoriden oluşuyorsa, filtreyi tırnak işaretleriyle ayırmanız gerekmez.Ancak filtre başvurunuz /category:"group1&group2" gibi birden çok kategoriden oluşuyorsa, filtre tırnak işaretleri arasına alınmalıdır.

/test

/test:[ test adı ]

Bireysel testleri çalıştırmak için /test seçeneğini kullanın. Birden çok test çalıştırmak için /test seçeneğini birden çok kez kullanın.

Not

Kullanabileceğiniz /test ya da seçeneğiyle /testcontainer seçeneği veya ile /testmetadata seçeneği, ancak her ikisi de sahip değil.

/test seçeneğiyle belirlediğiniz dize, test kapsayıcıdaki veya test meta veri dosyasındaki testlerin adlarını eşleştirmek için kullanılır. Bu, /test için tek bir değer kullanarak birden çok testi belirtebileceğiniz anlamına gelir. Örneğin, her iki test adı da 'ittest' alt dizesini içerdiğinden /test:ittest öğesini belirlemek, testlerin DebitTest ve CreditTest adlı testlerle eşleşmelerini üretir.

Not

İle belirlediğiniz değer /test seçeneği test yalnızca test adını, aynı zamanda, test yolu karşı Çözüm Gezgini'nde, veya kendi tam adı için birim testleri görüldüğü gibi.

İki kullanım örneği şöyledir:

Birim testi örneği: TestProject2 projesinde UnitTest1.cs dosyası TestMethod1 adında bir birim testi içerir. /test seçeneği için 'ittest' değeri belirlemek de bu testle eşleşir çünkü dize "TestProject2.UnitTest1.TestMethod1" tam adına karşılık test edilir ve 'ittest' dizesi 'UnitTest1' içinde de görünür.

Genel test örneği: aşağıdaki komut satırı belirtilen genel testi çalıştırır ve test sonuçları, test tam yolunu görüntüler.

mstest /testcontainer:"C:\Documents and Settings\<user name>\My Documents\Visual Studio\Projects\TestProject2\TestProject2\generictest1.generic" /test:testproject32\generic

/noisolation

/noisolation

Testleri MSTest.exe işlemiyle çalıştırmak için bu seçeneği kullanın. Bu seçeneği kullanmak, test çalıştırma yapılandırmasında başka hiçbir değişikliğe neden olmaz. Bu seçeneğin amacı test çalıştırma hızını artırmaktır. Ancak, test çalışmasının riskini bütün olarak artırır çünkü test kodu tarafından işlenmemiş özel durum oluşturulursa, test kodu MSTest.exe işleminin çökmesine neden olur.

/testsettings

/testsettings:[ Dosya adı ]

Test ayarları dosyası belirlemek için bu seçeneği kullanın. Örneğin: /testsettings:local.Testsettings

Test ayarları dosyasını /testmetadata seçeneği gibi başka yollarla da belirleyebilirsiniz. Test ayarları dosyasının belirtimini yöneten kurallar burada tanımlanır.

Kullanırsanız, /testsettings seçeneği, de da kullanılacaktır, dosya /testmetadata seçeneği.
Kullanırsanız, /testmetadata değil kullanıyorsanız, test ayarları dosyası etkin test ayarlarını belirleyen bir meta veri dosyası işaret edecek şekilde seçeneği kullanılacak /testsettings seçeneği.
/testsettings seçeneğini kullanmaz ve test meta veri dosyasında test ayarlarını da belirlemezseniz, test çalışması varsayılan test ayarları dosyasını kullanır.

Not

Test ayarı dosyaları hakkında daha fazla bilgi için Microsoft Test Yöneticisi'ni Kullanarak Otomatikleştirilmiş Sistem Testleri için Test Ayarları Oluşturma.

/runconfig

/runconfig:[ Dosya adı ]

Not Bu komut satırı seçeneği, Visual Studio'nun önceki sürümüyle uyumlu olması açısından korunur. Visual Studio Premium'da test ayarları test çalıştırma yapılandırmalarının yerini almıştır.

Çalıştırma yapılandırma dosyasını belirtmek için bu seçeneği kullanın. Örneğin: /runconfig:localtestrun.Testrunconfig

Çalıştırma yapılandırma dosyasını /testmetadata gibi başka yollar kullanarak da belirleyebilirsiniz. Çalıştırma yapılandırma dosyalarının belirtimini yöneten kurallar burada açıklanır.

Kullanırsanız, /runconfig seçeneği, ayrıca olup olmadığına da kullanılır, dosya /testmetadata seçeneği.
Kullanırsanız, /testmetadata yapılandırma dosyası çalışan etkin çalışma yapılandırması belirleyen bir meta veri dosyası işaret edecek şekilde kullanılır kullanmamanız durumunda /runconfig seçeneği.
Kullanmamanız durumunda /runconfig seçeneğini de belirtmemek çalışma yapılandırma dosyasını test meta veri dosyasında, çalıştırmak test çalışması varsayılan yapılandırma dosyası kullanır.

/resultsfile

/resultsfile:[ Dosya adı ]

Adlandırılmış dosyanın test çalıştırması sonuçlarını kaydetmek için bu seçeneği kullanın. Örneğin: /resultsfile:testResults.trx.

/usestderr

/usestderr

Bu seçeneği kullanmak için standart hata yazılması için aşağıdaki bilgileri neden olur:

Başarısız, İptal edildi, Hata, Zaman aşımına uğradı, Çalıştırılamaz veya Yürütülemedi gibi sonuçları içeren testler.
Çalıştırma düzeyi hataları.
Komut satırı değişkenlerini ayrıştırma hataları.
Test sonucu başarısız sonuçlandığında özeti çalıştırın.

Bu seçenek olmadan, tüm çıktılar standart çıktıya gönderilir.

/detail

/detail:[ özellik kimliği ]

Bu seçenek, varsa, ek test çalışması özelliklerini görüntülemek için kullanılır. Birden çok /detail örneğini, her biri bir özellik kimliğine sahip olacak şekilde ve tek bir komut satırında geçirebilirsiniz. /detail seçeneği için geçerli özellik kimliği şu şekildedir:

bağdaştırıcı	kimlik	projectrelativepath
computername	isautomated	salt okunur
debugtrace	bağlantı	spoolmessage
açıklama	longtext	stderr
displaytext (görüntü metni)	ad	stdout
süre	outcometext	depolama
errormessage	owner	testcategoryid
errorstacktrace	parentexecid	testname
executionid	öncelik	testtype
gruplar	projectname	traceinfo

Not

/detail seçeneğiyle kullandığınız özellik kimliklerinin gerçek seçimi test türüne göre değişir.Bu nedenle, bu yalnızca yaklaşık listedir.Özellikle özel test türleri kullanıyorsanız özellik seçimi farklı olabilir.Hangi propertyID'leri kullanabileceğinizi bilmek için test çalıştırması sonucunda oluşturulan test sonuçları dosyasını inceleyin.Dosyaları test hakkında daha fazla bilgi için bkz Nasıl yapılır: Visual Studio'da Web Performansını Yük Testi Sonuçlarını Kaydetme ve Açma.

Özellik belirtilen test çalışması için varsa, onun bilgisi çıkış sonuç özeti bilgilerine dahildir.

Örneğin, komut satırı:

mstest /testcontainer:Errors.dll /detail:testtype

test türü bilgilerini içeren çıktıyı üretir:

              ...
Results                    Top Level Tests
--------                   -----------------
Inconclusive               TestProject2.BankAccountTest.CreditTest
[testtype] = Unit Test
...

Ayrıca bkz.

Reviewing Test Results in Microsoft Test Manager
Komut satırından otomatikleştirilmiş testler çalıştırma

Aracılığıyla paylaş