Microsoft. Naslaginformatie over CLI-opties voor Testing.Platform (MTP)

Dit artikel bevat een centraal toegangspunt voor MTP-opdrachtregelopties.

Important

Platformopties zijn beschikbaar via MTP zelf. Uitbreidingsopties zijn alleen beschikbaar wanneer elke doeltesttoepassing het extensiepakket registreert dat deze biedt. Voeg het pakket rechtstreeks toe of gebruik een test-SDK-configuratie of -profiel dat het bevat. Als een testtoepassing de extensie niet registreert, mislukt de uitvoering met afsluitcode 5 omdat de optie niet wordt herkend.

Opties voor platforms

@

Hiermee geeft u de naam van het antwoordbestand. De naam van het antwoordbestand moet onmiddellijk het @ teken volgen zonder spatie tussen het @ teken en de naam van het antwoordbestand.

Opties in een antwoordbestand worden geïnterpreteerd alsof ze op die plaats op de commandoregel aanwezig waren. U kunt het backslash-teken \ niet gebruiken om lijnen samen te voegen. Het gebruik van een antwoordbestand helpt bij zeer lange opdrachten die de terminallimieten kunnen overschrijden. U kunt een antwoordbestand combineren met inline opdrachtregelargumenten. Voorbeeld:
```
./TestExecutable.exe @"filter.rsp" --timeout 10s
```
waarbij filter.rsp- de volgende inhoud kan hebben:
```
--filter "A very long filter"
```
Of één rsp-bestand kan worden gebruikt om zowel time-out als filter als volgt op te geven:
```
./TestExecutable.exe @"arguments.rsp"
```
```
--filter "A very long filter" --timeout 10s
```
Opmerking

Bij het gebruik van dotnet test gebruikt de SDK-opdrachtregelparser een token-per-regelbenadering, waarbij elke regel in het antwoordbestand als één token wordt behandeld. In dat geval moet elk argument op een afzonderlijke regel staan:
```
--filter
A very long filter
--timeout
10s
```
--config-file

Geeft een testconfig.json bestand op.
--debug

Onderbreekt de testuitvoering bij het opstarten, zodat u een foutopsporingsprogramma aan het testproces kunt koppelen. Gelijk aan het instellen van de TESTINGPLATFORM_WAIT_ATTACH_DEBUGGERomgevingsvariabele op 1. Niet ondersteund op browserplatforms.

Opmerking

Deze optie is beschikbaar in MTP vanaf versie 1.9.0. Het vervangt de vorige --debug-wait-attach optie (geïntroduceerd in MTP 1.6.0); de oude naam is verwijderd en mag niet meer worden gebruikt.
--diagnostic

Hiermee schakelt u diagnostische logboekregistratie in. Het standaardlogboekniveau is Trace. Voor elke testbron schrijft MTP <asm>_<tfm>_<arch>_<timestamp>.diag. Als er een tijdstempelconflict optreedt, voegt MTP een proces- en tellersuffix toe in plaats van het bestaande bestand te overschrijven.
--diagnostic-synchronous-write

Dwingt de ingebouwde bestandslogger om logboeken synchroon te schrijven. Handig voor scenario's waarin u geen logboekvermeldingen wilt verliezen (als het proces vastloopt). Hierdoor wordt de testuitvoering vertraagd.

Opmerking

Beschikbaar in MTP vanaf versie 2.0.0. Deze vervangt de vorige --diagnostic-filelogger-synchronouswrite optie, die is verwijderd in MTP 2.0.0.
--diagnostic-output-directory

De uitvoermap van de diagnostische logboekregistratie, indien niet opgegeven, wordt het bestand gegenereerd in de standaardmap TestResults map.
--diagnostic-file-prefix

Het voorvoegsel voor de naam van het logboekbestand. De standaardwaarde is <asm>_<tfm>_<arch>.

Opmerking

