Narzędzie do odinstalowania platformy .NET

  • Artykuł

Narzędzie odinstalowywania platformy .NET (dotnet-core-uninstall) umożliwia usunięcie zestawów SDK i środowisk uruchomieniowych platformy .NET z systemu. Dostępna jest kolekcja opcji, aby określić, które wersje chcesz odinstalować.

Narzędzie obsługuje systemy Windows i macOS. System Linux nie jest obecnie obsługiwany.

W systemie Windows narzędzie może odinstalować tylko zestawy SDK i środowiska uruchomieniowe zainstalowane przy użyciu jednego z następujących instalatorów:

  • Instalator zestawu .NET SDK i środowiska uruchomieniowego.
  • Instalator programu Visual Studio w wersjach starszych niż Visual Studio 2019 w wersji 16.3.

W systemie macOS narzędzie może odinstalować tylko zestawy SDK i środowiska uruchomieniowe znajdujące się w folderze /usr/local/share/dotnet .

Ze względu na te ograniczenia narzędzie może nie być w stanie odinstalować wszystkich zestawów SDK i środowisk uruchomieniowych platformy .NET na maszynie. Możesz użyć dotnet --info polecenia , aby znaleźć wszystkie zainstalowane zestawy .NET SDK i środowiska uruchomieniowe, w tym te zestawy SDK i środowiska uruchomieniowe, których narzędzie nie może usunąć. Polecenie dotnet-core-uninstall list wyświetla zestawy SDK, które można odinstalować za pomocą narzędzia.

Uwaga

Obecnie narzędzie odinstalowywania platformy .NET nie obsługuje programu .NET 8+. Aby uzyskać więcej informacji na temat harmonogramu wydania narzędzia, zobacz GitHub — dotnet-uninstall-tool Roadmap (Harmonogram działania narzędzia dotnet-uninstall-tool).

Instalowanie narzędzia

Narzędzie do dezinstalacji platformy .NET można pobrać ze strony wydań narzędzia i znaleźć kod źródłowy w repozytorium github dotnet/cli-lab .

Uwaga

Narzędzie wymaga podniesienia uprawnień w celu odinstalowania zestawów SDK i środowisk uruchomieniowych platformy .NET. W związku z tym należy go zainstalować w katalogu chronionym zapisem, takim jak C:\Program Files w systemie Windows lub /usr/local/bin w systemie macOS. Aby uzyskać więcej informacji, zobacz polecenia dotnet z podwyższonym poziomem uprawnień i szczegółowe instrukcje instalacji.

Uruchom narzędzie

W poniższych krokach przedstawiono zalecane podejście do uruchamiania narzędzia do odinstalowywania:

Krok 1. Wyświetlanie zainstalowanych zestawów SDK i środowisk uruchomieniowych platformy .NET

Polecenie dotnet-core-uninstall list wyświetla listę zainstalowanych zestawów SDK platformy .NET i środowisk uruchomieniowych, które można usunąć za pomocą tego narzędzia. Niektóre zestawy SDK i środowiska uruchomieniowe mogą być wymagane przez program Visual Studio i są wyświetlane z uwagą, dlaczego nie zaleca się ich odinstalowania.

Uwaga

Dane wyjściowe dotnet-core-uninstall list polecenia nie będą zgodne z listą zainstalowanych wersji w danych wyjściowych dotnet --info w większości przypadków. W szczególności to narzędzie nie będzie wyświetlać wersji zainstalowanych przez pliki zip ani zarządzane przez program Visual Studio (dowolna wersja zainstalowana w programie Visual Studio 2019 w wersji 16.3 lub nowszej). Jednym ze sposobów sprawdzenia, czy wersja jest zarządzana przez program Visual Studio, jest wyświetlenie jej w Add or Remove Programsprogramie , gdzie zarządzane wersje programu Visual Studio są oznaczone jako takie w nazwach wyświetlanych.

Aby uzyskać więcej informacji, zobacz polecenie list w dalszej części tego artykułu.

Krok 2. Wykonywanie suchego przebiegu

Polecenia dotnet-core-uninstall dry-run i dotnet-core-uninstall whatif wyświetlają zestawy SDK i środowiska uruchomieniowe platformy .NET, które zostaną usunięte na podstawie dostępnych opcji bez przeprowadzania odinstalowywania. Te polecenia są synonimami.

Aby uzyskać więcej informacji, zobacz dry-run polecenia i whatif w dalszej części tego artykułu.

Krok 3. Odinstalowywanie zestawów SDK i środowisk uruchomieniowych platformy .NET

dotnet-core-uninstall remove odinstalowuje zestawy SDK platformy .NET i środowiska uruchomieniowe określone przez kolekcję opcji.

