Condividi tramite

Comando dotnet

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

Nome

#D0: driver generico per l'interfaccia della riga di comando di .NET.

Sinossi

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 <PATH>] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Descrizione

Il dotnet comando ha due funzioni:

  • Fornisce comandi per l'uso di 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. Per eseguire l'applicazione significa trovare ed eseguire il punto di ingresso, che nel caso delle app console è il metodo #D0. Ad esempio, dotnet myapp.dll esegue l'applicazione myapp . Per informazioni sulle opzioni di distribuzione, vedere Distribuzione di 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 vengono usate da solo, senza specificare un comando o un'applicazione da eseguire. Ad esempio, dotnet --info o dotnet --version. Stampano informazioni sull'ambiente.

  • --info

    Stampa informazioni dettagliate su un'installazione .NET e sull'ambiente del computer, ad esempio il sistema operativo corrente, e il commit sha della versione .NET.

  • --version

Stampa la versione di .NET SDK usata dai dotnet comandi, che possono essere interessati da un file global.json . Disponibile solo quando l'SDK è installato.

  • --list-runtimes [--arch <ARCH>]

    Stampa un elenco dei runtime .NET installati per l'architettura dell'oggetto richiamato dotnet. Una versione x86 di dotnet elenca solo runtime x86 e una versione x64 di dotnet elenca solo runtime x64.

    .NET 10 e versioni successive supportano l'argomento --arch . Se specificato e non uguale all'architettura dotnet , cerca un'installazione .NET dell'architettura specificata e stampa tutti i runtime installati in tale posizione. I valori consentiti includono arm64, x64 e x86. Il repository dotnet/runtime include l'elenco completo dei valori di architettura validi.

  • --list-sdks [--arch <ARCH>]

    Stampa un elenco degli SDK .NET installati per l'architettura dell'oggetto richiamato dotnet. Una versione x86 di dotnet elenca solo sdk x86 e una versione x64 di dotnet elenchi solo sdk x64.

    .NET 10 e versioni successive supportano l'argomento --arch . Se specificato e non uguale dotnet all'architettura, cerca un'installazione .NET dell'architettura specificata e stampa tutti gli SDK installati in tale posizione. I valori consentiti includono arm64, x64 e x86. Il repository dotnet/runtime include l'elenco completo dei valori di architettura validi.

  • -?|-h|--help

    Stampa un elenco di comandi disponibili.

Opzioni per l'esecuzione di un comando

Con un comando sono disponibili dotnet le opzioni seguenti. 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 questa opzione è disponibile.

  • -?|-h|--help

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

  • command options

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

Opzioni per l'esecuzione di un'applicazione

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

  • --additionalprobingpath <PATH>

    Percorso contenente criteri di probe e assembly di probe. Ripetere l'opzione per specificare più percorsi.

  • --additional-deps <PATH>

    Percorso di un file di.deps.json aggiuntivo. Un filedeps.json contiene un elenco di dipendenze, dipendenze di compilazione e informazioni sulla versione usate per risolvere i conflitti di assembly. Per altre informazioni, vedere File di configurazione di runtime in GitHub.

  • --roll-forward <SETTING>

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

    • #D0: eseguire il roll forward alla versione di patch più recente. In questo modo viene disabilitato il roll forward della versione secondaria.
    • #D0: eseguire il roll forward alla versione secondaria più bassa più bassa, se manca la versione secondaria richiesta. Se la versione secondaria richiesta è presente, viene usato il criterio LatestPatch.
    • Major - Eseguire il roll forward alla versione principale più bassa e alla versione secondaria più bassa, se la versione principale richiesta è mancante. Se la versione principale richiesta è presente, viene usato il criterio Secondario.
    • #D0: eseguire il roll forward alla versione secondaria più recente, anche se è presente una versione secondaria richiesta. Destinato agli scenari di hosting dei componenti.
    • #D0: eseguire il roll forward alla versione principale e secondaria più elevata, anche se è presente la versione principale richiesta. Destinato agli scenari di hosting dei componenti.
    • Disable - Non eseguire il rollforward. Associa solo alla versione specificata. Questo criterio non è consigliato per l'uso generale perché disabilita la possibilità di eseguire il roll forward alle patch più recenti. Questo valore è consigliato solo per i 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 .NET da usare per eseguire l'applicazione.

    Questa opzione esegue l'override della versione del primo riferimento al framework nel file dell'applicazione .runtimeconfig.json . Ciò significa che funziona come previsto solo se è presente un solo 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 exec comando

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

  • --depsfile <PATH>

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

  • --runtimeconfig <PATH>

    Percorso di un fileruntimeconfig.json . Un file diruntimeconfig.json contiene le impostazioni di runtime ed è in genere denominato <nomeapplicazione>.runtimeconfig.json. Per ulteriori informazioni, consultare le impostazioni di configurazione del runtime .NET ai riferimenti e.

