Delen via

.NET-hulpprogramma voor verwijderen

  • Artikel

Met het .NET-verwijderprogramma (dotnet-core-uninstall) kunt u .NET SDK's en runtimes uit een systeem verwijderen. Er is een verzameling opties beschikbaar om op te geven welke versies u wilt verwijderen.

Het hulpprogramma ondersteunt Windows en macOS. Linux wordt momenteel niet ondersteund.

In Windows kan het hulpprogramma alleen SDK's en runtimes verwijderen die zijn geïnstalleerd met behulp van een van de volgende installatieprogramma's:

  • Het .NET SDK- en runtime-installatieprogramma.
  • Het Visual Studio-installatieprogramma in versies ouder dan Visual Studio 2019 versie 16.3.

In macOS kan het hulpprogramma alleen SDK's en runtimes verwijderen die zich in de map /usr/local/share/dotnet bevinden.

Vanwege deze beperkingen kan het hulpprogramma mogelijk niet alle .NET SDK's en runtimes op uw computer verwijderen. U kunt de dotnet --info opdracht gebruiken om alle .NET SDK's en runtimes te vinden die zijn geïnstalleerd, inclusief die SDK's en runtimes die het hulpprogramma niet kan verwijderen. Met dotnet-core-uninstall list de opdracht wordt weergegeven welke SDK's kunnen worden verwijderd met het hulpprogramma.

Het hulpprogramma installeren

U kunt het hulpprogramma voor het verwijderen van .NET downloaden vanaf de releasepagina van het hulpprogramma en de broncode vinden in de GitHub-opslagplaats dotnet/cli-lab .

Notitie

Het hulpprogramma vereist uitbreiding om .NET SDK's en runtimes te verwijderen. Daarom moet deze worden geïnstalleerd in een map met schrijfbeveiliging, zoals C:\Program Files in Windows of /usr/local/bin in macOS. Zie de uitgebreide toegang voor dotnet-opdrachten en de gedetailleerde installatie-instructies voor meer informatie.

Voer het hulpprogramma uit

In de volgende stappen ziet u de aanbevolen methode voor het uitvoeren van het verwijderingsprogramma:

Stap 1: geïnstalleerde .NET SDK's en runtimes weergeven

De dotnet-core-uninstall list opdracht bevat de geïnstalleerde .NET SDK's en runtimes die met dit hulpprogramma kunnen worden verwijderd. Sommige SDK's en runtimes zijn mogelijk vereist voor Visual Studio en worden weergegeven met een opmerking waarom het niet wordt aanbevolen om ze te verwijderen.

Notitie

De uitvoer van de dotnet-core-uninstall list opdracht komt niet overeen met de lijst met geïnstalleerde versies in de uitvoer van dotnet --info in de meeste gevallen. Met dit hulpprogramma worden niet versies weergegeven die zijn geïnstalleerd door zip-bestanden of beheerd door Visual Studio (een versie die is geïnstalleerd met Visual Studio 2019 versie 16.3 of hoger). Een manier om te controleren of een versie wordt beheerd door Visual Studio, is door deze te bekijken, Add or Remove Programswaarbij beheerde versies van Visual Studio als zodanig worden gemarkeerd in hun weergavenamen.

Zie de lijstopdracht verderop in dit artikel voor meer informatie.

Stap 2: Een droogloop uitvoeren

De dotnet-core-uninstall dry-run en dotnet-core-uninstall whatif opdrachten geven de .NET SDK's en runtimes weer die worden verwijderd op basis van de beschikbare opties zonder de verwijdering uit te voeren. Deze opdrachten zijn synoniemen.

Zie en whatif opdrachten verderop in dit artikel voor meer informatie.dry-run

Stap 3: .NET SDK's en runtimes verwijderen

dotnet-core-uninstall remove verwijdert .NET SDK's en runtimes die zijn opgegeven door een verzameling opties.

Omdat dit hulpprogramma een destructief gedrag heeft, wordt het ten zeerste aanbevolen om een drooguitvoering uit te voeren voordat u de verwijderopdracht uitvoert. Tijdens de drooguitvoering ziet u welke .NET SDK's en runtimes worden verwijderd wanneer u de remove opdracht gebruikt. Raadpleeg Moet ik een versie verwijderen? als u wilt weten welke SDK's en runtimes veilig kunnen worden verwijderd.