Beschikbaar in MTP vanaf versie 2.0.0. Deze vervangt de vorige --diagnostic-output-fileprefix optie, die is verwijderd in MTP 2.0.0.
--diagnostic-verbosity

Definieert het uitgebreidheidsniveau wanneer de --diagnostic switch wordt gebruikt. De beschikbare waarden zijn Trace, Debug, Information, Warning, Errorof Critical.
--enable-dynamic-extensions

Hiermee schakelt u het laden van extensies in die zijn gedeclareerd door *.testingplatformextensions.json manifestbestanden naast de testtoepassing. Dynamische extensies zijn standaard uitgeschakeld. Zie Laadextensies dynamisch voor beveiligingsvereisten en het manifestschema.

Opmerking

Deze optie is beschikbaar in MTP vanaf versie 2.4.0.
--exit-on-process-exit

Sluit het testproces af wanneer het afhankelijke proces wordt afgesloten. PID moet worden opgegeven.
--filter-uid

Filtert de tests die moeten worden uitgevoerd op basis van de UID's van hun testknooppunten. Accepteert een of meer UID's.

Opmerking

Deze optie is beschikbaar in MTP vanaf versie 1.8.0. Vanaf MTP 2.3.0 kunt u --filter-uid niet combineren met --treenode-filter; als u beide opgeeft, mislukt de validatie van de opdrachtregel met de exitcode InvalidCommandLine.
--help

Hiermee wordt een beschrijving afgedrukt van hoe de opdracht gebruikt moet worden.
--ignore-exit-code

Hiermee kunnen sommige niet-nul afsluitcodes worden genegeerd en in plaats daarvan worden geretourneerd als 0. Zie Specifieke afsluitcodes negerenvoor meer informatie.
--info

Geeft geavanceerde informatie weer over de .NET Testtoepassing, zoals:
- Het platform.
- De omgeving.
- Elke geregistreerde opdrachtregelprovider, zoals de bijbehorende name, version, descriptionen options.
- Elk geregistreerd hulpprogramma, zoals de bijbehorende command, name, version, description en alle opdrachtregelproviders.
Deze functie wordt gebruikt om inzicht te verkrijgen in extensies die dezelfde opdrachtregeloptie registreren of de wijzigingen in beschikbare opties tussen meerdere versies van een extensie (of het platform).
--list-tests

Geeft een lijst weer van de beschikbare tests zonder deze uit te voeren. Optioneel gebruikt u een argument waarmee de uitvoerindeling wordt beheerd: text (standaard, leesbaar voor mensen) of json.

Opmerking

De json uitvoerindeling is beschikbaar in MTP vanaf versie 2.3.0.
--maximum-failed-tests

Hiermee geeft u het maximum aantal mislukte tests op dat, wanneer bereikt, de testuitvoering stopt. Ondersteuning voor deze switch vereist dat frameworkauteurs de IGracefulStopTestExecutionCapability-mogelijkheid implementeren. De afsluitcode bij het bereiken van die hoeveelheid testfouten is 13. Zie MTP-afsluitcodes voor meer informatie.

Opmerking

Deze functie is beschikbaar in MTP vanaf versie 1.5.
--minimum-expected-tests

Hiermee geeft u een positief minimum aantal tests op dat moet worden uitgevoerd. Wanneer de uitvoering minder tests uitvoert, inclusief nul, wordt deze afgesloten met code 9. Een expliciet minimum heeft voorrang op --zero-tests-policy.

Met dotnet test geldt deze optie voor de volledige uitvoering als deze vóór -- wordt opgegeven, en voor elke testmodule als deze na -- wordt opgegeven. Zie minimumaantallen voor volledige uitvoering en per module voor meer informatie.

Opmerking

--minimum-expected-tests 0 is ongeldig. Gebruik --ignore-exit-code 8 om de exitcode van zero-tests te onderdrukken.
--no-banner