Comandi dotnet

Generale

Comando Funzione
comando di build dotnet Compila un'applicazione .NET.
dotnet build-server Interagisce con i server avviati da una compilazione.
dotnet clean Pulire gli output di compilazione.
dotnet exec Esegue un'applicazione .NET.
guida dotnet Mostra la documentazione più dettagliata online per il comando.
dotnet msbuild Fornisce l'accesso alla riga di comando di MSBuild.
dotnet new Inizializza un progetto C# o F# per un determinato modello.
dotnet pack Crea un pacchetto NuGet del codice.
di pubblicazione dotnet Pubblica un'applicazione dipendente da .NET Framework o autonoma.
dotnet restore Ripristina le dipendenze per una determinata applicazione.
dotnet run Esegue l'applicazione dall'origine.
dotnet sdk check Mostra up-to-date dello stato dell'SDK e delle versioni di runtime installate.
dotnet sln Opzioni per aggiungere, rimuovere ed elencare progetti in un file di soluzione.
dotnet store Archivia gli assembly nell'archivio pacchetti di runtime.
di test dotnet Esegue i test usando un test runner.

Riferimenti al progetto

Comando Funzione
dotnet aggiungi riferimento Aggiunge un riferimento al progetto.
elenco di riferimenti dotnet Elenca i riferimenti al progetto.
dotnet reference remove Rimuove un riferimento al progetto.

Pacchetti NuGet

Comando Funzione
aggiunta di un pacchetto dotnet Aggiunge un pacchetto NuGet.
dotnet package list Elenca i pacchetti NuGet.
dotnet package remove Rimuove un pacchetto NuGet.
Ricerca di pacchetti dotnet Cerca un pacchetto NuGet.

Comandi NuGet

Comando Funzione
dotnet nuget delete Elimina o annulla l'elenco di un pacchetto dal server.
dotnet nuget push Esegue il push di un pacchetto nel server e lo pubblica.
dotnet nuget variabili locali Cancella o elenca le risorse NuGet locali, ad esempio cache http-request, cache temporanea o cartella pacchetti globali 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 clean Rimuove i componenti del carico di lavoro.
configurazione del carico di lavoro dotnet Abilita o disabilita la modalità di aggiornamento del set di carico di lavoro.
cronologia del carico di lavoro dotnet Mostra tutte le azioni di installazione del carico di lavoro.
'installazione del carico di lavoro dotnet Installa un carico di lavoro facoltativo.
elenco di carichi di lavoro dotnet Elenca tutti i carichi di lavoro installati.
ripristino del carico di lavoro dotnet Ripristina tutti i carichi di lavoro installati.
ripristino del carico di lavoro dotnet Ripristinare i carichi di lavoro necessari per un progetto.
ricerca carico di lavoro dotnet Elencare i carichi di lavoro selezionati o tutti i carichi di lavoro disponibili.
la disinstallazione del carico di lavoro dotnet Disinstalla un carico di lavoro.
aggiornamento del carico di lavoro dotnet Reinstalla tutti i carichi di lavoro installati.

Comandi globali, tool-path e strumenti locali

Gli strumenti sono applicazioni console installate dai pacchetti NuGet e vengono richiamati dal prompt dei comandi. È possibile scrivere strumenti manualmente o installare strumenti scritti da terze parti. Gli strumenti sono noti anche come strumenti globali, strumenti di percorso degli strumenti e strumenti locali. Per ulteriori informazioni, vedere panoramica degli strumenti .NET.

Comando Funzione
Installazione dello strumento dotnet Installa uno strumento nel computer.
elenco degli strumenti dotnet Elenca tutti gli strumenti globali, tool-path o locali attualmente installati nel computer.
ricerca strumento dotnet Cerca NuGet.org strumenti con il termine di ricerca specificato nel nome o nei metadati.
Disinstallazione dello strumento dotnet Disinstalla uno strumento dal computer.
aggiornamento dello strumento dotnet Aggiorna uno strumento installato nel computer.

Strumenti aggiuntivi

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

Strumento Funzione
dev-certs Crea e gestisce i certificati di sviluppo.
Ef Strumenti da riga di comando di Entity Framework Core.
segreti utente Gestisce i segreti utente di sviluppo.
orologio 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

Vedere anche

  • Last updated on