Condividi tramite

dotnet tool exec

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

Nome

dotnet tool exec - Scarica e richiama uno strumento .NET senza installarlo in modo permanente.

Synopsis

dotnet tool exec <PACKAGE_NAME>[@<VERSION>]
    [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-http-cache] [--prerelease]
    [-v|--verbosity <LEVEL>]
    [--] [<tool-arguments>...]

dotnet tool exec -h|--help

Description

Il dotnet tool exec comando fornisce una modalità di chiamata a uno strumento per gli strumenti .NET. Scarica automaticamente il pacchetto dello strumento specificato nella cache NuGet e lo richiama senza modificare il sistema PATH o richiedere l'installazione permanente.

Quando si esegue dotnet tool exec, il comando :

  1. Controlla la versione (o l'intervallo di versioni) specificato (o la versione più recente se non è specificata alcuna versione) nei feed NuGet configurati per decidere quale pacchetto scaricare.
  2. Scarica il pacchetto specificato nella cache NuGet (se non è già presente).
  3. Richiama lo strumento con gli argomenti forniti.
  4. Restituisce il codice di uscita dello strumento.

dotnet tool exec funziona perfettamente con strumenti globali e locali. Se è disponibile un manifesto dello strumento locale, usa il manifesto per determinare quale versione dello strumento eseguire.

Questo comando esiste anche in altre due forme per facilitare l'uso

  • dotnet dnx - Alias nascosto per dotnet tool exec che viene usato come modo per implementare facilmente lo dnx script stesso
  • dnx - Script della shell che richiama dotnet dnx dall'SDK. Questo script viene fornito dal programma di installazione ed è disponibile in PATH. Consente un uso molto semplice degli strumenti direttamente tramite dnx <toolname>.

Arguments

  • PACKAGE_NAME

    ID pacchetto NuGet dello strumento .NET da eseguire. Facoltativamente, è possibile specificare una versione usando la @ sintassi , ad esempio dotnetsay@2.1.0.

  • tool-arguments

    Argomenti da passare allo strumento da eseguire. Tutto dopo -- viene passato direttamente allo strumento.

Options

  • --allow-roll-forward

    Consentire allo strumento di usare una versione più recente del runtime .NET se il runtime di destinazione non è installato.

  • --add-source <SOURCE>

    Aggiunge un'altra origine pacchetto NuGet da usare durante l'installazione. I feed sono accessibili in parallelo, non in una sequenza di propagazione di fallback. Se lo stesso pacchetto e la stessa versione sono disponibili in più feed, il feed più veloce vince. Per altre informazioni, vedere Cosa accade quando viene installato un pacchetto NuGet. È possibile controllare questa operazione tramite l'uso del mapping dell'origine del pacchetto NuGet. Per altre informazioni, vedere Mapping origine pacchetti.

  • --configfile <FILE>

    File di configurazione NuGet (nuget.config) da usare. Se si dispone di indicazione, verranno usate solo le impostazioni di questo file. Se non specificato, verrà usata la gerarchia dei file di configurazione dalla directory corrente. Per ulteriori informazioni, vedere Configurazioni NuGet comuni.

  • --disable-parallel

    Impedisce il ripristino di più progetti in parallelo.

  • --ignore-failed-sources

    Considera gli errori di origine del pacchetto come avvisi.

  • --interactive

    Consente al comando di arrestarsi e attendere l'input o l'azione dell'utente, ad esempio il completamento dell'autenticazione.

  • --no-http-cache

    Non memorizza nella cache le richieste HTTP ai feed NuGet configurati.

  • --prerelease

    Consente di selezionare i pacchetti non definitive durante la risoluzione della versione da installare.

  • -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]. Il valore predefinito è normal. Per altre informazioni, vedere LoggerVerbosity.

  • -?|-h|--help

    Stampa una descrizione di come usare il comando .

Esempi

  • dotnet tool exec dotnetsay

    Scarica (se necessario) ed esegue la versione più recente dello dotnetsay strumento.

  • dotnet tool exec dotnetsay@2.1.0

    Scarica (se necessario) ed esegue la versione 2.1.0 dello dotnetsay strumento.

  • dotnet tool exec dotnetsay@2.*

    Scarica (se necessario) ed esegue la versione più recente dello dotnetsay strumento nell'intervallo di versioni 2.x.

  • dotnet tool exec dotnetsay -- Hello World

    Esegue lo dotnetsay strumento e passa "Hello World" come argomenti allo strumento.

  • dotnet tool exec --add-source https://api.nuget.org/v3/index.json mytool

    Scarica ed esegue mytool usando l'origine NuGet specificata.

Confronto con altri comandi

Questo comando è progettato per essere un modo unificato per lavorare con gli strumenti .NET. Sebbene i comandi di installazione degli strumenti disponibili in precedenza rimangano disponibili, dotnet tool exec offre un'esperienza più semplice e flessibile per la maggior parte degli utenti.

Command Scopo Installazione Ambito
dotnet tool exec Esecuzione one-shot Nessuno (solo memorizzato nella cache) Temporary
dotnet tool install -g Installazione globale permanente Generale A livello di sistema
dotnet tool install Installazione locale permanente Manifesto locale Progetto
dotnet tool run Eseguire uno strumento locale già installato Richiede l'installazione precedente Progetto

Il dotnet tool install -g comando svolge comunque uno scopo importante per gli utenti che vogliono installare in modo permanente uno strumento. Tuttavia, per gli utenti che vogliono provare uno strumento o eseguirlo in una pipeline CI/CD, dotnet tool exec è spesso più adatto.

Vedere anche

  • Last updated on