Hiermee schakelt u de opstartbanner, het copyrightbericht en de telemetriebanner uit. Hetzelfde effect kan worden bereikt via de TESTINGPLATFORM_NOBANNER of DOTNET_NOLOGOomgevingsvariabelen.
--results-directory

De map waar de testresultaten worden geplaatst. Als de opgegeven map niet bestaat, wordt deze gemaakt. De standaardwaarde is TestResults in de map die de testtoepassing bevat.
--server

Hiermee start u de testtoepassing in JSON-RPC servermodus voor de integratie van editor, IDE of hulpprogramma's. Laat de waarde weg of gebruik jsonrpc. Zie de MTP-servermodus voor een ondersteunde bronclient.

Important

De dotnettestcli waarde en de transportargumenten zijn intern voor de .NET SDK-integratie. Geef ze niet handmatig door.
--show-slowest-tests

Toont het aangevraagde aantal traagste tests in de terminalsamenvatting. Wanneer een uitvoering meerdere testmodules bevat, rapporteert MTP de traagste tests voor elke module.

Opmerking

Deze optie is beschikbaar in MTP vanaf versie 2.4.0.
--timeout

Een time-out voor de uitvoering van een globale test. Gebruikt één argument als tekenreeks in de notatie <value>[h|m|s] waar <value> zwevend is.
--treenode-filter

Filtert de uit te voeren tests met een boomfilterexpressie. Boomfilters bieden uitgebreidere matchmogelijkheden dan --filter voor geavanceerde scenario's.

Opmerking

Vanaf MTP 2.3.0 kunt u --treenode-filter niet combineren met --filter-uid; als u beide opgeeft, mislukt de validatie van de opdrachtregel met de exitcode InvalidCommandLine.
--zero-tests-policy

Hiermee bepaalt u of een uitvoering die geen tests uitvoert omdat elke test is overgeslagen, wordt behandeld als een fout. Geldige waarden zijn allow-skipped (standaard) en strict. Met allow-skipped is een run waarin alles wordt overgeslagen geslaagd. Met strict treedt er een fout op met afsluitcode 8. Een expliciete --minimum-expected-tests waarde vervangt dit beleid en gebruikt afsluitcode 9 wanneer niet aan het minimum wordt voldaan.

Opmerking

Deze optie is beschikbaar in MTP vanaf versie 4.3.0. Geef met dotnet test de optie door na -- om deze naar elke testmodule door te sturen. Wanneer u geen globaal minimum instelt, bepaalt de .NET 11 SDK het volledig uitgevoerde nultestbeoordeling afzonderlijk. Zie minimumaantallen voor volledige uitvoering en per module voor meer informatie.

Uitbreidingsopties per scenario

Gebruik de volgende tabel om het pakket en de opties van elke extensie te vinden. Een test-SDK-profiel kan een pakket leveren in plaats van een directe pakketreferentie.

Scenario	Vereist onderdeel	Functiedocumentatie
Codedekking verzamelen	`Microsoft.Testing.Extensions.CodeCoverage` of `coverlet.MTP`	Codedekking
crash- of hangdumps verzamelen	`Microsoft.Testing.Extensions.CrashDump` of `Microsoft.Testing.Extensions.HangDump`	Crash- en hangdumps
Testrapporten genereren	Het extensiepakket voor de geselecteerde indeling, zoals `Microsoft.Testing.Extensions.TrxReport`	Testrapporten
Terminaluitvoer aanpassen	MTP-kern (geen extra pakket)	Terminaluitvoer
Mislukte tests opnieuw proberen	`Microsoft.Testing.Extensions.Retry`	Opnieuw proberen

Opties ontdekken in uw test-app

Voer het uitvoerbare testbestand uit met --helpof voer deze uit dotnet test --help in de MTP-modus om de beschikbare opties voor uw huidige extensieset weer te geven.

Voor geavanceerde diagnostiek van geregistreerde providers en opties, uitvoeren met --info.

Zie ook

Feedback

Is deze pagina nuttig?

Last updated on 2026-09-14