Werk bijgehouden .NET-installaties bij met dotnetup

Note

dotnetup is beschikbaar als openbare preview. De functies en het gedrag kunnen veranderen vóór algemene beschikbaarheid.

dotnetup slaat het aangevraagde kanaal afzonderlijk op van de geresolveerde versie. Met een update wordt elk rolling-channel opnieuw opgelost.

Deze updates werken het uitvoerbare bestand dotnetup niet bij. Als u het hulpprogramma zelf wilt bijwerken, gebruikt u dotnetup self update.

Een updatebereik kiezen

Gebruik een van deze opdrachten:

# 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

Runtime-updates omvatten de kern-.NET en ASP.NET Core runtimes. Op Windows bevatten ze ook Windows Desktop-runtimevereisten.

De installatiehoofdmap beperken

Standaard kan een update vereisten verwerken voor alle roots in het geselecteerde manifest. Gebruik --install-path om de bewerking te beperken:

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

Repositorybestanden bijwerken

SDK-vereisten kunnen global.json als bron gebruiken. Als u de zojuist opgeloste SDK-versie terug wilt schrijven naar elk bronbestand, voert u het volgende uit:

dotnetup sdk update --update-global-json

Zonder deze optie installeert dotnetup de update, maar bewerkt het repositorybestand niet.

Een update verwerkt opgeslagen afhankelijkheden voordat garbagecollection gewijzigde global.json bronnen vernieuwt. Nadat u de global.json van een opslagplaats hebt gewijzigd, voert u dotnetup sdk install uit vanuit die opslagplaats voordat u de opgeslagen vereisten bijwerkt. Anders wordt bij de eerste update mogelijk nog steeds de vorige eis afgehandeld.

Begrijp updategedrag

  • Exacte SDK- en runtimeversies worden overgeslagen. Ze zijn expliciet aangevraagd, dus kunnen nooit worden bijgewerkt.
  • Elke installatievereiste wordt onafhankelijk verwerkt.
  • De verwerking van alle installatievereisten wordt voortgezet na een afzonderlijke fout.
  • Het commando rapporteert een fout nadat alle resterende installatievereisten zijn verwerkt.
  • Geslaagde updates voeren garbagecollection uit: een opschoonproces waarmee geïnstalleerde onderdelen worden verwijderd die geen van uw geconfigureerde installatievereisten daadwerkelijk nodig hebben.
  • Een geïnstalleerde versie blijft aanwezig als een andere vereiste deze nog nodig heeft.

Het resultaat controleren

Controleer de bijgehouden toestand en installaties op schijf:

dotnetup list

Voor machineleesbare uitvoer:

dotnetup list --format json

Een getraceerde vereiste verwijderen

Als u een SDK-vereiste wilt verwijderen, geeft u het opgeslagen kanaal of de exacte versie door:

dotnetup sdk uninstall 10.0.1xx

Verwijderen verwijdert de vereiste en schoont vervolgens installaties waarnaar niet wordt verwezen op in de geselecteerde root. Er wordt een waarschuwing gegeven als een andere vereiste de gevraagde installatie tegenhoudt of als opschonen extra installaties verwijdert. Bekijk deze waarschuwingen voordat u de bewerking bevestigt. Gebruik in niet-interactieve automatisering --non-interactive om bevestiging over te slaan, niet de waarschuwingen.

Gebruik voor runtimevereisten dotnetup runtime uninstall. Zie SDK verwijderen en runtime verwijderen voor meer informatie.

Zie ook

  • Laatst bijgewerkt om