Dotnetup bijwerken of verwijderen

In dit artikel wordt beschreven hoe u het dotnetup hulpprogramma zelf beheert. Zie dotnetup om de .NET SDK's en runtimes die beheert, bij te werken of te verwijderen.

De dotnetup-versie controleren

Toon de versie van dotnetup:

dotnetup --version

Als u ook de commit, architectuur, runtime-id en de geverifieerde installaties wilt weergeven, voert u het volgende uit:

dotnetup --info

Dotnetup bijwerken

Als u het zelfstandige dotnetup-uitvoerbare bestand wilt bijwerken, voert u het volgende uit:

dotnetup self update

Deze opdracht is beschikbaar in dotnetup 0.3.0 preview-versies. Het releasekanaal wordt geselecteerd op basis van het geïnstalleerde versielabel. Officiële dagelijkse builds gebruiken ook het preview label, dus geef het kanaal expliciet op om daily builds te blijven gebruiken:

dotnetup self update --channel daily

Als u wilt terugkeren van een nieuwere dagelijkse build naar de nieuwste openbare preview, voert u het volgende uit:

dotnetup self update --channel preview --force

--force kan het uitvoerbare bestand downgraden of opnieuw installeren. Zie dotnetup self update voor opdrachtparameters en beperkingen.

Een update van dotnetup wijzigt uw .NET-installaties, uw omgevingsconfiguratie en uw bijgehouden installatiespecificaties niet.

Een oudere versie bijwerken of het uitvoerbare bestand herstellen

Als uw versie self update niet herkent, of het uitvoerbare bestand niet meer start, voert u het downloadscript opnieuw uit. Het script vervangt het bestaande uitvoerbare bestand in de geselecteerde installatiemap.

Voer in macOS of Linux het volgende uit:

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

Voer op Windows het volgende uit:

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

Het script installeert standaard de nieuwste preview build. Als u de daily build of een aangepaste installatiemap gebruikt, geeft u dezelfde opties door die u voor de eerste installatie hebt gebruikt. Bijvoorbeeld in macOS of 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"

Updatemeldingen configureren

Nadat de interactieve installatie- en updateopdrachten zijn geslaagd, kan dotnetup u op de hoogte stellen dat er een nieuwere build beschikbaar is. Met de melding wordt de update niet geïnstalleerd.

Als u meldingen wilt uitschakelen, voert u het volgende uit:

dotnetup self update --update-notifications false

Als u meldingen opnieuw wilt inschakelen, gebruikt u --update-notifications true. Zie Updatemeldingen voor de controlefrequentie en het uitvoergedrag.

Dotnetup verwijderen

Om dotnetup en alles wat het beheert te verwijderen, voert u deze stappen in volgorde uit.

1. Zoek uw installatiemappen

Vermeld de installatiewortels die dotnetup bijhoudt:

dotnetup list

Noteer elke installatiehoofdmap die zich niet in de dotnetup-gegevensmap bevindt. U verwijdert deze mappen in een latere stap.

2. Verwijder de omgevingsconfiguratie

Verwijder de PATH en DOTNET_ROOT wijzigingen die dotnetup heeft aangebracht:

dotnetup env clear

Voer deze opdracht uit in de modus shell vanuit de shell waarvan het profiel dotnetup is gewijzigd, of selecteer die shell met de optie --shell. In de modus everywhere op Windows wordt met deze opdracht het systeem PATH gewijzigd en zijn verhoogde rechten vereist.

Met deze opdracht worden SDK's of runtimes niet verwijderd. Zie Omgevingsconfiguratie verwijderen voor meer informatie.

3. Verwijder de installatiewortels en gegevensmap

Verwijder elke installatiehoofdmap die u in stap 1 hebt vastgelegd.

Verwijder vervolgens de dotnetup-gegevensmap. Deze map bevat de standaardinstallatiehoofdmap, het manifest, het configuratiebestand en de downloadcache.

Als u de DOTNET_DOTNETUP_DATA_DIR omgevingsvariabele instelt, verwijdert u in plaats daarvan die directory en verwijdert u vervolgens de variabele.

4. Verwijder het uitvoerbare dotnetup-bestand

Verwijder de map die het dotnetup uitvoerbare bestand bevat. Standaard installeert het downloadscript dotnetup in ~/.dotnetup. Als u deze map handmatig aan PATH hebt toegevoegd, verwijdert u die vermelding uit uw shell-profiel of uit uw gebruikersomgevingsvariabelen.

Open een nieuwe terminal om de bijgewerkte omgeving te gebruiken.

Zie ook

• Hoe dotnetup werkt
• configuratie van de dotnetup-omgeving
• Aan de slag met dotnetup