dotnet new install

Articolo
02/22/2024

Questo articolo si applica a: ✔️ .NET Core 3.1 SDK e versioni successive

Nome

dotnet new install: installa un pacchetto di modelli.

Riepilogo

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

Descrizione

Il comando dotnet new install installa un pacchetto di modelli da PATH o NUGET_ID fornito. Se si vuole installare una versione specifica o una versione non definitiva di un pacchetto di modelli, specificare la versione nel formato <package-name>::<package-version>. Per impostazione predefinita, dotnet new passa * per la versione, che rappresenta la versione stabile più recente del pacchetto. Per altre informazioni, vedere la sezione Esempi.

Se una versione del pacchetto di modelli è già installata quando si esegue questo comando, il pacchetto di modelli verrà aggiornato alla versione specificata. Se non viene specificata alcuna versione, il pacchetto viene aggiornato alla versione stabile più recente. A partire da .NET SDK 6.0.100, se l'argomento specifica la versione e quella versione del pacchetto NuGet è già installata, non verrà reinstallata. Se l'argomento è un PATH ed è già installato, non verrà reinstallato.

Prima di .NET SDK 6.0.100, i pacchetti di modelli venivano gestiti singolarmente per ogni versione di .NET SDK, incluse le versioni delle patch. Ad esempio, se si installa il pacchetto di modelli usando dotnet new --install in .NET SDK 5.0.100, verrà installato solo per .NET SDK 5.0.100. I modelli del pacchetto non saranno disponibili in altre versioni di .NET SDK installate nel computer.

A partire da .NET SDK 6.0.100, i pacchetti di modelli installati sono disponibili nelle versioni successive di .NET SDK installate nel computer. Un pacchetto di modelli installato in .NET SDK 6.0.100 sarà disponibile anche in .NET SDK 6.0.101, .NET SDK 6.0.200 e così via. Questi pacchetti di modelli non saranno tuttavia disponibili nelle versioni di .NET SDK precedenti a .NET SDK 6.0.100. Per usare un pacchetto di modelli installato in .NET SDK 6.0.100 o versione successiva nelle versioni precedenti di .NET SDK, è necessario installarlo usando dotnet new install in tale versione di .NET SDK.

Nota

A partire da .NET 7 SDK, la sintassi dotnet new è cambiata:

Le opzioni --list, --search, --install e --uninstall sono diventate i sottocomandi list, search, install e uninstall.
L'opzione --update-apply è diventata il sottocomando update.
Per usare --update-check, usare il sottocomando update con l'opzione --check-only.

Altre opzioni disponibili prima sono ancora disponibili per l'uso con i rispettivi sottocomandi. La Guida separata per ogni sottocomando è disponibile tramite l'opzione -h o --help: dotnet new <subcommand> --help elenca tutte le opzioni supportate per il sottocomando.

Inoltre, il completamento della scheda è ora disponibile per dotnet new. Supporta il completamento per i nomi dei modelli installati e per le opzioni fornite da un modello selezionato. Per attivare il completamento della scheda per .NET SDK, vedere Abilitare il completamento della scheda.

Esempi di sintassi precedente:

Installare la versione più recente del pacchetto di modelli di progetto per processi Web di Azure:
```
dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates
```

Argomenti

<PATH|NUGET_ID>

Cartella nel file system o nell'identificatore del pacchetto NuGet da cui installare il pacchetto di modelli. dotnet new prova a installare il pacchetto NuGet dalle origini NuGet disponibili per la directory di lavoro corrente e le origini specificate tramite l'opzione --add-source. Se si vuole installare una versione specifica o una versione non definitiva di un pacchetto di modelli da un'origine NuGet, specificare la versione nel formato <package-name>::<package-version>.

Opzioni

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

Per impostazione predefinita, dotnet new install usa la gerarchia dei file di configurazione di NuGet dalla directory corrente per determinare l'origine NuGet da cui può essere installato il pacchetto. Se è specificato --nuget-source, l'origine verrà aggiunta all'elenco di origini da controllare.
Per controllare le origini configurate per la directory corrente, usare dotnet nuget list source. Per ulteriori informazioni, vedere Configurazioni NuGet comuni

Nota

In seguito all'iniziativa Https Everywhere di NuGet, dotnet new sta eliminando gradualmente i feed http. Se viene passato un feed http, non viene eseguita una query per i pacchetti e viene visualizzato un avviso. L'opzione --force può essere usata per eseguire l'override di questo comportamento, se necessario.
-d|--diagnostics

Abilita l'output di diagnostica. Disponibile a partire da .NET SDK 7.0.100.
--force

Consente di installare pacchetti di modelli dalle origini specificate anche se sovrascriveranno un pacchetto di modelli da un'altra origine. Disponibile a partire da .NET SDK 7.0.100.
-h|--help

Stampa la guida per il comando install. Disponibile a partire da .NET SDK 7.0.100.

--interactive

Consente al comando di arrestarsi e attendere l'input o l'azione dell'utente, ad esempio il completamento dell'autenticazione. Disponibile a partire da .NET 5.0 SDK.

-v|--verbosity <LEVEL>

Imposta il livello di dettaglio del comando. I valori consentiti sono q[uiet], m[inimal], n[ormal] e diag[nostic]. Disponibile a partire da .NET SDK 7.0.100.

Esempi

Installare la versione più recente dei modelli di applicazione a pagina singola per ASP.NET Core:
```
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates
```
Installare la versione 2.0 dei modelli di applicazione a pagina singola per ASP.NET Core:
```
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0
```
Installare la versione 2.0 dei modelli di applicazione a pagina singola per ASP.NET Core da un'origine NuGet personalizzata usando la modalità interattiva:
```
dotnet new --install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source "https://api.my-custom-nuget.com/v3/index.json" --interactive
```