Freigeben über

dotnet new install

  • Artikel

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

Name

dotnet new install – installiert ein Vorlagenpaket.

Zusammenfassung

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

Beschreibung

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

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

Vor .NET SDK 6.0.100 wurden Vorlagenpakete für jede .NET SDK-Version einzeln verwaltet, einschließlich Patchversionen. 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 ist auch in .NET SDK 6.0.101, .NET SDK 6.0.200 usw. verfügbar. Diese Vorlagenpakete sind jedoch in .NET SDK-Versionen vor .NET SDK 6.0.100 nicht verfügbar. Um ein Vorlagenpaket zu verwenden, das in .NET SDK 6.0.100 oder höher in früheren .NET SDK-Versionen installiert ist, müssen Sie es mit dotnet new install in dieser .NET SDK-Version installieren.

Anmerkung

Ab dem .NET 7 SDK hat sich die syntax der dotnet new geändert:

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

Andere Optionen, die zuvor verfügbar waren, stehen weiterhin zur Verwendung mit den jeweiligen Unterbefehlen zur Verfügung. Separate Hilfe für jeden Unterbefehl steht über die Option -h oder --help zur Verfügung: dotnet new <subcommand> --help listet alle unterstützten Optionen für den Unterbefehl auf.

Darüber hinaus ist der Abschluss der Registerkarte jetzt für dotnet newverfügbar. Er unterstützt den Abschluss für installierte Vorlagennamen und für die von einer ausgewählten Vorlage bereitgestellten Optionen. Informationen zum Aktivieren des Abschlusses der Registerkarte für das .NET SDK finden Sie unter Aktivieren des Abschlusses der Registerkarte.

Beispiele für alte Syntax:

  • Installieren Sie die neueste 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 NuGet-Paketbezeichner zum Installieren des Vorlagenpakets aus. dotnet new versucht, das NuGet-Paket aus den NuGet-Quellen zu installieren, die für das aktuelle Arbeitsverzeichnis und die über die Option --add-source angegebenen Quellen verfügbar sind. Wenn Sie eine bestimmte Version oder Vorabversion eines Vorlagenpakets aus 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 von 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 zur Liste der zu überprüfenden Quellen hinzugefügt. Um die konfigurierten Quellen für das aktuelle Verzeichnis zu überprüfen, verwenden Sie dotnet nuget list source. Weitere Informationen finden Sie unter Common NuGet Configurations.

    Anmerkung

    Nach nuGets Https Everywhere Initiative wird dotnet newhttp Feeds auslaufen. Wenn ein http Feed übergeben wird, wird er nicht für Pakete abgefragt und eine Warnung angezeigt. Die option --force kann verwendet werden, um dieses Verhalten bei Bedarf außer Kraft zu setzen.

  • -d|--diagnostics

    Aktiviert die Diagnoseausgabe. 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

    Druckt hilfe für den Installationsbefehl. Verfügbar seit .NET SDK 7.0.100.

  • --interactive

    Ermöglicht es dem Befehl, die Benutzereingabe oder -aktion zu beenden und zu warten. Um beispielsweise die Authentifizierung abzuschließen. Verfügbar seit .NET 5.0 SDK.

  • -v|--verbosity <LEVEL>

    Legt die Ausführlichkeitsebene des Befehls fest. Zulässige Werte sind q[uiet], m[inimal], n[ormal]und diag[nostic]. Verfügbar seit .NET SDK 7.0.100.

Beispiele

  • Installieren Sie die neueste Version von SPA-Vorlagen für ASP.NET Core:

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

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

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

  • Installieren Sie 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