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"
  

참고 항목

• dotnet new 명령
• dotnet new search 명령
• dotnet new에 대한 사용자 지정 템플릿