Microsoft. Informazioni di riferimento sulle opzioni dell'interfaccia della riga di comando di Testing.Platform (MTP)

Questo articolo fornisce un punto di ingresso centrale per le opzioni della riga di comando MTP.

Opzioni della piattaforma

• @

  Specifica il nome del file di risposta. Il nome del file di risposta deve seguire immediatamente il @ carattere senza spazi vuoti tra il @ carattere e il nome del file di risposta.

  Le opzioni in un file di risposta vengono interpretate come se fossero presenti in tale posizione nella riga di comando. Non è possibile usare il carattere barra rovesciata \ per concatenare le righe. L'uso di un file di risposta consente di eseguire comandi molto lunghi che potrebbero superare i limiti del terminale. È possibile combinare un file di risposta con argomenti della riga di comando inline. Per esempio:

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

  dove filter.rsp può avere il contenuto seguente:

  --filter "A very long filter"
  

  In alternativa, è possibile usare un singolo file rsp per specificare sia il timeout che il filtro come indicato di seguito:

  ./TestExecutable.exe @"arguments.rsp"
  

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

  Annotazioni

  Quando si usa dotnet test, il parser della riga di comando dell'SDK usa un approccio token per riga in cui ogni riga nel file di risposta viene considerata come un singolo token. In tal caso, ogni argomento deve trovarsi in una riga separata:

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

• --config-file

  Specifica un file testconfig.json.

• --debug

  Sospende l'esecuzione del test all'avvio in modo da poter collegare un debugger al processo di test. Equivale a impostare la TESTINGPLATFORM_WAIT_ATTACH_DEBUGGERvariabile di ambiente su 1. Non supportato nelle piattaforme browser.

  Annotazioni

  Questa opzione è disponibile in MTP a partire dalla versione 1.9.0. Sostituisce l'opzione precedente --debug-wait-attach (introdotta in MTP 1.6.0), il nome precedente è stato rimosso e non deve più essere usato.

• --diagnostic

  Abilita la registrazione diagnostica. Il livello di log predefinito è Trace. Il file viene scritto nella directory di output con il formato del nome seguente, log_[MMddHHssfff].diag.

• --diagnostic-synchronous-write

  Forza il logger di file predefinito a scrivere i log in modo sincrono. Utile per le situazioni in cui non si vogliono perdere registrazioni di log (se il processo si arresta in modo anomalo). Ciò rallenta l'esecuzione del test.

• --diagnostic-output-directory

  La directory di output per la registrazione diagnostica, se non specificata, è generata nella directory predefinita TestResults.

• --diagnostic-file-prefix

  Prefisso per il nome del file di log. Il valore predefinito è "log".

• --diagnostic-verbosity

  Definisce il livello di verbosità quando viene utilizzato l'interruttore --diagnostic. I valori disponibili sono Trace, Debug, Information, Warning, Erroro Critical.

• --exit-on-process-exit

  Uscire dal processo di test se il processo dipendente esce. È necessario specificare il PID.

• --filter-uid

  Filtra i test da eseguire in base agli UID dei nodi di test. Accetta uno o più UID.

  Annotazioni

  Questa opzione è disponibile in MTP a partire dalla versione 1.8.0.

• --help

  Stampa una descrizione di come usare il comando .

• --ignore-exit-code

  Consente di ignorare alcuni codici di uscita diversi da zero e restituiti come 0. Per altre informazioni, vedere Ignorare i codici di uscita specifici.

• --info

  Visualizza informazioni avanzate sull'applicazione di test .NET, ad esempio:

  • La piattaforma.
  • Ambiente.
  • Ogni provider registrato della riga di comando, come name, version, descriptione options.
  • Ogni strumento registrato, come il relativo command, name, version, descriptione tutti i provider della riga di comando.

  Questa funzionalità viene usata per comprendere le estensioni che registrano la stessa opzione della riga di comando o le modifiche nelle opzioni disponibili tra più versioni di un'estensione (o la piattaforma).

• --list-tests

  Elenca i test disponibili senza eseguirli. Facoltativamente accetta un argomento che controlla il formato di output: text (impostazione predefinita, leggibile dall'utente) o json.

  Annotazioni

  Il json formato di output è disponibile in MTP a partire dalla versione 2.3.0.

• --maximum-failed-tests

  Specifica il numero massimo di errori di test che, quando raggiunto, arresterà l'esecuzione del test. Il supporto per questa opzione richiede agli autori del framework di implementare la funzionalità di IGracefulStopTestExecutionCapability. Il codice di uscita quando raggiunge tale quantità di errori di test è 13. Per altre informazioni, vedere Codici di uscita MTP.

  Annotazioni

  Questa funzionalità è disponibile in MTP a partire dalla versione 1.5.

• --minimum-expected-tests

  Specifica il numero minimo di test che devono essere eseguiti. Per impostazione predefinita, è previsto che venga eseguito almeno un test.

• --no-banner

  Disabilita il banner di avvio, il messaggio di copyright e il banner di telemetria. Lo stesso effetto può essere ottenuto tramite le TESTINGPLATFORM_NOBANNERDOTNET_NOLOGO o .

• --results-directory

  Directory in cui verranno inseriti i risultati del test. Se la directory specificata non esiste, viene creata. Il valore predefinito è TestResults nella directory che contiene l'applicazione di test.

• --timeout

  Timeout globale di esecuzione del test. Accetta un argomento come stringa nel formato <value>[h|m|s] in cui <value> è di tipo float.

• --treenode-filter

  Filtra i test da eseguire usando un'espressione di filtro albero. I filtri ad albero offrono una corrispondenza più completa rispetto --filter agli scenari avanzati.

Opzioni di estensione per scenario

Usare la tabella seguente per trovare rapidamente le opzioni di estensione.

Individuare le opzioni nell'app di test

Eseguire il file eseguibile di test con --help per elencare le opzioni disponibili per il set di estensioni corrente.

Per eseguire la diagnostica avanzata dei provider e delle opzioni registrate, utilizzare --info.

Vedere anche

• Panoramica di MTP
• Funzionalità MTP
• Test con dotnet test