Aggiornare o rimuovere dotnetup

Note

dotnetup è disponibile in anteprima pubblica. Le funzionalità e il comportamento potrebbero cambiare prima della disponibilità generale.

Questo articolo descrive come gestire lo strumento dotnetup stesso. Per aggiornare o rimuovere gli SDK e i runtime di .NET che dotnetup gestisce, vedere Aggiornare le installazioni.

Controllare la versione dotnetup

Visualizzare la versione di dotnetup:

dotnetup --version

Per visualizzare anche il commit, l'architettura, l'identificatore di runtime e le installazioni verificate, eseguire:

dotnetup --info

Aggiorna dotnetup

dotnetup non dispone di un comando per aggiornarsi. Per aggiornare dotnetup, eseguire di nuovo lo script di download. Lo script sostituisce l'eseguibile esistente dotnetup nella directory di installazione.

In macOS o Linux eseguire:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

In Windows eseguire:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

Lo script installa la build più recente preview per impostazione predefinita. Se si usa la daily compilazione o una directory di installazione personalizzata, passare le stesse opzioni usate per la prima installazione. Ad esempio, in macOS o Linux:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily --install-dir /opt/dotnetup

In Windows:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily -InstallDir C:\tools\dotnetup"

Un aggiornamento di dotnetup non modifica le installazioni, la configurazione dell'ambiente o le specifiche di installazione monitorate.

Rimuovere dotnetup

Per rimuovere dotnetup e tutto ciò che gestisce, completare questi passaggi nell'ordine.

1. Trovare le directory radice di installazione

Elencare le radici di installazione di cui dotnetup tiene traccia:

dotnetup list

Registrare ogni directory radice di installazione che non si trova nella directory dei dati dotnetup. Elimini queste cartelle in un passaggio successivo.

2. Rimuovere la configurazione dell'ambiente

Rimuovere le modifiche PATH e DOTNET_ROOT apportate da dotnetup:

dotnetup env clear

In shell modalità eseguire questo comando dalla shell il cui profilo dotnetup è stato modificato oppure selezionare tale shell con l'opzione --shell . In modalità everywhere in Windows, questo comando modifica PATH del sistema e richiede l'elevazione dei privilegi.

Questo comando non rimuove SDK o runtime. Per altre informazioni, vedere Rimuovere la configurazione dell'ambiente.

3. Eliminare le directory radice di installazione e la directory dei dati

Eliminare ogni radice di installazione registrata nel passaggio 1.

Eliminare quindi la directory dei dati dotnetup. Questa directory contiene la radice di installazione predefinita, il manifest, il file di configurazione e la cache di download.

Sistema operativo Directory dei dati predefinita
Windows %LOCALAPPDATA%\dotnetup
macOS ~/Library/Application Support/dotnetup
Linux $XDG_DATA_HOME/dotnetupo ~/.local/share/dotnetup quando XDG_DATA_HOME non è impostato

Se si imposta la DOTNET_DOTNETUP_DATA_DIR variabile di ambiente, eliminare invece quella directory e quindi rimuovere la variabile.

4. Eliminare l'eseguibile dotnetup

Eliminare la directory contenente l'eseguibile dotnetup . Per impostazione predefinita, lo script di download installa dotnetup in ~/.dotnetup. Se hai aggiunto manualmente questa directory a PATH, rimuovi tale voce dal profilo della shell o dalle variabili di ambiente utente.

Aprire un nuovo terminale per usare l'ambiente aggiornato.

Vedere anche