Microsoft. Testing.Platform (MTP)-CLI-Optionsreferenz

Dieser Artikel enthält einen zentralen Einstiegspunkt für MTP-Befehlszeilenoptionen.

Plattformoptionen

• @

  Gibt den Namen der Antwortdatei an. Der Name der Antwortdatei muss dem `@`-Zeichen, ohne Leerzeichen zwischen dem `@`-Zeichen und dem Namen der Antwortdatei, direkt folgen.

  Optionen in einer Antwortdatei werden so interpretiert, als ob sie an dieser Stelle in der Befehlszeile vorhanden wären. Sie können das umgekehrte Schrägstrichzeichen \ nicht verwenden, um Linien zu verketten. Die Verwendung einer Antwortdatei ist bei sehr langen Befehlen hilfreich, die die Terminalgrenzen überschreiten können. Sie können eine Antwortdatei mit Inline-Befehlszeilenargumenten kombinieren. Beispiel:

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

  wobei filter.rsp den folgenden Inhalt haben kann:

  --filter "A very long filter"
  

  Alternativ können Sie mit einer einzelnen RSP-Datei wie folgt sowohl Timeout als auch Filter angeben:

  ./TestExecutable.exe @"arguments.rsp"
  

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

  Hinweis

  Bei Verwendung dotnet testdes SDK-Befehlszeilenparsers wird ein Token-pro-Line-Ansatz verwendet, bei dem jede Zeile in der Antwortdatei als einzelnes Token behandelt wird. In diesem Fall muss jedes Argument in einer separaten Zeile stehen:

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

• --config-file

  Gibt eine testconfig.json-Datei an.

• --debug

  Hält die Testausführung beim Start an, damit Sie einen Debugger an den Testprozess anfügen können. Entspricht dem Festlegen der TESTINGPLATFORM_WAIT_ATTACH_DEBUGGERUmgebungsvariablen auf 1. Wird auf Browserplattformen nicht unterstützt.

  Hinweis

  Diese Option ist ab Version 1.9.0 in MTP verfügbar. Sie ersetzt die vorherige --debug-wait-attach Option (eingeführt in MTP 1.6.0); der alte Name wurde entfernt und darf nicht mehr verwendet werden.

• --diagnostic

  Aktiviert die Diagnoseprotokollierung. Die Standardprotokollebene ist Trace. Die Datei wird im Ausgabeverzeichnis mit dem folgenden Namensformat geschrieben: log_[MMddHHssfff].diag.

• --diagnostic-synchronous-write

  Zwingt den integrierten Dateilogger, Protokolle synchron zu schreiben. Nützlich für Szenarien, in denen keine Protokolleinträge verloren gehen sollen (bei Prozessabsturz). Dadurch wird die Testausführung verlangsamt.

• --diagnostic-output-directory

  Das Ausgabeverzeichnis der Diagnoseprotokollierung. Wird es nicht angegeben, wird die Datei im Standardverzeichnis TestResults generiert.

• --diagnostic-file-prefix

  Das Präfix für den Namen der Protokolldatei. Wird standardmäßig auf "log" festgelegt.

• --diagnostic-verbosity

  Definiert den Ausführlichkeitsgrad, wenn die Option --diagnostic verwendet wird. Verfügbare Werte sind Trace, Debug, Information, Warning, Error oder Critical.

• --exit-on-process-exit

  Beenden Sie den Testprozess, wenn ein abhängiger Prozess beendet wird. Die PID muss angegeben werden.

• --filter-uid

  Filtert die auszuführenden Tests anhand ihrer Testknoten-UIDs. Akzeptiert eine oder mehrere UIDs.

  Hinweis

  Diese Option ist ab Version 1.8.0 in MTP verfügbar.

• --help

  Gibt eine Beschreibung zur Verwendung des Befehls aus.

• --ignore-exit-code

  Erlaubt, dass einige Nicht-Null-Exitcodes ignoriert werden und stattdessen als 0 zurückgegeben werden. Weitere Informationen finden Sie im Abschnitt Ignorieren spezifischer Exitcodes.

• --info

  Zeigt erweiterte Informationen zur .NET Testanwendung an, z. B.:

  • Die Plattform.
  • Zur Umgebung.
  • Jeder registrierte Kommandozeilenanbieter, wie z. B. name, version, description und options.
  • Jedes registrierte Tool, wie z. B. seine command, name, version, description und alle Kommandozeilen-Anbieter.

  Dieses Feature wird verwendet, um Erweiterungen zu verstehen, die dieselbe Befehlszeilenoption registrieren, oder um die Änderungen bei den verfügbaren Optionen zwischen mehreren Versionen einer Erweiterung (oder der Plattform) zu ermitteln.

• --list-tests

  Listet die verfügbaren Tests auf, ohne sie auszuführen. Verwendet optional ein Argument, das das Ausgabeformat steuert: text (Standard, lesbar) oder json.

  Hinweis

  Das json Ausgabeformat ist ab Version 2.3.0 in MTP verfügbar.

• --maximum-failed-tests

  Gibt die maximale Anzahl von Testfehlern an, bei deren Erreichen der Testlauf abgebrochen wird. Zur Unterstützung dieses Schalters müssen die Autoren des Frameworks die Funktionalität IGracefulStopTestExecutionCapability implementieren. Der Exit-Code bei Erreichen dieser Anzahl von Testfehlern ist 13. Weitere Informationen finden Sie unter MTP-Exitcodes.

  Hinweis

  Dieses Feature ist ab Version 1.5 in MTP verfügbar.

• --minimum-expected-tests

  Gibt die Mindestanzahl der auszuführenden Tests an. Standardmäßig wird davon ausgegangen, dass mindestens ein Test ausgeführt wird.

• --no-banner

  Deaktiviert das Startbanner, die Copyrightnachricht und das Telemetriebanner. Derselbe Effekt kann durch die TESTINGPLATFORM_NOBANNER Variablen oder DOTNET_NOLOGOumgebungsvariablen erreicht werden.

• --results-directory

  Das Verzeichnis, in dem die Testergebnisse gespeichert werden. Wenn das angegebene Verzeichnis noch nicht existiert, wird es erstellt. Der Standardwert ist TestResults im Verzeichnis, das die Testanwendung enthält.

• --timeout

  Eine globale Zeitüberschreitung für die Testausführung. Nimmt ein Argument als Zeichenfolge im Format <value>[h|m|s] an, wobei <value> ein Float ist.

• --treenode-filter

  Filtert die auszuführenden Tests mithilfe eines Baumfilterausdrucks. Baumfilter bieten für anspruchsvolle Szenarien flexiblere Abgleichmöglichkeiten als --filter.

Erweiterungsoptionen nach Szenario

Verwenden Sie die folgende Tabelle, um Erweiterungsoptionen schnell zu finden.

Entdecken von Optionen in Ihrer Test-App

Führen Sie Ihr ausführbares Testprogramm mit --help aus, um die verfügbaren Optionen für Ihr aktuelles Erweiterungsset aufzulisten.

Für eine erweiterte Diagnose von registrierten Anbietern und Optionen führen Sie --info aus.

Siehe auch

• MTP-Übersicht
• MTP-Features
• Testen mit dotnet test