Ponieważ to narzędzie ma destrukcyjne zachowanie, zdecydowanie zaleca się przeprowadzenie suchego uruchomienia przed uruchomieniem polecenia remove. Przebieg suchy pokaże, jakie zestawy SDK platformy .NET i środowiska uruchomieniowe zostaną usunięte podczas korzystania z remove polecenia . Zapoznaj się z tematem Czy należy usunąć wersję? aby dowiedzieć się, które zestawy SDK i środowiska uruchomieniowe są bezpieczne do usunięcia.

Uwaga

Należy pamiętać o następujących zastrzeżeniach:

  • To narzędzie może odinstalować wersje zestawu .NET SDK, które są wymagane przez global.json pliki na maszynie. Zestawy SDK platformy .NET można ponownie zainstalować na stronie Pobieranie platformy .NET .
  • To narzędzie może odinstalować wersje środowiska uruchomieniowego platformy .NET, które są wymagane przez aplikacje zależne od platformy na maszynie. Środowiska uruchomieniowe platformy .NET można ponownie zainstalować na stronie Pobieranie platformy .NET .
  • To narzędzie może odinstalować wersje zestawu .NET SDK i środowiska uruchomieniowego, na których opiera się program Visual Studio. W przypadku przerwania instalacji programu Visual Studio uruchom polecenie "Napraw" w instalatorze programu Visual Studio, aby wrócić do stanu roboczego.

Domyślnie wszystkie polecenia przechowują zestawy SDK platformy .NET i środowiska uruchomieniowe, które mogą być wymagane przez program Visual Studio lub inne zestawy SDK. Te zestawy SDK i środowiska uruchomieniowe można odinstalować, wymieniając je jawnie jako argumenty lub używając --force opcji .

Narzędzie wymaga podniesienia uprawnień w celu odinstalowania zestawów SDK i środowisk uruchomieniowych platformy .NET. Uruchom narzędzie w wierszu polecenia Administracja istrator w systemie Windows i w sudo systemie macOS. Polecenia dry-run i whatif nie wymagają podniesienia uprawnień.

Aby uzyskać więcej informacji, zobacz usuwanie polecenia w dalszej części tego artykułu.

Krok 4. Usuwanie folderu rezerwowego NuGet (opcjonalnie)

W niektórych przypadkach nie potrzebujesz NuGetFallbackFolder już elementu i możesz go usunąć. Aby uzyskać więcej informacji, zobacz Usuwanie folderu NuGetFallbackFolder.

Odinstalowywanie narzędzia

  1. Otwórz pozycję Dodaj lub usuń programy.
  2. Wyszukaj ciąg Microsoft .NET SDK Uninstall Tool.
  3. Wybierz Odinstaluj.

list polecenie

Streszczenie

dotnet-core-uninstall list [options]

Opcje

  • --aspnet-runtime

    Wyświetla listę wszystkich środowisk uruchomieniowych ASP.NET, które można odinstalować za pomocą tego narzędzia.

  • --hosting-bundle

    Wyświetla listę wszystkich pakietów hostingowych platformy .NET, które można odinstalować za pomocą tego narzędzia.

  • --runtime

    Wyświetla listę wszystkich środowisk uruchomieniowych platformy .NET, które można odinstalować za pomocą tego narzędzia.

  • --sdk

    Wyświetla listę wszystkich zestawów SDK platformy .NET, które można odinstalować za pomocą tego narzędzia.

  • -v, --verbosity <LEVEL>

    Ustawia poziom szczegółowości. Dozwolone wartości to q[uiet], , n[ormal]m[inimal], d[etailed], i diag[nostic]. Domyślna wartość to normal.

  • --x64

    Wyświetla listę wszystkich zestawów SDK platformy .NET x64 i środowisk uruchomieniowych, które można odinstalować za pomocą tego narzędzia.

  • --x86

    Wyświetla listę wszystkich zestawów SDK platformy .NET x86 i środowisk uruchomieniowych, które można odinstalować za pomocą tego narzędzia.

Przykłady

  • Wyświetl listę wszystkich zestawów SDK platformy .NET i środowisk uruchomieniowych, które można usunąć za pomocą tego narzędzia:

    dotnet-core-uninstall list

  • Wyświetl listę wszystkich zestawów SDK i środowisk uruchomieniowych platformy .NET x64:

    dotnet-core-uninstall list --x64

  • Wyświetl listę wszystkich zestawów SDK platformy .NET x86:

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

dry-runpolecenia i whatif

Streszczenie

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

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

Argumenty

VERSION

