Microsoft. Testing.Platform(MTP) CLI 옵션 참조

이 문서에서는 MTP 명령줄 옵션에 대한 중앙 진입점을 제공합니다.

Important

플랫폼 옵션은 MTP 자체에서 사용할 수 있습니다. 확장 옵션은 각 대상 테스트 애플리케이션이 제공하는 확장 패키지를 등록하는 경우에만 사용할 수 있습니다. 패키지를 직접 추가하거나 패키지가 포함된 테스트 SDK 구성 또는 프로필을 사용합니다. 테스트 애플리케이션에서 확장을 등록하지 않으면 옵션이 인식할 수 없으므로 종료 코드 5와 함께 실행이 실패합니다.

플랫폼 옵션

@

응답 파일의 이름을 지정합니다. 응답 파일 이름은 @ 바로 뒤에 와야 하며, @ 문자와 응답 파일 이름 사이에 공백이 없어야 합니다.

응답 파일의 옵션은 명령줄의 해당 위치에 있는 것처럼 해석됩니다. 백슬래시 문자를 \ 사용하여 선을 연결할 수 없습니다. 응답 파일을 사용하면 터미널 제한을 초과할 수 있는 매우 긴 명령에 도움이 됩니다. 응답 파일을 인라인 명령줄 인수와 결합할 수 있습니다. 다음은 그 예입니다.
```
./TestExecutable.exe @"filter.rsp" --timeout 10s
```
여기서 filter.rsp 다음 내용을 포함할 수 있습니다.
```
--filter "A very long filter"
```
또는 다음과 같이 단일 rsp 파일을 사용하여 시간 제한과 필터를 모두 지정할 수 있습니다.
```
./TestExecutable.exe @"arguments.rsp"
```
```
--filter "A very long filter" --timeout 10s
```
비고

SDK 명령줄 파서는 응답 파일의 각 줄이 단일 토큰으로 처리되는 토큰별 접근 방식을 사용합니다 dotnet test. 이 경우 각 인수는 별도의 줄에 있어야 합니다.
```
--filter
A very long filter
--timeout
10s
```
--config-file

testconfig.json 파일을 지정합니다.
--debug

시작 시 테스트 실행을 일시 중지하여 테스트 프로세스에 디버거를 연결할 수 있습니다. TESTINGPLATFORM_WAIT_ATTACH_DEBUGGER를 .로 설정하는 것과 1같습니다. 브라우저 플랫폼에서 지원되지 않습니다.

비고

이 옵션은 버전 1.9.0부터 MTP에서 사용할 수 있습니다. 이전 --debug-wait-attach 옵션(MTP 1.6.0에서 도입됨)을 대체합니다. 이전 이름이 제거되어 더 이상 사용되지 않아야 합니다.
--diagnostic

진단 로깅을 사용하도록 설정합니다. 기본 로그 수준은 Trace. 파일은 출력 디렉터리에 다음과 같은 이름 형식으로 작성됩니다. log_[MMddHHssfff].diag.
--diagnostic-synchronous-write

기본 제공 파일 로거가 로그를 동기적으로 작성하도록 합니다. 로그 항목을 손실하지 않으려는 시나리오에 유용합니다(프로세스가 충돌하는 경우). 이렇게 하면 테스트 실행 속도가 느려집니다.

비고

버전 2.0.0부터 MTP에서 사용할 수 있습니다. MTP 2.0.0에서 제거된 이전 --diagnostic-filelogger-synchronouswrite 옵션을 대체합니다.
--diagnostic-output-directory

진단 로깅의 출력 디렉터리(지정되지 않은 경우)는 기본 TestResults 디렉터리에 생성됩니다.
--diagnostic-file-prefix

로그 파일 이름의 접두사입니다. 기본값은 "log"입니다.

비고

버전 2.0.0부터 MTP에서 사용할 수 있습니다. MTP 2.0.0에서 제거된 이전 --diagnostic-output-fileprefix 옵션을 대체합니다.
--diagnostic-verbosity

--diagnostic 스위치를 사용할 때 자세한 정보 표시 수준을 설정합니다. 사용 가능한 값은 Trace, Debug, Information, Warning, Error또는 Critical.
--enable-dynamic-extensions

테스트 애플리케이션 옆에 매니페스트 파일로 선언된 *.testingplatformextensions.json 확장을 로드할 수 있습니다. 동적 확장은 기본적으로 사용하지 않도록 설정됩니다. 보안 요구 사항 및 매니페스트 스키마는 동적으로 확장 로드를 참조하세요.

비고

이 옵션은 버전 2.4.0부터 MTP에서 사용할 수 있습니다.
--exit-on-process-exit

종속 프로세스가 종료되면 테스트 프로세스를 종료합니다. PID를 제공해야 합니다.
--filter-uid

테스트 노드 UID에서 실행할 테스트를 필터링합니다. 하나 이상의 UID를 허용합니다.

비고

이 옵션은 버전 1.8.0부터 MTP에서 사용할 수 있습니다. MTP 2.3.0부터는 --filter-uid와 --treenode-filter를 함께 사용할 수 없습니다. 둘 다 지정하면 명령줄 유효성 검사에 실패하며 종료 코드 InvalidCommandLine가 반환됩니다.
--help

명령을 사용하는 방법에 대한 설명을 출력합니다.
--ignore-exit-code

0이 아닌 일부 종료 코드를 무시하고 대신 0반환할 수 있습니다. 자세한 내용은 특정 종료 코드 무시를 참조하세요.
--info

