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 オプションは、サブコマンド、search、install、および uninstall サブコマンド listになりました。
• --update-apply オプションは、update サブコマンドになりました。
• --update-checkを使用するには、--check-only オプションを指定して update サブコマンドを使用します。

以前に使用可能だったその他のオプションは、それぞれのサブコマンドで引き続き使用できます。 -h または --help オプションを使用して、サブコマンドごとに個別のヘルプを使用できます。 dotnet new <subcommand> --help サブコマンドでサポートされているすべてのオプションを一覧表示します。

さらに、タブ補完が dotnet newで使用できるようになりました。 インストールされているテンプレート名と、選択したテンプレートによって提供されるオプションの完了がサポートされます。 .NET SDK のタブ補完をアクティブ化するには、「タブ補完 を有効にするを参照してください。

古い構文の例:

• 最新バージョンの Azure Web ジョブ プロジェクト テンプレート パッケージをインストールします。

  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を使用します。 詳細については、「Common NuGet Configurations」を参照してください。

  手記

  NuGet の Https Everywhere イニシアチブに従って、dotnet new は http フィードを段階的に廃止しています。 http フィードが渡された場合、パッケージのクエリは実行されず、警告が表示されます。 --force オプションを使用すると、必要に応じてこの動作をオーバーライドできます。

• -d|--diagnostics

  診断出力を有効にします。 .NET SDK 7.0.100 以降で使用できます。

• --force

  別のソースのテンプレート パッケージをオーバーライドする場合でも、指定したソースからテンプレート パッケージをインストールできるようにします。 .NET SDK 7.0.100 以降で使用できます。

• -h|--help

  install コマンドのヘルプを出力します。 .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 用のカスタム テンプレートを する