dotnet new install

Artikel
06/23/2023

Dit artikel is van toepassing op: ✔️ .NET Core 3.1 SDK en latere versies

Naam

dotnet new install - installeert een sjabloonpakket.

Synopsis

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

Description

Met de dotnet new install opdracht wordt een sjabloonpakket uit de PATH of NUGET_ID geïnstalleerd. Als u een specifieke versie of voorlopige versie van een sjabloonpakket wilt installeren, geeft u de versie op in de indeling <package-name>::<package-version>. dotnet new Standaard wordt * doorgegeven voor de versie, die de meest recente stabiele pakketversie vertegenwoordigt. Zie de sectie Voorbeelden voor meer informatie.

Als er al een versie van het sjabloonpakket is geïnstalleerd toen u deze opdracht uitvoerde, wordt het sjabloonpakket bijgewerkt naar de opgegeven versie. Als er geen versie is opgegeven, wordt het pakket bijgewerkt naar de meest recente stabiele versie. Vanaf .NET SDK 6.0.100 wordt het niet opnieuw geïnstalleerd als het argument de versie aangeeft en die versie van het NuGet-pakket al is geïnstalleerd. Als het argument een PATH is en het al is geïnstalleerd, wordt het niet opnieuw geïnstalleerd.

Vóór .NET SDK 6.0.100 werden sjabloonpakketten afzonderlijk beheerd voor elke .NET SDK-versie, inclusief patchversies. Als u bijvoorbeeld het sjabloonpakket installeert met in dotnet new --install .NET SDK 5.0.100, wordt het alleen geïnstalleerd voor .NET SDK 5.0.100. Sjablonen uit het pakket zijn niet beschikbaar in andere .NET SDK-versies die op uw computer zijn geïnstalleerd.

Vanaf .NET SDK 6.0.100 zijn geïnstalleerde sjabloonpakketten beschikbaar in latere .NET SDK-versies die op uw computer zijn geïnstalleerd. Een sjabloonpakket dat is geïnstalleerd in .NET SDK 6.0.100, is ook beschikbaar in .NET SDK 6.0.101, .NET SDK 6.0.200, enzovoort. Deze sjabloonpakketten zijn echter niet beschikbaar in .NET SDK-versies ouder dan .NET SDK 6.0.100. Als u een sjabloonpakket wilt gebruiken dat is geïnstalleerd in .NET SDK 6.0.100 of hoger in eerdere versies van .NET SDK, moet u het installeren met in dotnet new install die .NET SDK-versie.

Notitie

Vanaf de .NET 7 SDK is de dotnet new syntaxis gewijzigd:

De --listopties , --search, --installen --uninstall werden listsubopdrachten , search, installen uninstall .
De --update-apply optie is de update subopdracht geworden.
Als u wilt gebruiken --update-check, gebruikt u de update subopdracht met de --check-only optie .

Andere opties die eerder beschikbaar waren, zijn nog steeds beschikbaar voor gebruik met hun respectieve subopdrachten. Afzonderlijke help voor elke subopdracht is beschikbaar via de -h optie of --help : dotnet new <subcommand> --help bevat alle ondersteunde opties voor de subopdracht.

Daarnaast is het voltooien van tabbladen nu beschikbaar voor dotnet new. Het ondersteunt voltooiing voor geïnstalleerde sjabloonnamen en voor de opties die een geselecteerde sjabloon biedt. Als u tabvoltooiing voor de .NET SDK wilt activeren, raadpleegt u Voltooiing van tabbladen inschakelen.

Voorbeelden van oude syntaxis:

Installeer de nieuwste versie van het projectsjabloonpakket voor Azure-webtaken:
```
dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates
```

Argumenten

<PATH|NUGET_ID>

De map in het bestandssysteem of de NuGet-pakket-id waaruit het sjabloonpakket moet worden geïnstalleerd. dotnet new probeert het NuGet-pakket te installeren vanuit de NuGet-bronnen die beschikbaar zijn voor de huidige werkmap en de bronnen die zijn opgegeven via de --add-source optie. Als u een specifieke versie of voorlopige versie van een sjabloonpakket van een NuGet-bron wilt installeren, geeft u de versie op in de indeling <package-name>::<package-version>.

Opties

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

Standaard wordt dotnet new install de hiërarchie van NuGet-configuratiebestanden uit de huidige map gebruikt om de NuGet-bron te bepalen van waaruit het pakket kan worden geïnstalleerd. Als --nuget-source is opgegeven, wordt de bron toegevoegd aan de lijst met bronnen die moeten worden gecontroleerd.
Als u de geconfigureerde bronnen voor de huidige map wilt controleren, gebruikt dotnet nuget list sourceu . Zie Algemene NuGet-configuraties voor meer informatie

Notitie

In het vervolg op het Https Everywhere-initiatief van NuGet worden dotnet new feeds geleidelijk uitgefaseerd http . Als een http feed wordt doorgegeven, wordt deze niet opgevraagd voor pakketten en wordt er een waarschuwing weergegeven. De --force optie kan worden gebruikt om dit gedrag zo nodig te overschrijven.
-d|--diagnostics

Hiermee schakelt u diagnostische uitvoer in. Beschikbaar sinds .NET SDK 7.0.100.
--force

Hiermee kunt u sjabloonpakketten installeren vanuit de opgegeven bronnen, zelfs als hiermee een sjabloonpakket van een andere bron wordt overschreven. Beschikbaar sinds .NET SDK 7.0.100.
-h|--help

Hiermee wordt de help voor de installatieopdracht afgedrukt. Beschikbaar sinds .NET SDK 7.0.100.

--interactive

Hiermee staat u de opdracht toe om te stoppen en te wachten op invoer of actie van de gebruiker. Bijvoorbeeld om de verificatie te voltooien. Beschikbaar sinds .NET 5.0 SDK.

-v|--verbosity <LEVEL>

Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijn q[uiet], m[inimal], n[ormal]en diag[nostic]. Beschikbaar sinds .NET SDK 7.0.100.

Voorbeelden

Installeer de nieuwste versie van beveiligd-WACHTWOORDVERIFICATIE-sjablonen voor ASP.NET Core:
```
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates
```
Installeer versie 2.0 van de beveiligd-WACHTWOORDVERIFICATIE-sjablonen voor ASP.NET Core:
```
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0
```
Installeer versie 2.0 van de beveiligd-WACHTWOORDVERIFICATIE-sjablonen voor ASP.NET Core vanuit een aangepaste NuGet-bron met behulp van de interactieve modus:
```
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source "https://api.my-custom-nuget.com/v3/index.json" --interactive
```

Share via