다음과 같은 .NET 테스트 애플리케이션에 대한 고급 정보를 표시합니다.
- 플랫폼
- 환경입니다.
- 등록된 각 명령줄 공급자(예: name, version, description및 options).
- 등록된 각 도구(예: command, name, version, description) 및 모든 명령줄 공급자
이 기능은 동일한 명령줄 옵션을 등록하는 확장 또는 여러 버전의 확장(또는 플랫폼) 간에 사용 가능한 옵션의 변경 내용을 이해하는 데 사용됩니다.
--list-tests

실행하지 않고 사용 가능한 테스트를 나열합니다. 선택적으로 출력 형식을 제어하는 인수를 받을 수 있습니다: text(기본값, 사람이 읽기 쉬운 형식) 또는 json.

비고

출력 형식은 json 버전 2.3.0부터 MTP에서 사용할 수 있습니다.
--maximum-failed-tests

도달하면 테스트 실행을 중지하는 최대 테스트 실패 수를 지정합니다. 이 스위치를 지원하려면 프레임워크 작성자가 IGracefulStopTestExecutionCapability 기능을 구현해야 합니다. 테스트 실패의 양에 도달할 때 종료 코드는 13입니다. 자세한 내용은 MTP 종료 코드를 참조하세요.

비고

이 기능은 버전 1.5부터 MTP에서 사용할 수 있습니다.
--minimum-expected-tests

실행될 것으로 예상되는 최소 테스트 수를 지정합니다. 기본적으로 하나 이상의 테스트가 실행되어야 합니다.
--no-banner

시작 배너, 저작권 메시지 및 원격 분석 배너를 사용하지 않도록 설정합니다. 또는 TESTINGPLATFORM_NOBANNERDOTNET_NOLOGO를 통해 동일한 효과를 달성할 수 있습니다.
--results-directory

테스트 결과를 배치할 디렉터리입니다. 지정된 디렉터리가 없으면 생성됩니다. 기본값은 테스트 애플리케이션을 포함하는 디렉터리에 TestResults.
--server

편집기, IDE 또는 도구 통합을 위해 JSON-RPC 서버 모드에서 테스트 애플리케이션을 시작합니다. 값을 생략하거나 사용합니다 jsonrpc. 지원되는 원본 전용 클라이언트는 MTP 서버 모드를 참조하세요.

Important

dotnettestcli 값과 해당 전송 인수는 .NET SDK 통합의 내부입니다. 수동으로 전달하지 마세요.
--show-slowest-tests

터미널 요약에서 요청된 가장 느린 테스트 수를 표시합니다. 실행에 여러 테스트 모듈이 포함된 경우 MTP는 각 모듈에 대해 가장 느린 테스트를 보고합니다.

비고

이 옵션은 버전 2.4.0부터 MTP에서 사용할 수 있습니다.
--timeout

글로벌 테스트 실행 타임아웃입니다. 하나의 인수를 <value>[h|m|s] 형식의 문자열로 사용하며, 여기서 <value>은 부동 소수점 숫자입니다.
--treenode-filter

트리 필터 식을 사용하여 실행할 테스트를 필터링합니다. 트리 필터는 고급 시나리오보다 --filter 더 풍부한 일치를 제공합니다.

비고

MTP 2.3.0부터는 --treenode-filter와 --filter-uid를 함께 사용할 수 없습니다. 둘 다 지정하면 명령줄 유효성 검사에 실패하며 종료 코드 InvalidCommandLine가 반환됩니다.
--zero-tests-policy

모든 테스트를 건너뛰었으므로 테스트를 실행하지 않는 실행이 실패로 처리되는지 여부를 제어합니다. 유효한 값은 allow-skipped (기본값) 및 strict. 이 allow-skipped경우 건너뛴 모든 실행이 성공합니다. 이 strict경우 종료 코드 8(2.3.0 이전의 동작)으로 실패합니다.

비고

이 옵션은 버전 2.3.0부터 MTP에서 사용할 수 있습니다.

시나리오별 확장 옵션

다음 표를 사용하여 각 확장의 패키지 및 옵션을 찾습니다. 테스트 SDK 프로필은 직접 패키지 참조 대신 패키지를 제공할 수 있습니다.

시나리오	필수 구성 요소	기능 설명서
코드 커버리지 수집	`Microsoft.Testing.Extensions.CodeCoverage` 또는 `coverlet.MTP`	코드 검사
크래시 또는 응답 중지 덤프 수집	`Microsoft.Testing.Extensions.CrashDump` 또는 `Microsoft.Testing.Extensions.HangDump`	크래시 및 멈춤 덤프
테스트 보고서 생성	선택한 형식에 대한 확장 패키지(예: `Microsoft.Testing.Extensions.TrxReport`	테스트 보고서
터미널 출력 사용자 지정	MTP 코어(추가 패키지 없음)	터미널 출력
실패한 테스트 다시 시도	`Microsoft.Testing.Extensions.Retry`	재시도

테스트 앱에서 옵션 검색

테스트 실행 파일을 --help와 함께 실행하거나, dotnet test --help를 MTP 모드에서 실행하여 현재 확장 집합에 대해 사용할 수 있는 옵션 목록을 확인할 수 있습니다.

등록된 공급자 및 옵션에 대한 고급 진단의 경우 다음을 실행합니다 --info.

참고하십시오

피드백

이 페이지가 도움이 되었나요?

Last updated on 2026-08-31