Określona wersja do odinstalowania. Po drugiej można wyświetlić kilka wersji rozdzielonych spacjami. Obsługiwane są również pliki odpowiedzi.

Napiwek

Pliki odpowiedzi są alternatywą do umieszczania wszystkich wersji w wierszu polecenia. Są to pliki tekstowe, zazwyczaj z rozszerzeniem *.rsp , a każda wersja jest wyświetlana w osobnym wierszu. Aby określić plik odpowiedzi dla argumentu VERSION , użyj znaku @ natychmiast po nazwie pliku odpowiedzi.

Opcje

  • --all

    Usuwa wszystkie zestawy .NET SDK i środowiska uruchomieniowe.

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

    Usuwa tylko zestawy .NET SDK i środowiska uruchomieniowe z wersją mniejszą niż określona wersja. Określona wersja pozostaje zainstalowana.

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

    Usuwa wszystkie zestawy SDK i środowiska uruchomieniowe platformy .NET, z wyjątkiem określonych wersji.

  • --all-but-latest

    Usuwa zestawy .NET SDK i środowiska uruchomieniowe, z wyjątkiem najwyższej wersji.

  • --all-lower-patches

    Usuwa zestawy SDK platformy .NET i środowiska uruchomieniowe zastąpione przez wyższe poprawki. Ta opcja chroni global.json pliku.

  • --all-previews

    Usuwa zestawy SDK platformy .NET i środowiska uruchomieniowe oznaczone jako wersje zapoznawcze.

  • --all-previews-but-latest

    Usuwa zestawy .NET SDK i środowiska uruchomieniowe oznaczone jako wersje zapoznawcze z wyjątkiem najwyższej wersji zapoznawczej.

  • --aspnet-runtime

    Usuwa tylko środowiska uruchomieniowe ASP.NET.

  • --hosting-bundle

    Usuwa tylko środowisko uruchomieniowe platformy .NET i pakiety hostingu.

  • --major-minor <MAJOR_MINOR>

    Usuwa zestawy .NET SDK i środowiska uruchomieniowe zgodne z określoną major.minor wersją.

  • --runtime

    Usuwa tylko środowiska uruchomieniowe platformy .NET.

  • --sdk

    Usuwa tylko zestawy SDK platformy .NET.

  • -v, --verbosity <LEVEL>

    Ustawia poziom szczegółowości. Dozwolone wartości to q[uiet], , n[ormal]m[inimal], d[etailed], i diag[nostic]. Domyślna wartość to normal.

  • --x64

    Należy używać z elementami --sdk, --runtimei --aspnet-runtime , aby usunąć zestawy SDK lub środowiska uruchomieniowe x64.

  • --x86

    Należy używać z elementami --sdk, --runtimei --aspnet-runtime , aby usunąć zestawy SDK lub środowiska uruchomieniowe x86.

  • --force

    Wymusza usunięcie wersji, które mogą być używane przez program Visual Studio.

Uwaga

  • Wymagana jest dokładnie jedna z --sdkwartości , --runtime, --aspnet-runtimei --hosting-bundle .
  • --all, --all-below, , , --all-lower-patches--all-previews--all-but-latest--all-previews-but-latest--all-but--major-minori [<VERSION>...] są wyłączne.
  • --x86 Jeśli --x64 nie zostanie określony, zostaną usunięte zarówno x64, jak i x86.

Przykłady

Uwaga

Domyślnie zestawy SDK platformy .NET i środowiska uruchomieniowe, które mogą być wymagane przez program Visual Studio lub inne zestawy SDK, nie są uwzględniane w danych wyjściowych dotnet-core-uninstall dry-run . W poniższych przykładach w zależności od stanu maszyny niektóre z określonych zestawów SDK i środowisk uruchomieniowych mogą nie być uwzględnione w danych wyjściowych. Aby uwzględnić wszystkie zestawy SDK i środowiska uruchomieniowe, wyświetl je jawnie jako argumenty lub użyj --force opcji .

  • Suchy przebieg usuwania wszystkich środowisk uruchomieniowych platformy .NET, które zostały zastąpione przez wyższe poprawki:

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

  • Suchy przebieg usuwania wszystkich zestawów SDK platformy .NET poniżej wersji 2.2.301:

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

remove polecenie

Streszczenie

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

Argumenty

VERSION

Określona wersja do odinstalowania. Możesz wyświetlić kilka wersji po drugiej, oddzielonych spacjami. Obsługiwane są również pliki odpowiedzi.

Napiwek

