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

Dit artikel bevat een centraal toegangspunt voor MTP-opdrachtregelopties.

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 de diagnostische logboekregistratie in. Het standaardlogboekniveau is Trace. Het bestand is geschreven in de uitvoermap met de volgende naamindeling, log_[MMddHHssfff].diag.

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

• --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. Standaardwaarde is "log".

• --diagnostic-verbosity

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

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

• --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 het minimale aantal tests op dat naar verwachting moet worden uitgevoerd. Standaard wordt verwacht dat ten minste één test wordt uitgevoerd.

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

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

Uitbreidingsopties per scenario

Gebruik de volgende tabel om snel uitbreidingsopties te vinden.

Opties ontdekken in uw test-app

Voer uw testuitvoerbare bestand uit met --help om de opties voor uw huidige extensieset weer te geven.

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

Zie ook

• Overzicht van MTP
• MTP-functies
• Testen met dotnet test