Let op

Houd rekening met de volgende opmerkingen:

  • Met dit hulpprogramma kunt u versies van de .NET SDK verwijderen die vereist zijn voor global.json bestanden op uw computer. U kunt .NET SDK's opnieuw installeren via de pagina .NET downloaden.
  • Met dit hulpprogramma kunt u versies van de .NET Runtime verwijderen die vereist zijn voor frameworkafhankelijke toepassingen op uw computer. U kunt .NET Runtimes opnieuw installeren via de pagina .NET downloaden.
  • Met dit hulpprogramma kunt u versies van de .NET SDK en runtime verwijderen waarvan Visual Studio afhankelijk is. Als u de installatie van Visual Studio onderbreekt, voert u 'Herstellen' uit in het installatieprogramma van Visual Studio om terug te gaan naar een werkende status.

Standaard behouden alle opdrachten de .NET SDK's en runtimes die mogelijk vereist zijn voor Visual Studio of andere SDK's. Deze SDK's en runtimes kunnen worden verwijderd door ze expliciet als argumenten weer te geven of door de --force optie te gebruiken.

Het hulpprogramma vereist uitbreiding om .NET SDK's en runtimes te verwijderen. Voer het hulpprogramma uit in een Beheer istrator-opdrachtprompt in Windows en met sudo macOS. Voor de dry-run en whatif opdrachten is geen benodigde bevoegdheden vereist.

Zie de opdracht Remove verderop in dit artikel voor meer informatie.

Stap 4: De NuGet-terugvalmap verwijderen (optioneel)

In sommige gevallen hebt u het NuGetFallbackFolder niet meer nodig en wilt u deze mogelijk verwijderen. Zie NuGetFallbackFolder verwijderen voor meer informatie.

Het hulpprogramma verwijderen

  1. Open Programma's toevoegen of verwijderen.
  2. Zoek naar Microsoft .NET SDK Uninstall Tool.
  3. Selecteer Verwijderen.

list opdracht

Samenvatting

dotnet-core-uninstall list [options]

Opties

  • --aspnet-runtime

    Een lijst met alle ASP.NET runtimes die met dit hulpprogramma kunnen worden verwijderd.

  • --hosting-bundle

    Een lijst met alle .NET-hostingbundels die met dit hulpprogramma kunnen worden verwijderd.

  • --runtime

    Een lijst met alle .NET-runtimes die met dit hulpprogramma kunnen worden verwijderd.

  • --sdk

    Bevat alle .NET SDK's die met dit hulpprogramma kunnen worden verwijderd.

  • -v, --verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau in. Toegestane waarden zijnq[uiet], , , n[ormal]en diag[nostic]d[etailed]m[inimal]. De standaardwaarde is normal.

  • --x64

    Een lijst met alle x64 .NET SDK's en runtimes die met dit hulpprogramma kunnen worden verwijderd.

  • --x86

    Een lijst met alle x86 .NET SDK's en runtimes die met dit hulpprogramma kunnen worden verwijderd.

Voorbeelden

  • Vermeld alle .NET SDK's en runtimes die met dit hulpprogramma kunnen worden verwijderd:

    dotnet-core-uninstall list

  • Geef alle x64 .NET SDK's en runtimes weer:

    dotnet-core-uninstall list --x64

  • Geef alle x86 .NET SDK's weer:

    dotnet-core-uninstall list --sdk --x86

dry-run en whatif opdrachten

Samenvatting

dotnet-core-uninstall dry-run [options] [<VERSION>...]

dotnet-core-uninstall whatif [options] [<VERSION>...]

Argumenten

VERSION

De opgegeven versie die moet worden verwijderd. U kunt meerdere versies één na de andere weergeven, gescheiden door spaties. Antwoordbestanden worden ook ondersteund.

Tip

Antwoordbestanden zijn een alternatief voor het plaatsen van alle versies op de opdrachtregel. Dit zijn tekstbestanden, meestal met een *.rsp-extensie en elke versie wordt op een afzonderlijke regel weergegeven. Als u een antwoordbestand voor het VERSION argument wilt opgeven, gebruikt u het @-teken direct gevolgd door de naam van het antwoordbestand.

