다음을 통해 공유

dotnet new list

  • 아티클

이 문서의 적용 대상: ✔️ .NET Core 3.1 SDK 이상 버전

이름

dotnet new list - dotnet new를 사용하여 실행할 수 있는 템플릿을 나열합니다.

개요

dotnet new list [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language {"C#"|"F#"|VB}]
    [--tag <TAG>] [--type <TYPE>] [--columns <COLUMNS>] [--columns-all]
    [-o|--output <output>] [--project <project>] [--ignore-constraints]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

설명

dotnet new list 명령은 dotnet new와 함께 사용할 수 있는 템플릿을 나열합니다. <TEMPLATE_NAME>이 지정된 경우 지정된 템플릿 이름이 포함된 템플릿을 나열합니다. 이 옵션은 기본 템플릿과 설치된 템플릿만 나열합니다. 로컬로 설치할 수 있는 NuGet 템플릿을 찾으려면 search 명령을 사용합니다.

.NET SDK 7.0.100부터 list 명령이 컴퓨터에 설치된 모든 템플릿을 표시하지 않을 수 있습니다. 템플릿 제약 조건의 결과를 고려하며 사용할 수 없는 템플릿은 표시되지 않습니다. 모든 템플릿을 강제로 표시하려면 --ignore-constraints 옵션을 사용합니다.

참고 항목

.NET 7 SDK부터 dotnet new 구문이 변경되었습니다.

  • --list, --search, --install 및 --uninstall 옵션이 list, search, install 및 uninstall 하위 명령이 되었습니다.
  • --update-apply 옵션이 update 하위 명령이 되었습니다.
  • --update-check를 사용하려면 --check-only 옵션과 함께 update 하위 명령을 사용합니다.

이전에 사용 가능했던 다른 옵션은 해당 하위 명령과 함께 계속 사용할 수 있습니다. 각 하위 명령에 대한 별도의 도움말은 -h 또는 --help 옵션을 통해 사용할 수 있습니다. dotnet new <subcommand> --help는 하위 명령에 대해 지원되는 모든 옵션을 나열합니다.

또한 이제 dotnet new에 대한 탭 완료 기능을 사용할 수 있습니다. 설치된 템플릿 이름과 선택한 템플릿이 제공하는 옵션에 대한 완료 기능을 지원합니다. .NET SDK에 대한 탭 완료를 사용하도록 설정하려면 탭 완료 사용을 참조하세요.

이전 구문의 예:

  • 모든 SPA(단일 페이지 애플리케이션) 템플릿을 나열합니다.

    • .NET SDK 6.0.100 이후
    dotnet new --list spa
    • .NET SDK 6.0.100 이전
    dotnet new spa --list

인수

  • TEMPLATE_NAME

    인수를 지정하면 템플릿 이름 또는 약식 이름에 <TEMPLATE_NAME>을 포함하는 템플릿만 표시됩니다.

옵션

  • --author <AUTHOR>

    템플릿 작성자를 기반으로 템플릿을 필터링합니다. 부분 일치가 지원됩니다. .NET SDK 5.0.300부터 사용 가능합니다.

  • --columns <COLUMNS>

    출력에 표시할 열의 쉼표로 구분된 목록입니다. 지원되는 열은 다음과 같습니다.

    • language - 템플릿에서 지원하는 쉼표로 구분된 언어 목록입니다.
    • tags - 템플릿 태그 목록입니다.
    • author - 템플릿 작성자입니다.
    • type - 템플릿 형식: 프로젝트 또는 항목입니다.

    템플릿 이름과 약식 이름이 항상 표시됩니다. 열의 기본 목록은 템플릿 이름, 약식 이름, 언어 및 태그입니다. 이는 --columns=language,tags를 지정하는 것과 같습니다. .NET SDK 5.0.300부터 사용 가능합니다.

  • --columns-all

    출력의 모든 열을 표시합니다. .NET SDK 5.0.300부터 사용 가능합니다.

  • -d|--diagnostics

    진단 출력을 사용합니다. .NET SDK 7.0.100부터 사용 가능합니다.

  • -h|--help

    list 명령에 대한 도움말을 인쇄합니다. .NET SDK 7.0.100부터 사용 가능합니다.

  • --ignore-constraints

    템플릿이 실행할 제약 조건을 충족하는지 여부를 확인하지 않습니다. .NET SDK 7.0.100부터 사용 가능합니다.

  • -lang|--language {C#|F#|VB}

    템플릿에서 지원하는 언어를 기준으로 템플릿을 필터링합니다. 수락된 언어는 템플릿에 따라 다릅니다. 일부 템플릿의 경우 유효하지 않습니다.

    참고 항목

    일부 셸은 #을 특수 문자로 해석합니다. 이러한 경우 언어 매개 변수 값을 따옴표로 묶습니다. 예: dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    생성된 출력을 배치할 위치입니다. 기본값은 현재 디렉터리입니다. list 명령의 경우 템플릿에 대한 제약 조건을 올바르게 평가하려면 출력 디렉터리를 지정해야 할 수도 있습니다. .NET SDK 7.0.100부터 사용 가능합니다.

  • --project <PROJECT_PATH>

    템플릿이 추가되는 프로젝트입니다. list 명령의 경우 템플릿에 대한 제약 조건을 올바르게 평가하기 위해 템플릿이 추가되는 프로젝트를 지정해야 할 수도 있습니다. .NET SDK 7.0.100부터 사용 가능합니다.

  • --tag <TAG>

    템플릿 태그를 기반으로 템플릿을 필터링합니다. 선택하려면 템플릿에 조건과 정확히 일치하는 태그가 하나 이상 있어야 합니다. .NET SDK 5.0.300부터 사용 가능합니다.

  • --type <TYPE>

    템플릿 유형을 기반으로 템플릿을 필터링합니다. 미리 정의된 값은 project, item 및 solution입니다.

  • -v|--verbosity <LEVEL>

    명령의 세부 정보 표시 수준을 설정합니다. 허용되는 값은 q[uiet], m[inimal], n[ormal] 및 diag[nostic]입니다. .NET SDK 7.0.100부터 사용 가능합니다.

예제

  • 모든 템플릿 나열

    dotnet new list

  • 모든 SPA(단일 페이지 애플리케이션) 템플릿을 나열합니다.

    dotnet new list spa

  • we 부분 문자열과 일치하는 모든 템플릿을 나열합니다.

    dotnet new list we

  • F# 언어를 지원하는 we substring과 일치하는 모든 템플릿을 나열합니다.

    dotnet new list we --language "F#"

  • 모든 항목 템플릿을 나열합니다.

    dotnet new list --type item

  • 출력의 작성자 및 형식을 표시하는 모든 C# 템플릿을 나열합니다.

    dotnet new list --language "C#" --columns "author,type"

참고 항목