Microsoft.Testing.Platform (MTP) referens för CLI-alternativ

Den här artikeln innehåller en central startpunkt för MTP-kommandoradsalternativ.

Plattformsalternativ

• @

  Anger namnet på svarsfilen. Svarsfilens namn måste omedelbart följa @ tecknet utan blanksteg mellan @ tecknet och svarsfilens namn.

  Alternativ i en svarsfil tolkas som om de fanns på den platsen på kommandoraden. Du kan inte använda omvänt snedstreck \ för att sammanfoga linjer. Att använda en svarsfil hjälper till med mycket långa kommandon som kan överskrida terminalgränserna. Du kan kombinera en svarsfil med infogade kommandoradsargument. Till exempel:

  ./TestExecutable.exe @"filter.rsp" --timeout 10s
  

  där filter.rsp kan ha följande innehåll:

  --filter "A very long filter"
  

  Eller så kan en enskild rsp-fil användas för att ange både tidsgräns och filter på följande sätt:

  ./TestExecutable.exe @"arguments.rsp"
  

  --filter "A very long filter" --timeout 10s
  

  Anmärkning

  När du använder dotnet testanvänder SDK-kommandoradsparsern en token-per-line-metod där varje rad i svarsfilen behandlas som en enda token. I så fall måste varje argument finnas på en separat rad:

  --filter
  A very long filter
  --timeout
  10s
  

• --config-file

  Anger en testconfig.json-fil.

• --debug

  Pausar testkörningen vid start så att du kan koppla ett felsökningsprogram till testprocessen. Motsvarar inställningen av TESTINGPLATFORM_WAIT_ATTACH_DEBUGGERmiljövariabeln till 1. Stöds inte på webbläsarplattformar.

  Anmärkning

  Det här alternativet är tillgängligt i MTP från och med version 1.9.0. Det ersätter det tidigare --debug-wait-attach alternativet (introducerades i MTP 1.6.0); det gamla namnet togs bort och får inte längre användas.

• --diagnostic

  Aktiverar diagnostikloggning. Standardloggnivån är Trace. Filen skrivs i utdatakatalogen med följande namnformat, log_[MMddHHssfff].diag.

• --diagnostic-synchronous-write

  Tvingar den inbyggda filloggaren att synkront skriva loggar. Användbart för scenarier där du inte vill förlora några loggposter (om processen kraschar). Detta gör testkörningen långsammare.

• --diagnostic-output-directory

  Utdatakatalogen för diagnostikloggningen, om den inte anges, genereras filen i standardkatalogen TestResults.

• --diagnostic-file-prefix

  Prefixet för loggfilens namn. Standardinställningen är "log".

• --diagnostic-verbosity

  Definierar verbositetsnivån när växeln --diagnostic används. De tillgängliga värdena är Trace, Debug, Information, Warning, Erroreller Critical.

• --exit-on-process-exit

  Avsluta testprocessen om den beroende processen går ut. PID måste anges.

• --filter-uid

  Filtrerar vilka tester som ska köras utifrån deras testnods-UID:er. Accepterar en eller flera UID:er.

  Anmärkning

  Det här alternativet är tillgängligt i MTP från och med version 1.8.0.

• --help

  Skriver ut en beskrivning av hur du använder kommandot.

• --ignore-exit-code

  Tillåter att vissa avslutskoder som inte är noll ignoreras och i stället returneras som 0. Mer information finns i Ignorera specifika slutkoder.

• --info

  Visar avancerad information om .NET testprogrammet, till exempel:

  • Plattformen.
  • Miljön.
  • Varje registrerad kommandoradsleverantör, till exempel dess name, version, descriptionoch options.
  • Varje registrerat verktyg, till exempel dess command, name, version, descriptionoch alla kommandoradsleverantörer.

  Den här funktionen används för att förstå tillägg som skulle registrera samma kommandoradsalternativ eller ändringar i tillgängliga alternativ mellan flera versioner av ett tillägg (eller plattformen).

• --list-tests

  Visar en lista över tillgängliga tester utan att köra dem. Du kan också ta ett argument som styr utdataformatet: text (standard, läsbart för människor) eller json.

  Anmärkning

  Utdataformatet json är tillgängligt i MTP från och med version 2.3.0.

• --maximum-failed-tests

  Anger det maximala antalet testfel som, när den nås, stoppar testkörningen. Stöd för den här växeln kräver att ramverksförfattare implementerar funktionen IGracefulStopTestExecutionCapability. Slutkoden när du når den mängden testfel är 13. Mer information finns i MTP-slutkoder.

  Anmärkning

  Den här funktionen är tillgänglig i MTP från och med version 1.5.

• --minimum-expected-tests

  Anger det minsta antalet tester som förväntas köras. Som standard förväntas minst ett test köras.

• --no-banner

  Inaktiverar startbanderollen, copyrightmeddelandet och telemetribanderollen. Samma effekt kan uppnås genom TESTINGPLATFORM_NOBANNERDOTNET_NOLOGO eller .

• --results-directory

  Katalogen där testresultaten ska placeras. Om den angivna katalogen inte finns skapas den. Standardvärdet är TestResults i katalogen som innehåller testprogrammet.

• --timeout

  En tidsgräns för global testexekvering. Tar ett argument som sträng i formatet <value>[h|m|s] där <value> är flyttal.

• --treenode-filter

  Filtrerar testerna som ska köras med ett trädfilteruttryck. Trädfilter erbjuder bättre matchning än --filter för avancerade scenarier.

Tilläggsalternativ efter scenario

Använd följande tabell för att snabbt hitta tilläggsalternativ.

Identifiera alternativ i testappen

Kör ditt körbara testprogram med --help för att lista alternativen som är tillgängliga för din aktuella tilläggsuppsättning.

För avancerad diagnostik av registrerade leverantörer och alternativ kör du med --info.

Se även

• MTP-översikt
• MTP-funktioner
• Testa med dotnet test