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 を使用してインストールする必要があります。

Note

.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 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 を使用します。 詳細については、「一般的な NuGet 構成」を参照してください

    注意

    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

関連項目