Aggiornare le installazioni .NET rilevate con dotnetup

Note

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

dotnetup archivia il canale richiesto separatamente dalla versione risolta. Un aggiornamento risolve nuovamente ogni canale rolling.

Questi aggiornamenti non aggiornano l'eseguibile dotnetup. Per aggiornare lo strumento stesso, usare dotnetup self update.

Scegliere un ambito di aggiornamento

Usare uno di questi comandi:

# Update all tracked SDK and runtime requirements.
dotnetup update

# Update SDK requirements only.
dotnetup sdk update

# Update SDK and runtime requirements.
dotnetup sdk update --all

# Update runtime requirements only.
dotnetup runtime update

Gli aggiornamenti di runtime includono i runtime di base .NET e ASP.NET Core. In Windows, includono anche i requisiti di runtime di Windows Desktop.

Limitare la radice di installazione

Per impostazione predefinita, un aggiornamento può elaborare i requisiti per tutte le radici nel manifesto selezionato. Usare --install-path per limitare l'operazione:

dotnetup update --install-path D:\tools\dotnet

Aggiornare i file del repository

I requisiti dell'SDK possono usare global.json come origine. Per scrivere nuovamente la versione dell'SDK appena risolta in ogni file di origine, eseguire:

dotnetup sdk update --update-global-json

Senza questa opzione, dotnetup installa l'aggiornamento, ma non modifica il file del repository.

Un aggiornamento elabora i requisiti archiviati prima che Garbage Collection aggiorni le origini modificate global.json. Dopo aver modificato di un repository global.json, eseguire dotnetup sdk install da tale repository prima di aggiornarne i requisiti archiviati. In caso contrario, il primo aggiornamento potrebbe comunque elaborare il requisito precedente.

Comprendere il comportamento degli aggiornamenti

  • Le versioni esatte dell'SDK e del runtime vengono ignorate: sono state richieste in modo esplicito, quindi non possono mai essere aggiornate.
  • Ogni requisito di installazione viene elaborato in modo indipendente.
  • L'elaborazione di tutti i requisiti di installazione continua dopo il fallimento di un singolo requisito.
  • Il comando segnala un errore dopo l'elaborazione di tutti i requisiti di installazione rimanenti.
  • Gli aggiornamenti riusciti eseguono Garbage Collection: un processo di pulizia che rimuove tutti i componenti installati che in realtà non sono necessari per alcuno dei requisiti di installazione configurati.
  • Una versione installata rimane se è ancora necessario un altro requisito.

Esaminare il risultato

Verificare lo stato monitorato e le installazioni su disco:

dotnetup list

Per l'output interpretabile dalla macchina:

dotnetup list --format json

Rimuovere un requisito tracciato

Per rimuovere un requisito dell'SDK, passare il canale archiviato o la versione esatta:

dotnetup sdk uninstall 10.0.1xx

Disinstalla rimuove la dipendenza, quindi pulisce le installazioni senza riferimenti nella radice selezionata. Avvisa se un altro requisito impedisce l'installazione richiesta o se la pulizia rimuove installazioni aggiuntive. Esaminare questi avvisi prima di confermare l'operazione. In automazione non interattiva, usare --non-interactive per ignorare la conferma, non gli avvisi.

Per i requisiti di runtime, usare dotnetup runtime uninstall. Per informazioni dettagliate, vedere Disinstallazione dell'SDK e Disinstallazione del runtime.

Vedere anche

  • Ultimo aggiornamento: