Aggiornare o rimuovere dotnetup

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

Per aggiornare direttamente il file eseguibile dotnetup autonomo, eseguire:

dotnetup self update

Questo comando è disponibile nelle build di anteprima dotnetup 0.3.0. Seleziona il canale di rilascio dall'etichetta della versione installata. Le build giornaliere ufficiali usano anche l'etichetta preview , quindi specificare il canale in modo esplicito per rimanere sulle build giornaliere:

dotnetup self update --channel daily

Per tornare da una build giornaliera più recente all'anteprima pubblica più recente, eseguire:

dotnetup self update --channel preview --force

--force può effettuare il downgrade o reinstallare l'eseguibile. Per le opzioni e le restrizioni dei comandi, vedere dotnetup self update.

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

Aggiornare una versione precedente o ripristinare l'eseguibile

Se la versione non riconosce self updateo l'eseguibile non viene più avviato, eseguire di nuovo lo script di download. Lo script sostituisce l'eseguibile esistente nella directory di installazione selezionata.

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"

Configurare le notifiche di aggiornamento

Dopo aver completato l'installazione interattiva e i comandi di aggiornamento, dotnetup può notificare che è disponibile una build più recente. La notifica non installa l'aggiornamento.

Per disabilitare le notifiche, eseguire:

dotnetup self update --update-notifications false

Per abilitare di nuovo le notifiche, usare --update-notifications true. Per informazioni sulla frequenza di controllo e sul comportamento di output, vedere Notifiche di aggiornamento.

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.

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

• Funzionamento di dotnetup
• Configurazione dell'ambiente dotnetup
• Guida introduttiva a dotnetup