Opties

  • --all

    Hiermee verwijdert u alle .NET SDK's en runtimes.

  • --all-below <VERSION>[ <VERSION>...]

    Hiermee verwijdert u alleen de .NET SDK's en runtimes met een versie die kleiner is dan de opgegeven versie. De opgegeven versie blijft geïnstalleerd.

  • --all-but <VERSIONS>[ <VERSION>...]

    Hiermee verwijdert u alle .NET SDK's en runtimes, met uitzondering van de opgegeven versies.

  • --all-but-latest

    Hiermee verwijdert u de .NET SDK's en runtimes, met uitzondering van de hoogste versie.

  • --all-lower-patches

    Verwijdert de .NET SDK's en runtimes die worden vervangen door hogere patches. Met deze optie wordt global.json bestand beveiligd.

  • --all-previews

    Hiermee verwijdert u de .NET SDK's en runtimes die zijn gemarkeerd als previews.

  • --all-previews-but-latest

    Hiermee verwijdert u de .NET SDK's en runtimes die zijn gemarkeerd als previews, behalve de hoogste preview.

  • --aspnet-runtime

    Hiermee verwijdert u alleen de ASP.NET runtimes.

  • --hosting-bundle

    Hiermee verwijdert u alleen de .NET-runtime en hostingbundels.

  • --major-minor <MAJOR_MINOR>

    Hiermee verwijdert u de .NET SDK's en runtimes die overeenkomen met de opgegeven major.minor versie.

  • --runtime

    Hiermee verwijdert u alleen de .NET-runtimes.

  • --sdk

    Hiermee verwijdert u alleen de .NET SDK's.

  • -v, --verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau in. Toegestane waarden zijnq[uiet], , , n[ormal]en diag[nostic]d[etailed]m[inimal]. De standaardwaarde is normal.

  • --x64

    Moet worden gebruikt met --sdk, --runtimeen --aspnet-runtime om x64 SDK's of runtimes te verwijderen.

  • --x86

    Moet worden gebruikt met --sdk, --runtimeen --aspnet-runtime om x86 SDK's of runtimes te verwijderen.

  • --force

    Dwingt het verwijderen van versies af die mogelijk worden gebruikt door Visual Studio.

Notitie

  • Precies één van --sdk, --runtimeen --aspnet-runtime--hosting-bundle is vereist.
  • --all, , --all-but, --all-but-latest--all-below, , --all-lower-patches, , --all-previews, , --all-previews-but-latest, , en --major-minor[<VERSION>...] zijn exclusief.
  • Als --x64 of --x86 niet is opgegeven, worden zowel x64 als x86 verwijderd.

Voorbeelden

Notitie

.NET SDK's en runtimes die mogelijk vereist zijn voor Visual Studio of andere SDK's, worden standaard niet opgenomen in de dotnet-core-uninstall dry-run uitvoer. In de volgende voorbeelden, afhankelijk van de status van de machine, zijn sommige van de opgegeven SDK's en runtimes mogelijk niet opgenomen in de uitvoer. Als u alle SDK's en runtimes wilt opnemen, vermeldt u deze expliciet als argumenten of gebruikt u de --force optie.

  • Droge uitvoering van het verwijderen van alle .NET-runtimes die zijn vervangen door hogere patches:

    dotnet-core-uninstall dry-run --all-lower-patches --runtime

  • Droge uitvoering van het verwijderen van alle .NET SDK's onder de versie 2.2.301:

    dotnet-core-uninstall whatif --all-below 2.2.301 --sdk

remove opdracht

Samenvatting

dotnet-core-uninstall remove [options] [<VERSION>...]

Argumenten

VERSION

De opgegeven versie die moet worden verwijderd. U kunt meerdere versies een na de andere weergeven, gescheiden door spaties. Antwoordbestanden worden ook ondersteund.

Tip

Antwoordbestanden zijn een alternatief voor het plaatsen van alle versies op de opdrachtregel. Dit zijn tekstbestanden, meestal met een *.rsp-extensie en elke versie wordt op een afzonderlijke regel weergegeven. Als u een antwoordbestand voor het VERSION argument wilt opgeven, gebruikt u het @-teken direct gevolgd door de naam van het antwoordbestand.

Opties

  • --all

    Hiermee verwijdert u alle .NET SDK's en runtimes.

  • --all-below <VERSION>[ <VERSION>...]

    Hiermee verwijdert u alleen de .NET SDK's en runtimes met een versie die kleiner is dan de opgegeven versie. De opgegeven versie blijft geïnstalleerd.

  • --all-but <VERSIONS>[ <VERSION>...]

    Hiermee verwijdert u alle .NET SDK's en runtimes, met uitzondering van de opgegeven versies.

  • --all-but-latest

    Hiermee verwijdert u de .NET SDK's en runtimes, met uitzondering van de hoogste versie.

  • --all-lower-patches

    Verwijdert de .NET SDK's en runtimes die worden vervangen door hogere patches. Met deze optie wordt global.json bestand beveiligd.

  • --all-previews

    Hiermee verwijdert u de .NET SDK's en runtimes die zijn gemarkeerd als previews.

  • --all-previews-but-latest

    Hiermee verwijdert u de .NET SDK's en runtimes die zijn gemarkeerd als previews, behalve de hoogste preview.

  • --aspnet-runtime

    Hiermee verwijdert u alleen de ASP.NET runtimes.

  • --hosting-bundle

    Hiermee verwijdert u alleen de .NET-hostingbundels.

  • --major-minor <MAJOR_MINOR>

    Hiermee verwijdert u de .NET SDK's en runtimes die overeenkomen met de opgegeven major.minor versie.

  • --runtime

    Hiermee verwijdert u alleen de .NET-runtimes.

  • --sdk

    Hiermee verwijdert u alleen de .NET SDK's.

  • -v, --verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau in. Toegestane waarden zijnq[uiet], , , n[ormal]en diag[nostic]d[etailed]m[inimal]. De standaardwaarde is normal.

  • --x64

    Moet worden gebruikt met --sdk, --runtimeen --aspnet-runtime om x64 SDK's of runtimes te verwijderen.

  • --x86

    Moet worden gebruikt met --sdk, --runtimeen --aspnet-runtime om x86 SDK's of runtimes te verwijderen.

  • -y, --yes

    Hiermee voert u de opdracht uit zonder een ja of geen bevestiging te vereisen.

  • --force

    Dwingt het verwijderen van versies af die mogelijk worden gebruikt door Visual Studio.

Notitie

  • Precies één van --sdk, --runtimeen --aspnet-runtime--hosting-bundle is vereist.
  • --all, , --all-but, --all-but-latest--all-below, , --all-lower-patches, , --all-previews, , --all-previews-but-latest, , en --major-minor[<VERSION>...] zijn exclusief.
  • Als --x64 of --x86 niet is opgegeven, worden zowel x64 als x86 verwijderd.

Voorbeelden

Notitie

Standaard worden .NET SDK's en runtimes die mogelijk vereist zijn voor Visual Studio of andere SDK's bewaard. In de volgende voorbeelden, afhankelijk van de status van de machine, kunnen sommige van de opgegeven SDK's en runtimes behouden blijven. Als u alle SDK's en runtimes wilt verwijderen, vermeldt u deze expliciet als argumenten of gebruikt u de --force optie.

  • Verwijder alle .NET-runtimes behalve de versie 3.0.0-preview6-27804-01 zonder ja of geen bevestiging:

    dotnet-core-uninstall remove --all-but 3.0.0-preview6-27804-01 --runtime --yes

  • Verwijder alle .NET Core 1.1 SDK's zonder dat u ja of geen bevestiging nodig hebt:

    dotnet-core-uninstall remove --sdk --major-minor 1.1 -y

  • Verwijder de .NET Core 1.1.11 SDK zonder console-uitvoer:

    dotnet-core-uninstall remove 1.1.11 --sdk --yes --verbosity q

  • Verwijder alle .NET SDK's die veilig kunnen worden verwijderd door dit hulpprogramma:

    dotnet-core-uninstall remove --all --sdk

  • Verwijder alle .NET SDK's die door dit hulpprogramma kunnen worden verwijderd, inclusief de SDK's die mogelijk vereist zijn voor Visual Studio (niet aanbevolen):

    dotnet-core-uninstall remove --all --sdk --force

  • Verwijder alle .NET SDK's die zijn opgegeven in het antwoordbestand versions.rsp :

    dotnet-core-uninstall remove --sdk @versions.rsp

    De inhoud van het bestand versions.rsp is als volgt:

    2.2.300
2.1.700