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 6.0.100 이상에 설치된 템플릿 패키지를 이전 .NET SDK 버전에서 사용하려면 해당 .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 new에서는 http 피드를 단계적으로 중단합니다. 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

참고 항목