dotnet tool update

  • Articolo

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

Nome

dotnet tool update: aggiorna lo strumento .NET specificato nel computer.

Riepilogo

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --tool-path <PATH>
    [--add-source <SOURCE>] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] 
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --local
    [--add-source <SOURCE>] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update -h|--help

Descrizione

Il comando dotnet tool update consente di aggiornare gli strumenti .NET nel computer all'ultima versione stabile del pacchetto. Il comando disinstalla e reinstalla uno strumento aggiornandolo. Per usare il comando, specificare una delle opzioni seguenti:

  • Per aggiornare uno strumento globale installato nel percorso predefinito, usare l'opzione --global
  • Per aggiornare uno strumento globale installato in un percorso personalizzato, usare l'opzione --tool-path.
  • Per aggiornare uno strumento locale, usare l'opzione --local.

Argomenti

  • PACKAGE_ID

    Nome/ID del pacchetto NuGet che contiene lo strumento globale .NET da aggiornare. È possibile trovare il nome del pacchetto usando il comando dotnet tool list.

Opzioni

  • --add-source <SOURCE>

    Aggiunge un'altra origine pacchetto NuGet da usare durante l'installazione. I feed sono accessibili in parallelo e non in sequenza secondo un ordine di precedenza. Se lo stesso pacchetto e la stessa versione si trovano in più feed, il feed più veloce vince. Per altre informazioni, vedere Cosa accade quando viene installato un pacchetto NuGet?.

  • --allow-downgrade

    Consenti il downgrade del pacchetto durante l'installazione o l'aggiornamento di un pacchetto di strumenti .NET. Elimina l'avviso " La versione richiesta x.x.x è inferiore alla versione esistente x.x.x".

  • --configfile <FILE>

    File di configurazione NuGet (nuget.config) da utilizzare. 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.

  • --framework <FRAMEWORK>

    Specifica il framework di destinazione per cui aggiornare lo strumento.

  • -g|--global

    Specifica che l'aggiornamento è per uno strumento a livello utente. Non può essere usata con l'opzione --tool-path. Omettendo sia --global che --tool-path specifica che lo strumento da aggiornare è uno strumento locale.

  • -?|-h|--help

    Stampa una descrizione di come usare il comando.

  • --ignore-failed-sources

    Gestisce gli errori dell'origine dei pacchetti come avvisi.

  • --interactive

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

  • --local

    Aggiorna lo strumento e il manifesto dello strumento locale. Non è possibile combinarla con l'opzione --global o l'opzione --tool-path.

  • --no-cache

    Non memorizza nella cache i pacchetti e le richieste HTTP.

  • --prerelease

    Includere versioni non definitive.

  • --tool-manifest <PATH>

    Percorso del file manifesto.

  • --tool-path <PATH>

    Specifica il percorso in cui è installato lo strumento globale. Il valore di PATH può essere assoluto o relativo. Non può essere usata con l'opzione --global. Omettendo sia --global che --tool-path specifica che lo strumento da aggiornare è uno strumento locale.

  • -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]. Per ulteriori informazioni, vedere LoggerVerbosity.

  • --version <VERSION>

    Intervallo di versioni a cui aggiornare il pacchetto dello strumento. Non è possibile usare questa opzione per effettuare il downgrade delle versioni. È necessario prima eseguire il downgrade delle versioni uninstall più recenti.

    A partire da .NET 8.0, --version Major.Minor.Patch si riferisce a una versione principale.secondaria.patch specifica, incluse le versioni non elencate. Per ottenere invece la versione più recente di una determinata versione principale/secondaria, usare --version Major.Minor.*.

Esempi

  • dotnet tool update -g dotnetsay

    Aggiorna lo strumento globale dotnetsay.

  • dotnet tool update dotnetsay --tool-path c:\global-tools

    Aggiorna lo strumento globale dotnetsay che si trova in un archivio di Windows specifico.

  • dotnet tool update dotnetsay --tool-path ~/bin

    Aggiorna lo strumento globale dotnetsay in un archivio di Linux/macOS specifico.

  • dotnet tool update dotnetsay

    Aggiorna lo strumento locale dotnetsay installato per l’archivio attuale.

  • dotnet tool update -g dotnetsay --version 2.0.*

    Aggiorna lo strumento globale dotnetsay alla versione patch più recente, con una versione principale di 2 e una versione secondaria di 0.

  • dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)

    Aggiorna lo strumento globale dotnetsay alla versione più bassa all'interno dell'intervallo (> 2.0.0 && < 2.1.4) specificato, verrà installata la versione 2.1.0. Per ulteriori informazioni sugli intervalli di controllo dei versionamenti semantici, consultare Intervalli di versioni dei pacchetti NuGet.

Vedi anche