dotnet nieuwe installatie

Artikel
01/29/2025

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

Naam

dotnet new install - installeert een sjabloonpakket.

Samenvatting

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

Beschrijving

Met de opdracht dotnet new install wordt een sjabloonpakket geïnstalleerd vanuit de opgegeven PATH of NUGET_ID. 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>. Standaard geeft dotnet new * door 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 nieuwste stabiele versie. Vanaf .NET SDK 6.0.100, als het argument de versie opgeeft en die versie van het NuGet-pakket al is geïnstalleerd, wordt het niet opnieuw 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, waaronder patchversies. Als u bijvoorbeeld het sjabloonpakket installeert met behulp van dotnet new --install in .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 vóór .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 .NET SDK-versies, moet u het installeren met behulp van dotnet new install in die .NET SDK-versie.

Notitie

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

De --list, --search, --installen --uninstall opties werden list, search, installen uninstall subopdrachten.
De --update-apply optie werd de update subopdracht.
Als u --update-checkwilt gebruiken, gebruikt u de update subopdracht met de optie --check-only.

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

Bovendien is tabvoltooiing nu beschikbaar voor dotnet new. Het ondersteunt voltooiing voor geïnstalleerde sjabloonnamen en voor de opties die een geselecteerde sjabloon biedt. Zie Voltooiing van tabbladen inschakelenom tabvoltooiing voor de .NET SDK te activeren.

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 op 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 optie --add-source. Als u een specifieke versie of voorlopige versie van een sjabloonpakket wilt installeren vanuit de NuGet-bron, geeft u de versie op in de indeling <package-name>::<package-version>.

Opties

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

Standaard gebruikt dotnet new install de hiërarchie van NuGet-configuratiebestanden uit de huidige map om te bepalen vanaf welke NuGet-bron 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 u dotnet nuget list source. Zie Common NuGet Configurationsvoor meer informatie.

Notitie

Na het Https Everywhere-initiatief van NuGet wordt dotnet newhttp feeds geleidelijk uitgefaseerd. Als er een http-feed wordt doorgegeven, wordt er geen query uitgevoerd op pakketten en wordt er een waarschuwing weergegeven. De --force optie kan worden gebruikt om dit gedrag indien nodig te overschrijven.
-d|--diagnostics

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

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

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

--interactive

Hiermee kan de opdracht stoppen en 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
```

Delen via