Dela via

dotnet ny installation

Den här artikeln gäller för: ✔️ .NET Core 3.1 SDK och senare versioner

Namn

dotnet new install – installerar ett mallpaket.

Sammanfattning

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

Beskrivning

Kommandot dotnet new install installerar ett mallpaket från PATH eller NUGET_ID som tillhandahålls. Om du vill installera en viss version eller förhandsversion av ett mallpaket anger du versionen i formatet <package-name>::<package-version>. Som standard skickar dotnet new * för versionen, som representerar den senaste stabila paketversionen. Mer information finns i avsnittet Exempel.

Om en version av mallpaketet redan installerades när du kör det här kommandot uppdateras mallpaketet till den angivna versionen. Om ingen version anges uppdateras paketet till den senaste stabila versionen. Från och med .NET SDK 6.0.100, om argumentet anger versionen och den versionen av NuGet-paketet redan är installerad, installeras den inte om. Om argumentet är en PATH och det redan är installerat installeras det inte om.

Före .NET SDK 6.0.100 hanterades mallpaket individuellt för varje .NET SDK-version, inklusive korrigeringsversioner. Om du till exempel installerar mallpaketet med dotnet new --install i .NET SDK 5.0.100 installeras det endast för .NET SDK 5.0.100. Mallar från paketet är inte tillgängliga i andra .NET SDK-versioner som är installerade på datorn.

Från och med .NET SDK 6.0.100 är installerade mallpaket tillgängliga i senare .NET SDK-versioner installerade på datorn. Ett mallpaket som är installerat i .NET SDK 6.0.100 kommer också att vara tillgängligt i .NET SDK 6.0.101, .NET SDK 6.0.200 och så vidare. Dessa mallpaket är dock inte tillgängliga i .NET SDK-versioner före .NET SDK 6.0.100. Om du vill använda ett mallpaket som är installerat i .NET SDK 6.0.100 eller senare i tidigare .NET SDK-versioner måste du installera det med dotnet new install i .NET SDK-versionen.

Not

Från och med .NET 7 SDK har dotnet new syntax ändrats:

  • Alternativen --list, --search, --installoch --uninstall blev list, search, installoch uninstall underkommandon.
  • Alternativet --update-apply blev update underkommando.
  • Om du vill använda --update-checkanvänder du underkommandot update med alternativet --check-only.

Andra alternativ som var tillgängliga tidigare är fortfarande tillgängliga att använda med respektive underkommandon. Separat hjälp för varje underkommando är tillgänglig via alternativet -h eller --help: dotnet new <subcommand> --help visar alla alternativ som stöds för underkommandot.

Dessutom är fliken klar nu tillgänglig för dotnet new. Den stöder slutförande för installerade mallnamn och för de alternativ som en vald mall innehåller. Information om hur du aktiverar tabbavslut för .NET SDK finns i Aktivera flikslutsättning.

Exempel på gammal syntax:

  • Installera den senaste versionen av projektmallspaketet för Azure-webbjobb:

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

Varning

Mallar kan köra MSBuild-kod när de utlöses, installera eller köra ej betrodda .NET-mallar.

Argument

  • <PATH|NUGET_ID>

    Mappen i filsystemet eller NuGet-paketidentifieraren som mallpaketet ska installeras från. dotnet new försöker installera NuGet-paketet från NuGet-källorna som är tillgängliga för den aktuella arbetskatalogen och de källor som anges via alternativet --add-source. Om du vill installera en viss version eller förhandsversion av ett mallpaket från NuGet-källan anger du versionen i formatet <package-name>::<package-version>.

Alternativ

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

    Som standard använder dotnet new install hierarkin för NuGet-konfigurationsfiler från den aktuella katalogen för att fastställa den NuGet-källa som paketet kan installeras från. Om --nuget-source anges läggs källan till i listan över källor som ska kontrolleras. Om du vill kontrollera de konfigurerade källorna för den aktuella katalogen använder du dotnet nuget list source. Mer information finns i Vanliga NuGet-konfigurationer.

    Not

    Efter NuGets initiativ Https Everywhere fasas dotnet new ut http feeds. Om en http feed skickas efterfrågas den inte för paket och en varning visas. Alternativet --force kan användas för att åsidosätta det här beteendet om det behövs.

  • -d|--diagnostics

    Aktiverar diagnostiska utdata. Tillgänglig sedan .NET SDK 7.0.100.

  • --force

    Tillåter installation av mallpaket från de angivna källorna även om de skulle åsidosätta ett mallpaket från en annan källa. Tillgänglig sedan .NET SDK 7.0.100.

  • -h|--help

    Skriver ut hjälp för installationskommandot. Tillgänglig sedan .NET SDK 7.0.100.

  • --interactive

    Tillåter att kommandot stoppar och väntar på användarens indata eller åtgärd. Till exempel för att slutföra autentiseringen. Tillgänglig sedan .NET 5.0 SDK.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal]och diag[nostic]. Tillgänglig sedan .NET SDK 7.0.100.

Exempel

  • Installera den senaste versionen av SPA-mallar för ASP.NET Core:

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

  • Installera version 2.0 av SPA-mallarna för ASP.NET Core:

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

  • Installera version 2.0 av SPA-mallarna för ASP.NET Core från en anpassad NuGet-källa med interaktivt läge:

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

Se även