Opdrachtopties voor Te.exe

Usage

<te.exe> test_binaries [/appendWttLogging] [/breakOnCreate] [/breakOnError] [/breakOnInvoke] [/coloredConsoleOutput] [ /console:flushWrites] [/console:position=[x,y | current] [/console:size=<x,y>] [ /console:topmost ][/defaultAppDomain] [/disableConsoleLogging] [/disableTimeouts] [/dpiaware ] [/enableWttLogging] [/inproc] [/isolationLevel] [/labMode] [/list] [/listProperties] [/logFile:<name>] [/logOutput:<mode>] [/miniDumpOnCrash] [/miniDumpOnError] [/name:<testname>] [/outputFolder:<folderName>] [/p:<ParamName>=<ParamValue>] [/parallel] [/persistentPictResults] [/pict:<OptionName>=<OptionValue>] [/rebootStateFile] [/reportLoadingIssue] [/runas:<RunAsType>] [/ runIgnoredTests] [/runon:<MachineName>] [/screenCaptureOnError] [/select:<query>] [/sessionTimeout:<value>] [/stackFrameCount:<value>] [/stackTraceOnError] [/terminateOnFirstFailure] [/testDependencies:<files>] [/testmode:Loop] [/testmode:Stress] [/testTimeout:<value>] [ /unicodeOutput:<true/false>] [/version] [/wttDeviceString:<value>] [/wttDeviceStringSuffix:<value>]

Selectie-/uitvoeringsopdrachten

test_binaries

Geef een of meer testbestanden op die moeten worden uitgevoerd (gescheiden door spaties). Jokertekens worden ondersteund.

te.exe test1.dll

Interpretatie: Voer alle tests uit in test1.dll.

te.exe test1.dll test2.dll test3.dll

Interpretatie: Voer alle tests uit in test1.dll, test2.dll en test3.dll.

te.exe *.dll

Interpretatie: Voer alle tests uit in alle dll's in de huidige map.

/coloredConsoleOutput:<true/false>

Hiermee geeft u op of TAEF gekleurde consoletekst moet uitvoeren. De standaardwaarde is waar. Als deze optie is ingesteld op false, voert TAEF alle tekst uit met de standaardconsolekleur.

te.exe test1.dll /coloredConsoleOutput:false

/console:<optionName>=<value>

Biedt opties voor het configureren van TE's gebruik van de console. De volgende opties zijn beschikbaar:

/console:flushWrites

Zorgt ervoor dat console-uitvoer wordt leeggemaakt nadat elke regel is geschreven. Dit is handig wanneer TE.exeuitvoer is omgeleid.

/console:position=[x,y | current ]

Hiermee stelt u de positie (in pixels) van het consolevenster in ten opzichte van de hoek van de primaire monitor. Gebruik een waarde van de huidige versie om op te geven dat de huidige consolepositie moet worden opgeslagen en gebruikt bij het hervatten van opnieuw opstarten.

/console:size=[ <x,y> | current ]

Hiermee stelt u de grootte van het consolevenster in (in tekendimensies). De grootte van de schermbuffer wordt zo nodig verhoogd zodat deze overeenkomt met de grootte van het venster. Gebruik een huidige waarde om op te geven dat de huidige consolegrootte moet worden opgeslagen en gebruikt bij het hervatten van opnieuw opstarten.

/console:topmost

Houdt de console actief te.exe 'topmost' in de desktop z-volgorde voor de duur van de uitvoering.

/dpiaware

Hiermee worden tests uitgevoerd in een proces dat is gemarkeerd als DPI-bewust, zie Hoge DPI. Dit kan ook worden ingesteld via metagegevens (DpiAware).

/inproc

Voer alle tests uit binnen het TE.exe proces zelf in plaats van binnen TE.ProcessHost.exe.

te.exe test1.dll /inproc

/isolationLevel:<Level>

Hiermee geeft u het minimale isolatieniveau op dat moet worden gebruikt bij het uitvoeren van TAEF-tests. Als deze waarde conflicteert met het Isolatieniveau dat is opgegeven als metagegevens, wordt de waarde het isolatieniveau met het kleinste bereik. Zie Testisolatie voor meer informatie.

te.exe test1.dll /isolationLevel:Class

/labMode

Hiermee worden tests uitgevoerd en mogelijke blokkerende gebruikersinterface verwijderd (bijvoorbeeld dialoogvensters voor Windows Foutrapportage bij crashtests).

/list

Hier worden de namen van alle test_binaries en de klassen en methoden hierin weergegeven. Als selectiecriteria zijn opgegeven, worden alleen de namen weergegeven die voldoen aan de criteria.

 te.exe test1.dll test2.dll /list

 WEX::UnitTests::Test1
  WEX::UnitTests::Test1::Example1
  WEX::UnitTests::Test1::Example2
  WEX::UnitTests::Test1::Example3

 WEX::UnitTests::Test2
  WEX::UnitTests::Test2::Example1
  WEX::UnitTests::Test2::Example2
  WEX::UnitTests::Test2::Example3

 te.exe test1.dll test2.dll /select:@name='*Example2*' /list

 WEX::UnitTests::Test1
  WEX::UnitTests::Test1::Example2

 WEX: :UnitTests::Test2
  WEX::UnitTests::Test2::Example2

/listProperties

Hier worden de namen en eigenschappen van alle test_binaries en de klassen en methoden hierin weergegeven, samen met de namen van de functies Setup en Teardown, indien beschikbaar. Als selectiecriteria zijn opgegeven, worden alleen de namen weergegeven die voldoen aan de criteria.

 te.exe test1.dll test2.dll /listProperties

 WEX::UnitTests::Test1
  WEX::UnitTests::Test1::Example1
   Setup: Test1Setup
   Teardown: Test1Teardown
   Property[ThreadingModel] = MTA
  WEX::UnitTests::Test1::Example2
   Setup: Test1Setup
   Teardown: Test1Teardown
   Property[ThreadingModel] = STA
  WEX::UnitTests::Test1::Example3
   Setup: Test1Setup
   Teardown: Test1Teardown
   Property[ThreadingModel] = STA

 WEX::UnitTests::Test2
  WEX::UnitTests::Test2::Example1
   Property[ThreadingModel] = MTA
  WEX::UnitTests::Test2::Example2
   Property[ThreadingModel] = STA
  WEX::UnitTests::Test2::Example3
   Property[ThreadingModel] = MTA

 te.exe test1.dll test2.dll /select:@name='*Example2*' /listProperties

 WEX::UnitTests::Test1
  WEX::UnitTests::Test1::Example2
   Setup: Test1Setup
   Teardown: Test1Teardown
   Property[ThreadingModel] = STA

 WEX::UnitTests::Test2
  WEX::UnitTests::Test2::Example2
   Property[ThreadingModel] = STA

/name:<testname>

Selectie op basis van testnamen is een eenvoudig alternatief voor '/select:@Name='<testname>'. De <testnaam> mag nog steeds jokertekens ('*' en '?') bevatten, maar mag niet tussen enkele aanhalingstekens staan. Als /select en /name beide zijn opgegeven bij de opdrachtprompt, heeft /select query voorrang en /name wordt genegeerd.

te.exe test1.dll /name:*TestToLower

Interpretatie: Voer alle tests uit in test1.dll waar methodenamen eindigen op 'TestToLower'. Hetzelfde kan worden weergegeven met behulp van selectiecriteria als /select:@Name='*TestToLower'.

te.exe test1.dll /name:*StringTest*

Interpretatie: Voer alle tests uit in test1.dll die de woordgroep StringTest bevatten in hun naamruimte, klasse of methodenaam.

/outputFolder:<folderName>

Hiermee geeft u een map op om alle gegenereerde bestanden te plaatsen. De standaardwaarde is de huidige map. U kunt omgevingsvariabelen gebruiken, bijvoorbeeld:

te.exe test1.dll /outputFolder:%TEMP%\\MyOutput

/p:<ParamName>=<ParamValue>

Definieert een runtimeparameter met parameternaam=ParamName en parameterwaarde=ParamValue. Deze parameters zijn toegankelijk via een testmethode of methoden voor instellen/opschonen.

te.exe test1.dll /p:x=5 /p:myParm=cool

U kunt x ophalen als een van de verschillende ondersteunde typen in uw testcode. Hier ziet u bijvoorbeeld dat we deze ophalen als zowel een int als een WEX::Common::String:

                int x = 0;
                String xString;
                RuntimeParameters::TryGetValue(L"x", x);
                RuntimeParameters::TryGetValue(L"x", xString);

Ga voor meer informatie naar de TAEF. Helppagina voor runtimeparameters .

/parallel

Hiermee worden tests parallel uitgevoerd voor meerdere processors. Tests moeten zich aanmelden voor parallelle uitvoering door te worden gemarkeerd met de metagegevens Parallel.

te.exe test1.dll /parallel

Ga naar de Help-pagina Parallel voor meer informatie.

/persistPictResults

Slaat resultaten op die door PICT.exe worden gegenereerd voor tests met PICT DataSource in de huidige uitvoering. De volgende testuitvoering probeert de resultaten in de cache te gebruiken, net als bij het uitvoeren van PICT.exe op hetzelfde model en seed-bestanden.

/pict:<OptionName>=<OptionValue>

Biedt opties voor het beheren van PICT.exe wanneer deze wordt aangeroepen voor tests met behulp van een PICT-gegevensbron. Als u een van deze opties instelt, worden momenteel alle gekoppelde metagegevens in de code overschreven. De volgende opties zijn beschikbaar:

/Pict:Order=3
Hiermee stelt u de volgorde van combinaties in door de waarde door te geven via de opdrachtoptie /o voor PICT.exe.

/Pict:ValueSeparator=;
Hiermee stelt u het waardescheidingsteken in door de waarde door te geven via de opdrachtoptie /d voor PICT.exe.

/Pict:AliasSeparator=+
Hiermee stelt u het aliasscheidingsteken in door de waarde door te geven via de opdrachtoptie /a voor PICT.exe.

Pict:NegativeValuePrefix=!
Hiermee stelt u het voorvoegsel van de negatieve waarde in door de waarde door te geven via de opdrachtoptie /n voor PICT.exe.

/Pict:SeedingFile=test.seed
Hiermee stelt u het pad naar het seeding-bestand in door de waarde door te geven via de opdrachtoptie /e voor PICT.exe.

/Pict:Random=true
Hiermee schakelt u willekeurigheid in de PICT-resultaten in of uit en wordt de PICT-gegevensbron de willekeurige seed vastgelegd die is gebruikt.

/Pict:RandomSeed=33
Hiermee stelt u de willekeurige seed in door de waarde door te geven via de opdrachtoptie /r voor PICT.exe. Als u dit instelt, wordt Pict:Random ingeschakeld, tenzij Pict:Random expliciet is ingesteld op false.

/Pict:CaseSensitive=true
Als deze optie is ingesteld op waar, schakelt u hoofdlettergevoeligheid in door de opdrachtoptie /c door te geven aan PICT.exe.

/Pict:Timeout=00:01:30
Hiermee stelt u de tijd in waarop moet worden gewacht tot PICT.exe klaar is voordat het proces wordt beëindigd. De waarde heeft de notatie [Dag.]Hour[:Minute[:Second[. FractionalSeconds]]].

/runas:<RunAsType>

Hiermee worden tests uitgevoerd in de opgegeven omgeving. Raadpleeg de RunAs-documentatie voor gedetailleerde gebruiksgegevens.

te.exe *.dll /runas:System

Interpretatie: Voer alle tests uit als System.

te.exe *.dll /runas:Elevated

Interpretatie: Voer alle tests uit als een gebruiker met verhoogde bevoegdheid.

te.exe *.dll /runas:Restricted

Interpretatie: Voer alle tests uit als gebruiker zonder verhoogde bevoegdheid.

te.exe *.dll /runas:LowIL

Interpretatie: Voer alle tests uit in een proces met lage integriteit.

/runIgnoredTests

Voert of lijsten (indien in combinatie met /list of /listProperties) alle tests uit, inclusief testklassen en testmethoden met 'Negeren' metagegevens ingesteld op 'true'. Standaard worden testklassen en testmethoden met 'Negeren' metagegevens die zijn ingesteld op 'true' overgeslagen tijdens de uitvoering en tijdens de vermelding.

/runon:<MachineName>

Hiermee worden tests op afstand uitgevoerd op de opgegeven computer. TAEF verifieert, autoriseert en implementeert de benodigde binaire bestanden om de tests uit te voeren en registreert alle informatie terug naar de oorspronkelijke console. Raadpleeg de documentatie over de uitvoering van cross-machinetests voor gedetailleerde gebruiksgegevens.

te.exe *.dll /runon:TestMachine1

Interpretatie: Voer alle tests op afstand uit op TestMachine1.

/select:<query>

De selectiecriteria die moeten worden gebruikt bij het selecteren van tests uit elk binair testbestand. Selectiecriteria bestaan uit een of meer van de volgende:

@[eigenschapsnaam] = [waarde als tekenreeks]

@[eigenschapsnaam] >= [waarde als float of geheel getal]

@[eigenschapsnaam] > [waarde als float of geheel getal]

@[eigenschapsnaam] <= [waarde als float of geheel getal]

@[eigenschapsnaam] < [waarde als float of geheel getal]

• Eigenschapswaarden als tekenreeksen moeten tussen enkele aanhalingstekens staan.
• U kunt een samengestelde selectiecriteria opgeven met behulp van 'and', 'or' en 'not' (hoofdlettergevoelig).
• Eigenschapstekenreekswaarden ondersteunen jokertekens via '*' en '?'-tekens.
• Voor float- en gehele getallen kan het teken *ook worden gebruikt als 'bestaat', maar kan het niet worden gebruikt voor gedeeltelijke overeenkomst. Bijvoorbeeld: /select:"@Priority=*" is geldig, maar /select:"@Priority=4*" is niet.

te.exe test1.dll /select:"(@Name='*TestToLower' of 'C2') en @Owner=niet(@Priority < 3)"

Interpretatie: Voer alle tests uit in test1.dll waar methodenamen eindigen op 'TestToLower' of waar de eigenaar C2 is; en waarbij prioriteit niet kleiner is dan 3.

te.exe test1.dll test2.dll /select:@Priority=\*

Interpretatie: Voer alle tests uit in test1.dll en test2.dll waar de prioriteit is opgegeven in de testmetagegevens.

te.exe test1.dll /select:@Name='*StringTest*'

Interpretatie: Voer alle tests uit in test1.dll die de woordgroep StringTest bevatten in hun naamruimte, klasse of methodenaam.

/sessionTimeout:<value>

Hiermee stelt u een sessietime-out in voor de volledige uitvoering van Te.exe. Als de time-out verloopt, wordt de testsessie correct afgebroken en wordt de afsluitcode van het proces aangegeven dat er een time-out is opgetreden.

[Day.]Hour[:Minute[:Second[.FractionalSeconds]]]

te.exe test1.dll /sessionTimeout:0:0:0.5

De volledige testsessie treedt na 5 seconden een time-out op.

te.exe test1.dll /sessionTimeout:0:0:45

De volledige testsessie treedt na 45 seconden een time-out op.

te.exe test1.dll /sessionTimeout:0:20

De volledige testsessie treedt na 20 minuten een time-out op.

te.exe test1.dll /sessionTimeout:5

Er treedt een time-out op voor de hele testsessie na 5 uur.

te.exe test1.dll /sessionTimeout:1.2

Er treedt een time-out op voor de hele testsessie na 1 dag en 2 uur.

/terminateOnFirstFailure

Hiermee wordt de testuitvoering beëindigd wanneer er voor het eerst een testfout optreedt. Alle teardownbewerkingen voor die test worden aangeroepen, maar alle volgende tests worden gemarkeerd als genegeerd. Vanwege een bekend probleem kunnen tests blijven uitvoeren wanneer u een testmodus gebruikt.

te.exe test1.dll /terminateOnFirstFailure

/testDependencies:<files>

Hiermee geeft u aanvullende testafhankelijkheden op die moeten worden geïmplementeerd bij het uitvoeren van tests op meerdere machines. Tenzij er een volledig pad is opgegeven, zoekt TAEF ten opzichte van de huidige map, niet naar de testmap.

te.exe *.dll /runon:TestMachine1 /TestDependencies:test*.jpg; file1.doc

Interpretatie: Voer alle tests op afstand uit op TestMachine1 en kopieer 'test*.jpg' en 'file1.doc' naar de externe computer voordat u tests uitvoert. Elke bestandsspecificatie kan jokertekens (test.txt; test*.dll; enzovoort) bevatten om een of meer bestanden te vinden.

/testTimeout:<value>

Hiermee stelt u een globale testtime-out in voor de volledige uitvoering van Te.exe. Deze waarde overschrijft alle time-outmetagegevens voor tests die mogelijk zijn ingesteld voor een bepaalde test die wordt uitgevoerd.

[Day.]Hour[:Minute[:Second[.FractionalSeconds]]]

te.exe test1.dll /testTimeout:0:0:0.5

Elke test- en installatie-/opschoonmethode treedt na 5 seconden een time-out op.

te.exe test1.dll /testTimeout:0:0:45

Elke test- en installatie-/opschoonmethode treedt na 45 seconden een time-out op.

te.exe test1.dll /testTimeout:0:20

Elke test- en installatie-/opschoonmethode treedt na 20 minuten een time-out op.

te.exe test1.dll /testTimeout:5

Elke test- en installatie-/opschoonmethode treedt na 5 uur een time-out op.

te.exe test1.dll /testTimeout:1.2

Elke test- en installatie-/opschoonmethode treedt na 1 dag en 2 uur op.

/unicodeOutput:<true/false>

Wanneer TE wordt doorgesluisd naar een tekstbestand, wordt unicode standaard uitgevoerd. De enige uitzondering hierop is als u hebt gevraagd om toe te voegen aan een bestaand ANSII-bestand (via '>>').

Als u dit gedrag wilt overschrijven, kunt u /unicodeOutput:false opgeven. Hierdoor wordt afgedwongen dat TE altijd ANSII naar het bestand uitvoert.

te.exe test1.dll /unicodeOutput:false > output.txt

Loggerinstellingen

/appendWttLogging

Wanneer WTT-logboekregistratie is ingeschakeld, voegt u dit toe aan het logboekbestand in plaats van het te overschrijven. Moet worden gebruikt in combinatie met /enableWttLogging.

te.exe test1.dll /enableWttLogging /appendWttLogging

Er wordt een logboekbestand met de naam TE.wtl gemaakt of toegevoegd wanneer de uitvoering van de test is voltooid.

/enableWttLogging

Schakelt WTT-logboekregistratie in; Wttlog.dll moet beschikbaar zijn in uw pad.

te.exe test1.dll /enableWttLogging

Hiermee wordt een logboekbestand met de naam TE.wtl geproduceerd wanneer de testuitvoering is voltooid.

/defaultAppDomain

Voert beheerde tests uit in het standaardtoepassingsdomein.

te.exe managed.test1.dll /defaultAppDomain

/disableConsoleLogging

Schakelt uitvoer van consolelogboeken uit; moet worden gebruikt in combinatie met /enableWttLogging.

te.exe test1.dll /disableConsoleLogging /enableWttLogging

/logFile:<name>

Geef een naam op die moet worden gebruikt als het wtt-logboekbestand; moet worden gebruikt in combinatie met /enableWttLogging.

te.exe test1.dll /logFile:myCustomLogFile.xml /enableWttLogging

Produceert een logboekbestand met de naammyCustomeLogFile.xml na voltooiing van de testuitvoering.

/logOutput:<mode>

Hiermee stelt u het uitvoerniveau van de logger in. Geldige waarden zijn:

• Hoog: hiermee kunt u extra console-uitvoer inschakelen, zoals het afdrukken van een tijdstempel naast elke trace.
• Laag: verzendt alleen kernevenementen (begin, eindgroep, enzovoort) en fouten. Het logboekbestand bevat details met een lagere prioriteit die eventuele fouten voorkomen om context voor fouten te bieden.
• LowWithConsoleBuffering: Hetzelfde als Laag, maar bevat de context van fouten in zowel het logboekbestand als de console-uitvoer.
• Laagste: Hetzelfde als Laag, maar console-uitvoer bevat alleen fouten, testfouten en het overzicht van de uitvoering.

/version

Voert gedetailleerde versie-informatie uit.

/wttDeviceString:<value>

Hiermee wordt de WttDeviceString die door WexLogger wordt gebruikt, volledig overschreven wanneer WttLogger wordt geïnitialiseerd.

te.exe test1.dll /wttDeviceString:$Console

/wttDeviceStringSuffix:<value>

Voegt de opgegeven waarde toe aan de standaard WttDeviceString die door WexLogger wordt gebruikt wanneer WttLogger wordt geïnitialiseerd. Genegeerd als wttDeviceString ook is opgegeven.

te.exe test1.dll /wttDeviceStringSuffix:$Console

Instellingen voor foutopsporing

/breakOnCreate

Breekt in het foutopsporingsprogramma in voordat u elke testklasse instantieert.

te.exe test1.dll /breakOnCreate

/breakOnError

Breekt in het foutopsporingsprogramma in als er een fout of testfout wordt geregistreerd.

te.exe test1.dll /breakOnError

/breakOnInvoke

Breekt in het foutopsporingsprogramma in voordat u elke testmethode aanroept.

te.exe test1.dll /breakOnInvoke

/disableTimeouts

Schakelt alle time-outs tijdens de uitvoering uit. Dit kan handig zijn bij foutopsporing om een time-out te voorkomen wanneer TAEF wacht op het onderdeel van het programma dat wordt opgespoord.

te.exe test1.dll /disableTimeouts

/miniDumpOnError

Neemt en registreert een minidump als er een testfout of fout optreedt.

te.exe test1.dll /miniDumpOnError

/miniDumpOnCrash

Neemt en registreert een minidump als er een testcrash optreedt.

te.exe test1.dll /miniDumpOnCrash

/rebootStateFile

Hiermee schakelt u expliciet de uitvoering van herstarttests in.

te.exe test1.dll /rebootStateFile:myFile.xml

/reportLoadingIssue

Geeft een foutbeschrijvingsdialoogvenster weer wanneer TAEF een test-DLL niet kan laden. Mag alleen worden gebruikt voor onderzoek naar problemen met het laden van systeemeigen test-DLL's.

te.exe test1.dll /reportLoadingIssue

/screenCaptureOnError

Neemt en registreert een schermopname als er een testfout of fout optreedt.

te.exe test1.dll /screenCaptureOnError

/stackFrameCount:<value>

Hiermee geeft u het aantal stackframes weer te geven bij het ophalen van aanroepstacks. De standaardwaarde is 50.

te.exe test1.dll /stackFrameCount:100

/stackTraceOnError

Neemt en registreert een stack-trace als er een testfout of fout optreedt.

te.exe test1.dll /stackTraceOnError

Testmodi

/testmode:Loop

Hiermee kunt u de uitvoering beheren met behulp van twee variabelen Loop en LoopTest.

• Lus: Bepaalt hoe vaak de hele uitvoering wordt uitgevoerd. Standaard 1.
• LoopTest: bepaalt hoe vaak een afzonderlijke test wordt uitgevoerd. Standaard 10.

te.exe test1.dll /testmode:Lus

Interpretatie: Voer elke test in test1.dll 10 keer uit (standaardwaarde voor LoopTest). De hele uitvoering wordt eenmaal uitgevoerd (standaardwaarde voor Lus).

te.exe test1.dll test2.dll /testmode:Loop /Loop:3 /LoopTest:1

Interpretatie: Voer elke test uit in test1.dll en test2.dll eenmaal (bepaald door LoopTest). De volledige uitvoering (alle gecombineerde tests in test1.dll en test2.dll) wordt drie keer uitgevoerd, zoals wordt bepaald door Lus.

/testmode:Stress

In de 'stress'-testmodus voert TAEF voor onbepaalde tijd tests uit, totdat Ctrl+C is ingevoerd of totdat een WM_CLOSE bericht wordt verzonden naar het verborgen venster van TAEF. /testmode:stress moet worden uitgevoerd in combinatie met /inproc.

te.exe test1.dll /testmode:Stress /inproc

Zie Testmodi voor gedetailleerde informatie en andere parameters die in deze modus worden ondersteund.