Comando dotnet

  • Articolo

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

Nome

dotnet - Driver generico per l'interfaccia della riga di comando di .NET.

Riepilogo

Per ottenere informazioni sui comandi disponibili e sull'ambiente:

dotnet [--version] [--info] [--list-runtimes] [--list-sdks]

dotnet -h|--help

Per eseguire un comando (richiede l'installazione dell'SDK):

dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
    [command-options] [arguments]

Per eseguire un'applicazione:

dotnet [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    <PATH_TO_APPLICATION> [arguments]

dotnet exec [--additionalprobingpath] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Descrizione

Il comando dotnet ha due funzioni:

  • Fornisce comandi per lavorare su progetti .NET.

    Ad esempio, dotnet build compila un progetto. Ogni comando definisce le proprie opzioni e gli argomenti. Tutti i comandi supportano l'opzione --help per la stampa di una breve documentazione su come usare il comando.

  • Esegue applicazioni .NET.

    Specificare il percorso di un file dell'applicazione .dll per eseguire l'applicazione. Eseguire l'applicazione significa trovare ed eseguire il punto di ingresso, che nel caso delle app console è il metodo Main. Ad esempio, dotnet myapp.dll esegue l'applicazione myapp. Per informazioni sulle opzioni di distribuzione, vedere Distribuzione applicazioni .NET.

Opzioni

Sono disponibili opzioni diverse per:

  • Visualizzazione di informazioni sull'ambiente.
  • Esecuzione di un comando.
  • Esecuzione di un'applicazione.

Opzioni per la visualizzazione delle informazioni sull'ambiente e dei comandi disponibili

Le opzioni seguenti sono disponibili quando dotnet è usato da solo, senza specificare un comando o un'applicazione da eseguire. Ad esempio, dotnet --info o dotnet --version. Stampano informazioni sull'ambiente.

  • --info

    Consente di visualizzare informazioni dettagliate sull'installazione di .NET e sull'ambiente del computer, come ad esempio il sistema operativo corrente e l'Agente integrità sistema di commit della versione di .NET.

  • --version

Stampa la versione dell’SDK .NET usata dai comandi dotnet, che può essere interessata da un file global.json. Disponibile solo quando l'SDK è installato.

  • --list-runtimes

    Stampa un elenco dei runtime .NET installati. Una versione x86 dell'SDK elenca solo i runtime x86 e una versione x64 dell'SDK elenca solo i runtime x64.

  • --list-sdks

    Stampa un elenco degli SDK .NET installati.

  • -?|-h|--help

    Stampa un elenco dei comandi disponibili.

Opzioni per l'esecuzione di un comando

Con un comando sono disponibili le seguenti opzioni dotnet. Ad esempio, dotnet build --help o dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Abilita l'output di diagnostica.

  • -v|--verbosity <LEVEL>

    Imposta il livello di dettaglio del comando. I valori consentiti sono q[uiet], m[inimal], n[ormal], d[etailed] e diag[nostic]. Non supportato in ogni comando. Vedere la pagina specifica dei comandi per determinare se l’opzione è disponibile.

  • -?|-h|--help

    Stampa la documentazione per un determinato comando. Ad esempio, dotnet build --help mostra la Guida per il comando build.

  • command options

    Ogni comando definisce le opzioni specifiche di tale comando. Per un elenco delle opzioni disponibili, vedere la pagina specifica dei comandi.

Opzioni per l'esecuzione di un'applicazione

Quando dotnet esegue un'applicazione, sono disponibili le opzioni seguenti. Ad esempio: dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

    Percorso contenente i criteri di probe e gli assembly di cui eseguire il probe. Ripetere l'opzione per specificare più percorsi.

  • --additional-deps <PATH>

    Percorso di un file .deps.json aggiuntivo. Un file deps.json contiene un elenco di dipendenze, le dipendenze di compilazione e le informazioni sulla versione usate per risolvere i conflitti di assembly. Per altre informazioni, vedere Runtime Configuration Files (File di configurazione di runtime) su GitHub.

  • --roll-forward <SETTING>

    Controlla la modalità di applicazione del roll forward all'app. SETTING può essere uno dei valori seguenti. Se non specificato, Minor è l'impostazione predefinita.

    • LatestPatch - Esegue il roll forward alla versione di patch più recente. Disabilita il roll forward della versione secondaria.
    • Minor - Esegue il roll forward alla versione secondaria successiva minima, se la versione secondaria richiesta non esiste. Se la versione secondaria richiesta è presente, viene usato il criterio LatestPatch.
    • Major - Esegue il roll forward alla versione principale successiva minima e alla versione secondaria minima, se la versione principale richiesta non esiste. Se la versione principale richiesta è presente, viene usato il criterio Minor.
    • LatestMinor - Esegue il roll forward alla versione secondaria più recente, anche se la versione secondaria richiesta è presente. È destinata a scenari di hosting dei componenti.
    • LatestMajor - Esegue il roll forward alla versione principale e secondaria più recente, anche se la versione principale richiesta è presente. È destinata a scenari di hosting dei componenti.
    • Disable - Non esegue il roll forward. Esegue solo un'associazione alla versione specificata. Non è consigliato usare questo criterio per scopi generali poiché disabilita la possibilità di eseguire il roll forward alle patch più recenti. Questo valore è consigliato solo a scopo di test.

    Ad eccezione di Disable, tutte le impostazioni useranno la versione della patch più recente disponibile.

    Il comportamento di roll forward può essere configurato anche in una proprietà del file di progetto, in una proprietà del file di configurazione di runtime e in una variabile di ambiente. Per altre informazioni, vedere Roll forward del runtime della versione principale.

  • --fx-version <VERSION>

    Versione del runtime di .NET da usare per eseguire l'applicazione.

    Questa opzione sostituisce la versione del primo riferimento al framework nel file .runtimeconfig.json dell'applicazione. Ciò significa che funziona come previsto solo se è presente un unico riferimento al framework. Se l'applicazione dispone di più riferimenti al framework, l'uso di questa opzione può causare errori.

Opzioni per l'esecuzione di un'applicazione con il comando exec

Le opzioni seguenti sono disponibili solo quando dotnet esegue un'applicazione usando il comando exec. Ad esempio: dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

  • --depsfile <PATH>

    Percorso di un file deps.json. Un file deps.json è un file di configurazione che contiene informazioni sulle dipendenze necessarie per eseguire l'applicazione. Questo file viene generato dall’SDK .NET.

  • --runtimeconfig <PATH>

    Percorso di un file runtimeconfig.json. Un file runtimeconfig.json contiene le impostazioni di runtime ed è in genere denominato <nomeapplicazione>.runtimeconfig.json. Per altre informazioni, vedere Impostazioni di configurazione del runtime .NET.

Comandi dotnet

Generali

Comando Funzione
dotnet build Compila un'applicazione .NET.
dotnet build-server Interagisce con i server avviati da una compilazione.
dotnet clean Pulisce gli output di compilazione.
dotnet exec Esegue un'applicazione .NET.
dotnet help Visualizza documentazione online dettagliata per il comando.
dotnet migrate Esegue la migrazione di un progetto Preview 2 in un progetto .NET Core SDK 1.0.
dotnet msbuild Consente di accedere alla riga di comando di MSBuild.
dotnet new Inizializza un progetto C# o F# per un modello specificato.
dotnet pack Crea un pacchetto NuGet del codice.
dotnet publish Pubblica un'applicazione .NET dipendente dal framework o autonoma.
dotnet restore Ripristina le dipendenze per una determinata applicazione.
dotnet run Esegue l'applicazione dall'origine.
dotnet sdk check Mostra lo stato aggiornato delle versioni dell'SDK e del runtime installate.
dotnet sln Opzioni per aggiungere, rimuovere ed elencare i progetti in un file di soluzione.
dotnet store Archivia gli assembly nell'archivio pacchetti di runtime.
dotnet test Esegue test usando un Test Runner.

Riferimenti al progetto

Comando Funzione
dotnet add reference Aggiunge un riferimento al progetto.
dotnet list reference Elenca i riferimenti al progetto.
dotnet remove reference Rimuove un riferimento dal progetto.

Pacchetti NuGet

Comando Funzione
dotnet add package Aggiunge un pacchetto NuGet.
dotnet remove package Rimuove un pacchetto NuGet.

Comandi NuGet

Comando Funzione
dotnet nuget delete Rimuove dall'elenco o elimina un pacchetto dal server.
dotnet nuget push Effettua il push di un pacchetto nel server e lo pubblica.
dotnet nuget locals Cancella o elenca risorse NuGet locali come cache delle richieste HTTP, cache temporanea o cartella globale dei pacchetti a livello di computer.
dotnet nuget add source Aggiunge un'origine NuGet.
dotnet nuget disable source Disabilita un'origine NuGet.
dotnet nuget enable source Abilita un'origine NuGet.
dotnet nuget list source Elenca tutte le origini NuGet configurate.
dotnet nuget remove source Rimuove un'origine NuGet.
dotnet nuget update source Aggiorna un'origine NuGet.

Comandi del carico di lavoro

Comando Funzione
dotnet workload install Installa un carico di lavoro facoltativo.
dotnet workload list Elenca tutti i carichi di lavoro installati.
dotnet workload repair Ripristina tutti i carichi di lavoro installati.
dotnet workload search Elenca i carichi di lavoro selezionati o tutti i carichi di lavoro disponibili.
dotnet workload uninstall Disinstalla un carico di lavoro.
dotnet workload update Reinstalla tutti i carichi di lavoro installati.

Comandi per gli strumenti globali, locali e tool-path

Gli strumenti sono applicazioni console installate dai pacchetti NuGet e vengono richiamati dal prompt dei comandi. È possibile scrivere strumenti propri o installare strumenti scritti da terze parti. Gli strumenti sono noti anche come strumenti globali, strumenti tool-path e strumenti locali. Per altre informazioni, vedere Panoramica degli strumenti .NET.

Comando Funzione
dotnet tool install Installa uno strumento sul computer.
dotnet tool list Elenca tutti gli strumenti globali, tool-path o locali attualmente installati sul computer.
dotnet tool search Cerca su NuGet.org gli strumenti che hanno il termine di ricerca specificato nel nome o nei metadati.
dotnet tool uninstall Disinstalla uno strumento dal computer.
dotnet tool update Aggiorna uno strumento installato sul computer.

Strumenti aggiuntivi

Gli strumenti aggiuntivi seguenti sono disponibili come parte dell’SDK .NET:

Tool Funzione
dev-certs Crea e gestisce i certificati di sviluppo.
ef Strumenti da riga di comando di Entity Framework Core.
user-secrets Gestisce i segreti dell'utente di sviluppo.
watch Un watcher di file che riavvia o ricarica un'applicazione quando rileva le modifiche nel codice sorgente.

Per altre informazioni su ogni strumento, digitare dotnet <tool-name> --help.

Esempi

Creare una nuova applicazione console .NET:

dotnet new console

Compilare un progetto e le relative dipendenze in una determinata directory:

dotnet build

Eseguire un'applicazione:

dotnet exec myapp.dll

dotnet myapp.dll

Vedi anche