dotnet new install

Dieser Artikel gilt für: ✔️ .NET Core 3.1 SDK und höher

Name

dotnet new install: Installiert ein Vorlagenpaket.

Übersicht

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

Beschreibung

Mit dem Befehl dotnet new install wird ein Vorlagenpaket aus dem bereitgestellten PATH bzw. der NUGET_ID installiert. Wenn Sie eine bestimmte Version oder eine Vorabversion eines Vorlagenpakets installieren möchten, geben Sie die Version im Format <package-name>::<package-version> an. Standardmäßig übergibt dotnet new das Symbol * für die Version, die die letzte stabile Paketversion darstellt. Weitere Informationen finden Sie im Abschnitt Beispiele.

Wenn beim Ausführen dieses Befehls bereits eine Version des Vorlagenpakets installiert war, wird dieses auf die angegebene Version aktualisiert. Wenn keine Version angegeben wird, wird das Paket auf die letzte stabile Version aktualisiert. Ab .NET SDK 6.0.100 wird die Version nicht erneut installiert, wenn das Argument die Version angibt und diese Version des NuGet-Pakets bereits installiert ist. Wenn ein Argument ein PATH ist und die Version bereits installiert ist, wird sie nicht neu installiert.

Vor .NET SDK 6.0.100 wurden Vorlagenpakete für jede .NET SDK-Version, einschließlich Patchversionen, einzeln verwaltet. Wenn Sie beispielsweise das Vorlagenpaket mit dotnet new --install in .NET SDK 5.0.100 installieren, wird es nur für .NET SDK 5.0.100 installiert. Vorlagen aus dem Paket sind in anderen .NET SDK-Versionen, die auf Ihrem Computer installiert sind, nicht verfügbar.

Ab .NET SDK 6.0.100 sind installierte Vorlagenpakete in späteren .NET SDK-Versionen verfügbar, die auf Ihrem Computer installiert sind. Ein in .NET SDK 6.0.100 installiertes Vorlagenpaket wird auch in .NET SDK 6.0.101, .NET SDK 6.0.200 usw. verfügbar sein. In .NET SDK-Versionen vor .NET SDK 6.0.100 werden diese Vorlagenpakete jedoch nicht verfügbar sein. Um ein in .NET SDK 6.0.100 oder höher installiertes Vorlagenpaket in früheren .NET SDK-Versionen zu verwenden, müssen Sie es mit dotnet new install in dieser .NET SDK-Version installieren.

Hinweis

Ab .NET 7 SDK hat sich die Syntax von dotnet new geändert:

  • Die Optionen --list, --search, --install und --uninstall wurden zu den Unterbefehlen list, search, install und uninstall.
  • Die Option --update-apply wurde zum Unterbefehl update.
  • Um --update-check zu verwenden, verwenden Sie den Unterbefehl update mit der Option --check-only.

Andere Optionen, die zuvor verfügbar waren, können weiterhin mit ihren jeweiligen Unterbefehlen verwendet werden. Gesonderte Hilfe für jeden Unterbefehl ist über die Option -h oder --help verfügbar: dotnet new <subcommand> --help listet alle unterstützten Optionen für den Unterbefehl auf.

Darüber hinaus ist die Vervollständigung mit der TAB-TASTE jetzt für dotnet new verfügbar. Es unterstützt die Vervollständigung für installierte Vorlagennamen und für die Optionen, die eine ausgewählte Vorlage bereitstellt. Informationen zum Aktivieren der Vervollständigung mit der TAB-TASTE für das .NET SDK finden Sie unter Aktivieren der Vervollständigung mit der TAB-TASTE.

Beispiele für alte Syntax:

  • Installieren der neuesten Version des Projektvorlagenpakets für Azure-Webaufträge:

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

Argumente

  • <PATH|NUGET_ID>

    Der Ordner im Dateisystem oder der Bezeichner des NuGet-Pakets, aus dem das Vorlagenpaket installiert werden soll. dotnet new versucht, das NuGet-Paket aus den NuGet-Quellen zu installieren, die für das aktuelle Arbeitsverzeichnis verfügbar sind, sowie aus den über die Option --add-source angegebenen Quellen. Wenn Sie eine bestimmte Version oder eine Vorabversion eines Vorlagenpakets aus einer NuGet-Quelle installieren möchten, geben Sie die Version im Format <package-name>::<package-version> an.

Optionen

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

    Standardmäßig verwendet dotnet new install die Hierarchie der NuGet-Konfigurationsdateien aus dem aktuellen Verzeichnis, um die NuGet-Quelle zu bestimmen, aus der das Paket installiert werden kann. Wenn --nuget-source angegeben ist, wird die Quelle der Liste der zu überprüfenden Quellen hinzugefügt.
    Verwenden Sie dotnet nuget list source, um die konfigurierten Quellen für das aktuelle Verzeichnis zu überprüfen. Weitere Informationen finden Sie unter Gängige NuGet-Konfigurationen.

    Hinweis

    Gemäß der Https Everywhere-Initiative von NuGet, lässt dotnet newhttp-Feeds auslaufen. Wenn ein http-Feed übergeben wird, wird er nicht in Bezug auf Pakete abgefragt, und es wird eine Warnung angezeigt. Mithilfe der Option --force kann dieses Verhalten bei Bedarf außer Kraft gesetzt werden.

  • -d|--diagnostics

    Ermöglicht die diagnostische Ausgabe. Verfügbar seit .NET SDK 7.0.100.

  • --force

    Ermöglicht das Installieren von Vorlagenpaketen aus den angegebenen Quellen, auch wenn sie ein Vorlagenpaket aus einer anderen Quelle überschreiben würden. Verfügbar seit .NET SDK 7.0.100.

  • -h|--help

    Zeigt Hilfe für den Befehl „install“ an. Verfügbar seit .NET SDK 7.0.100.

  • --interactive

    Ermöglicht dem Befehl, anzuhalten und auf Benutzereingaben oder Aktionen zu warten. Beispielsweise, um die Authentifizierung abzuschließen. Verfügbar seit dem .NET 5.0 SDK.

  • -v|--verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad für den Befehl fest. Zulässige Werte sind q[uiet], m[inimal], n[ormal] und diag[nostic]. Verfügbar seit .NET SDK 7.0.100.

Beispiele

  • Installieren der neuesten Version der SPA-Vorlagen für ASP.NET Core:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates
    
  • Installieren von Version 2.0 der SPA-Vorlagen für ASP.NET Core:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0
    
  • Installieren von Version 2.0 der SPA-Vorlagen für ASP.NET Core aus einer benutzerdefinierten NuGet-Quelle im interaktiven Modus:

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

Siehe auch