Condividi tramite


Informazioni di riferimento sull'interfaccia della riga di comando di NuGet

L'interfaccia della riga di comando di nuget.exeNuGet fornisce l'estensione completa della funzionalità NuGet per installare, creare, pubblicare e gestire pacchetti senza apportare modifiche ai file di progetto.

Per usare qualsiasi comando, aprire una finestra di comando o una shell bash, quindi eseguire nuget seguito dal comando e dalle opzioni appropriate, ad esempio nuget help pack (per visualizzare la Guida nel comando pack).

Questa documentazione riflette la versione più recente dell'interfaccia della riga di comando di NuGet. Per informazioni esatte su qualsiasi versione specificata in uso, eseguire nuget help per il comando desiderato.

Per informazioni su come usare i comandi di base con l'interfaccia della riga di comando di nuget.exe, vedere Installare e usare pacchetti tramite l'interfaccia della riga di comando di nuget.exe.

Installazione di nuget.exe

Installare sempre la versione più recente dello strumento che supporta la configurazione.

  • È possibile scaricare la versione consigliata più recente all'indirizzo https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.
  • Se lo strumento dell'interfaccia della nuget.exe riga di comando è già installato, è possibile aggiornare lo strumento alla versione più recente con il comando nuget update -self.
  • Per la compatibilità con i sistemi di integrazione continua meno recenti, un URL precedente fornisce https://nuget.org/nuget.exe attualmente la versione deprecata 2.8.6 dello strumento dell'interfaccia della riga di comando.
  1. Visitare nuget.org/downloads e scaricare NuGet versione 3.3 o successiva.

    • La versione 5.0 e successive richiede .NET Framework versione 4.7.2 o successiva.
    • La versione 4.1.0 e successive è necessaria per pubblicare i pacchetti in nuget.org.
    • La versione 2.8.6 non è compatibile con Mono.
  2. Ogni download è direttamente il file nuget.exe. Indicare al browser di salvare il file in una cartella di propria scelta. Il file di download non è un programma di installazione, quindi non viene visualizzato nulla se si esegue il file direttamente dal browser.

  3. Per usare lo strumento dell'interfaccia della riga di comando da qualsiasi posizione, aggiungere il percorso della cartella per il nuget.exe file alla variabile di ambiente PATH.

Suggerimento

Per rendere disponibile l'interfaccia della riga di comando di NuGet all'interno della console di Gestione pacchetti in Visual Studio, vedere Uso dell'interfaccia della riga di comando di nuget.exe nella console.

Disponibilità

Per informazioni dettagliate, vedere Disponibilità delle funzionalità.

  • Tutti i comandi sono disponibili in Windows.
  • Tutti i comandi funzionano con nuget.exe in esecuzione in Mono tranne dove indicato per pack, restoree update.
  • I packcomandi , deleterestore, locals, e push sono disponibili anche in Mac e Linux tramite l'interfaccia della riga di comando dotnet.

Comandi e applicabilità

Comandi e applicabilità disponibili alla creazione di pacchetti, all'utilizzo di pacchetti e/o alla pubblicazione di un pacchetto in un host:

Comandi comuni Ruoli applicabili Versione di NuGet Descrizione
pack Creazione 2.7+ Crea un pacchetto NuGet da un .nuspec file di progetto o . Quando si esegue in Mono, la creazione di un pacchetto da un file di progetto non è supportata.
push Pubblicazione Tutte le date Pubblica un pacchetto in un'origine del pacchetto.
config Tutte le date Tutte le date Ottiene o imposta i valori di configurazione di NuGet.
help or ? Tutte le date Tutte le date Visualizza le informazioni della Guida o la Guida per un comando.
locals Consumo 3.3+ Elenca i percorsi delle cartelle global-packages, http-cache e temp e cancella il contenuto di tali cartelle.
restore Consumo 2.7+ Ripristina tutti i pacchetti a cui fa riferimento il formato di gestione dei pacchetti in uso. Durante l'esecuzione in Mono, il ripristino dei pacchetti con il formato PackageReference non è supportato.
setapikey Pubblicazione, consumo Tutte le date Salva una chiave API per un'origine del pacchetto specifica quando tale origine del pacchetto richiede una chiave per l'accesso.
spec Creazione Tutte le date Genera un .nuspec file, usando i token se si genera il file da un progetto di Visual Studio.
Comandi secondari Ruoli applicabili Versione di NuGet Descrizione
add Pubblicazione 3.3+ Aggiunge un pacchetto a un'origine del pacchetto non HTTP usando il layout gerarchico. Per le origini HTTP, usare il push.
delete Pubblicazione Tutte le date Rimuove o annulla l'elenco di un pacchetto da un'origine del pacchetto.
init Creazione 3.3+ Aggiunge pacchetti da una cartella a un'origine del pacchetto usando il layout gerarchico.
install Consumo Tutte le date Installa un pacchetto nel progetto corrente, ma non modifica i progetti o i file di riferimento.
list Consumo, forse pubblicazione Tutte le date Visualizza i pacchetti da una determinata origine.
mirror Pubblicazione Deprecato nella versione 3.2+ Esegue il mirror di un pacchetto e delle relative dipendenze da un'origine a un repository di destinazione.
search Consumo 5.8+ Esegue la ricerca in una determinata origine usando la stringa di query fornita.
sources Consumo, pubblicazione Tutte le date Gestisce le origini dei pacchetti nei file di configurazione.
update Consumo Tutte le date Aggiornamenti i pacchetti di un progetto alle versioni più recenti disponibili. Non supportato durante l'esecuzione in Mono.

Diversi comandi usano varie variabili di ambiente.

Comandi dell'interfaccia della riga di comando nuGet in base ai ruoli applicabili:

Ruolo Comandi
Consumo configinstall, help, , list, localsrestore, search, setapikey, , sourcesupdate
Creazione config, help, init, packspec
Pubblicazione add, config, delete, helplist, push, , setapikeysources

Gli sviluppatori interessati solo all'utilizzo di pacchetti, ad esempio, devono comprendere solo il subset di comandi NuGet.

Nota

I nomi delle opzioni di comando non fanno distinzione tra maiuscole e minuscole. Le opzioni deprecate non sono incluse in questo riferimento, ad esempio NoPrompt (sostituite da NonInteractive) e Verbose (sostituite da Verbosity).

Localizzazione

NuGet.exe i messaggi di stato, avviso e errore vengono convertiti nelle stesse impostazioni locali di Visual Studio. NuGet.exe viene fornito come singolo exe e a causa delle considerazioni sulle dimensioni, solo i messaggi più comuni vengono tradotti in tutte le lingue.