Pliki odpowiedzi są alternatywą do umieszczania wszystkich wersji w wierszu polecenia. Są to pliki tekstowe, zazwyczaj z rozszerzeniem *.rsp , a każda wersja jest wyświetlana w osobnym wierszu. Aby określić plik odpowiedzi dla argumentu VERSION , użyj znaku @ natychmiast po nazwie pliku odpowiedzi.

Opcje

  • --all

    Usuwa wszystkie zestawy .NET SDK i środowiska uruchomieniowe.

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

    Usuwa tylko zestawy .NET SDK i środowiska uruchomieniowe z wersją mniejszą niż określona wersja. Określona wersja pozostaje zainstalowana.

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

    Usuwa wszystkie zestawy SDK i środowiska uruchomieniowe platformy .NET, z wyjątkiem określonych wersji.

  • --all-but-latest

    Usuwa zestawy .NET SDK i środowiska uruchomieniowe, z wyjątkiem najwyższej wersji.

  • --all-lower-patches

    Usuwa zestawy SDK platformy .NET i środowiska uruchomieniowe zastąpione przez wyższe poprawki. Ta opcja chroni global.json pliku.

  • --all-previews

    Usuwa zestawy SDK platformy .NET i środowiska uruchomieniowe oznaczone jako wersje zapoznawcze.

  • --all-previews-but-latest

    Usuwa zestawy .NET SDK i środowiska uruchomieniowe oznaczone jako wersje zapoznawcze z wyjątkiem najwyższej wersji zapoznawczej.

  • --aspnet-runtime

    Usuwa tylko środowiska uruchomieniowe ASP.NET.

  • --hosting-bundle

    Usuwa tylko pakiety hostingu platformy .NET.

  • --major-minor <MAJOR_MINOR>

    Usuwa zestawy .NET SDK i środowiska uruchomieniowe zgodne z określoną major.minor wersją.

  • --runtime

    Usuwa tylko środowiska uruchomieniowe platformy .NET.

  • --sdk

    Usuwa tylko zestawy SDK platformy .NET.

  • -v, --verbosity <LEVEL>

    Ustawia poziom szczegółowości. Dozwolone wartości to q[uiet], , n[ormal]m[inimal], d[etailed], i diag[nostic]. Domyślna wartość to normal.

  • --x64

    Należy używać z elementami --sdk, --runtimei --aspnet-runtime , aby usunąć zestawy SDK lub środowiska uruchomieniowe x64.

  • --x86

    Należy używać z elementami --sdk, --runtimei --aspnet-runtime , aby usunąć zestawy SDK lub środowiska uruchomieniowe x86.

  • -y, --yes

    Wykonuje polecenie bez konieczności potwierdzenia "tak" lub "bez".

  • --force

    Wymusza usunięcie wersji, które mogą być używane przez program Visual Studio.

Uwaga

  • Wymagana jest dokładnie jedna z --sdkwartości , --runtime, --aspnet-runtimei --hosting-bundle .
  • --all, --all-below, , , --all-lower-patches--all-previews--all-but-latest--all-previews-but-latest--all-but--major-minori [<VERSION>...] są wyłączne.
  • --x86 Jeśli --x64 nie zostanie określony, zostaną usunięte zarówno x64, jak i x86.

Przykłady

Uwaga

Domyślnie są przechowywane zestawy .NET SDK i środowiska uruchomieniowe, które mogą być wymagane przez program Visual Studio lub inne zestawy SDK. W poniższych przykładach w zależności od stanu maszyny niektóre z określonych zestawów SDK i środowisk uruchomieniowych mogą pozostać. Aby usunąć wszystkie zestawy SDK i środowiska uruchomieniowe, wyświetl je jawnie jako argumenty lub użyj --force opcji .

  • Usuń wszystkie środowiska uruchomieniowe platformy .NET z wyjątkiem wersji 3.0.0-preview6-27804-01 bez konieczności potwierdzenia tak lub bez potwierdzenia:

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

  • Usuń wszystkie zestawy SDK platformy .NET Core 1.1 bez konieczności potwierdzenia tak lub bez potwierdzenia:

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

  • Usuń zestaw .NET Core 1.1.11 SDK bez danych wyjściowych konsoli:

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

  • Usuń wszystkie zestawy SDK platformy .NET, które można bezpiecznie usunąć za pomocą tego narzędzia:

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

  • Usuń wszystkie zestawy SDK platformy .NET, które można usunąć za pomocą tego narzędzia, w tym te zestawy SDK, które mogą być wymagane przez program Visual Studio (niezalecane):

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

  • Usuń wszystkie zestawy SDK platformy .NET określone w pliku odpowiedzi versions.rsp :

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

    Zawartość pliku versions.rsp jest następująca:

    2.2.300
2.1.700