dotnet new install

이 문서는 .NET Core 3.1 SDK 이상 버전 ✔️ 적용됩니다.

이름

dotnet new install - 템플릿 패키지를 설치합니다.

개요

dotnet new install <PATH|NUGET_ID>  [--interactive] [--add-source|--nuget-source <SOURCE>] [--force]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

묘사

dotnet new install 명령은 제공된 PATH 또는 NUGET_ID 템플릿 패키지를 설치합니다. 템플릿 패키지의 특정 버전 또는 시험판 버전을 설치하려면 <package-name>::<package-version>형식으로 버전을 지정합니다. 기본적으로 dotnet new 안정적인 최신 패키지 버전을 나타내는 버전에 대해 *를 전달합니다. 자세한 내용은 예제 섹션을 참조하세요.

이 명령을 실행할 때 템플릿 패키지의 버전이 이미 설치된 경우 템플릿 패키지가 지정된 버전으로 업데이트됩니다. 버전을 지정하지 않으면 패키지가 안정적인 최신 버전으로 업데이트됩니다. .NET SDK 6.0.100부터 인수가 버전을 지정하고 NuGet 패키지의 해당 버전이 이미 설치된 경우 다시 설치되지 않습니다. 인수가 PATH 이미 설치된 경우 다시 설치되지 않습니다.

.NET SDK 6.0.100 이전에는 패치 버전을 포함하여 각 .NET SDK 버전에 대해 템플릿 패키지가 개별적으로 관리되었습니다. 예를 들어 .NET SDK 5.0.100에서 dotnet new --install 사용하여 템플릿 패키지를 설치하는 경우 .NET SDK 5.0.100에만 설치됩니다. 패키지의 템플릿은 컴퓨터에 설치된 다른 .NET SDK 버전에서 사용할 수 없습니다.

.NET SDK 6.0.100부터 설치된 템플릿 패키지는 컴퓨터에 설치된 이후의 .NET SDK 버전에서 사용할 수 있습니다. .NET SDK 6.0.100에 설치된 템플릿 패키지는 .NET SDK 6.0.101, .NET SDK 6.0.200 등에서도 사용할 수 있습니다. 그러나 이러한 템플릿 패키지는 .NET SDK 6.0.100 이전의 .NET SDK 버전에서는 사용할 수 없습니다. 이전 .NET SDK 버전에서 .NET SDK 6.0.100 이상에 설치된 템플릿 패키지를 사용하려면 해당 .NET SDK 버전의 dotnet new install 사용하여 설치해야 합니다.

메모

.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에 대한 탭 완성을 활성화하려면 탭 완성.를 참조하세요.

이전 구문의 예:

• 최신 버전의 Azure 웹 작업 프로젝트 템플릿 패키지를 설치합니다.

  dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates
  

인수

• <PATH|NUGET_ID>

  템플릿 패키지를 설치할 파일 시스템의 폴더 또는 NuGet 패키지 식별자입니다. dotnet new 현재 작업 디렉터리에 사용할 수 있는 NuGet 원본 및 --add-source 옵션을 통해 지정된 원본에서 NuGet 패키지를 설치하려고 시도합니다. NuGet 원본에서 템플릿 패키지의 특정 버전 또는 시험판 버전을 설치하려면 <package-name>::<package-version>형식으로 버전을 지정합니다.

옵션

• --add-source|--nuget-source <SOURCE>

  기본적으로 dotnet new install 현재 디렉터리의 NuGet 구성 파일 계층 구조를 사용하여 패키지를 설치할 수 있는 NuGet 원본을 결정합니다. --nuget-source 지정하면 원본이 검사할 원본 목록에 추가됩니다. 현재 디렉터리에 대해 구성된 원본을 확인하려면 dotnet nuget list source사용합니다. 자세한 내용은 일반적인 NuGet 구성참조하세요.

  메모

  NuGet의 Https Everywhere 이니셔티브에 따라 dotnet newhttp 피드를 단계적으로 폐지하고 있습니다. http 피드가 전달되면 패키지에 대해 쿼리되지 않으며 경고가 표시됩니다. 필요한 경우 --force 옵션을 사용하여 이 동작을 재정의할 수 있습니다.

• -d|--diagnostics

  진단 출력을 사용하도록 설정합니다. .NET SDK 7.0.100부터 사용할 수 있습니다.

• --force

  다른 원본에서 템플릿 패키지를 재정의하는 경우에도 지정된 원본에서 템플릿 패키지를 설치할 수 있습니다. .NET SDK 7.0.100부터 사용할 수 있습니다.

• -h|--help

  설치 명령에 대한 도움말을 출력합니다. .NET SDK 7.0.100부터 사용할 수 있습니다.

• --interactive

  명령을 중지하고 사용자 입력 또는 작업을 기다릴 수 있습니다. 예를 들어 인증을 완료합니다. .NET 5.0 SDK부터 사용할 수 있습니다.

• -v|--verbosity <LEVEL>

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

예제

• ASP.NET Core용 최신 버전의 SPA 템플릿을 설치합니다.

  dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates
  

• ASP.NET Core용 SPA 템플릿 버전 2.0을 설치합니다.

  dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0
  

• 대화형 모드를 사용하여 사용자 지정 NuGet 원본에서 ASP.NET Core용 SPA 템플릿 버전 2.0을 설치합니다.

  dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source "https://api.my-custom-nuget.com/v3/index.json" --interactive
  

참고 항목

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