Share via

.NET eltávolítási eszköz

  • Cikk

A .NET eltávolítási eszköz (dotnet-core-uninstall) lehetővé teszi a .NET SDK-k és futtatókörnyezetek eltávolítását a rendszerből. Rendelkezésre áll egy beállításgyűjtemény, amely meghatározza, hogy mely verziókat szeretné eltávolítani.

Az eszköz támogatja a Windowst és a macOS-t. A Linux jelenleg nem támogatott.

Windows rendszeren az eszköz csak az alábbi telepítők egyikével telepített SDK-kat és futtatókörnyezeteket távolíthatja el:

  • A .NET SDK és a futtatókörnyezet telepítője.
  • A Visual Studio telepítője a Visual Studio 2019 16.3-nál korábbi verzióiban.

MacOS rendszeren az eszköz csak az /usr/local/share/dotnet mappában található SDK-kat és futtatókörnyezeteket tudja eltávolítani.

A korlátozások miatt előfordulhat, hogy az eszköz nem tudja eltávolítani a számítógépen található összes .NET SDK-t és futtatókörnyezetet. A parancs segítségével dotnet --info megkeresheti az összes telepített .NET SDK-t és futtatókörnyezetet, beleértve azokat az SDK-kat és futtatókörnyezeteket is, amelyeket az eszköz nem tud eltávolítani. A dotnet-core-uninstall list parancs megjeleníti, hogy mely SDK-k távolíthatók el az eszközzel.

Az eszköz telepítése

A .NET-eltávolító eszközt az eszköz kiadási oldaláról töltheti le, és megtalálhatja a forráskódot a dotnet/cli-lab GitHub-adattárban.

Feljegyzés

Az eszköz jogosultságszint-emelést igényel a .NET SDK-k és futtatókörnyezetek eltávolításához. Ezért olyan írásvédett könyvtárba kell telepíteni, mint a C:\Program Files windowsos vagy /usr/local/bin macOS rendszeren. További információkért tekintse meg a dotnet-parancsok emelt szintű hozzáférését és a részletes telepítési utasításokat.

Az eszköz futtatása

Az alábbi lépések az eltávolítási eszköz futtatásához javasolt megközelítést mutatják be:

1. lépés – Telepített .NET SDK-k és futtatókörnyezetek megjelenítése

A dotnet-core-uninstall list parancs felsorolja az ezzel az eszközzel eltávolítható telepített .NET SDK-kat és futtatókörnyezeteket. Előfordulhat, hogy egyes SDK-kra és futtatókörnyezetekre szükség lehet a Visual Studióban, és egy megjegyzés jelenik meg, hogy miért nem ajánlott eltávolítani őket.

Feljegyzés

A parancs kimenete dotnet-core-uninstall list a legtöbb esetben nem egyezik meg a dotnet --info telepített verziók listájával. Ez az eszköz nem jeleníti meg a zip-fájlok által telepített vagy a Visual Studio által felügyelt verziókat (a Visual Studio 2019 16.3-s vagy újabb verziójával telepített bármely verziót). Annak ellenőrzésére, hogy a Visual Studio felügyeli-e a verziókat, az egyik módja annak Add or Remove Programsmegtekintése, hogy a Visual Studio által felügyelt verziók ilyenként vannak-e megjelölve a megjelenítési nevükben.

További információt a jelen cikk későbbi, listaparancsában talál.

2. lépés – Száraz futtatás végrehajtása

Az dotnet-core-uninstall dry-run és dotnet-core-uninstall whatif a parancsok megjelenítik azokat a .NET SDK-kat és futtatókörnyezeteket, amelyeket az eltávolítás nélkül megadott beállítások alapján eltávolítunk. Ezek a parancsok szinonimák.

További információt a cikk későbbi részében talál, és a parancsokat is megtekintheti.dry-runwhatif

3. lépés – .NET SDK-k és futtatókörnyezetek eltávolítása

dotnet-core-uninstall remove eltávolítja azokat a .NET SDK-kat és futtatókörnyezeteket, amelyeket egy beállításgyűjtemény határoz meg.

Mivel ez az eszköz romboló viselkedéssel rendelkezik, erősen ajánlott száraz futtatást végezni az eltávolítási parancs futtatása előtt. A száraz futtatás megmutatja, hogy a parancs használatakor remove milyen .NET SDK-k és futtatókörnyezetek lesznek eltávolítva. Tekintse meg a Verzió eltávolítása című témakört, amelyből megtudhatja, hogy mely SDK-k és futtatókörnyezetek távolíthatók el biztonságosan.

Figyelemfelhívás

Tartsa szem előtt a következő kikötéseket:

  • Ez az eszköz eltávolíthatja a .NET SDK azon verzióit, amelyekre a számítógépen lévő fájloknak szüksége van global.json . A .NET SDK-k újratelepíthetők a Letöltés .NET oldalról.
  • Ez az eszköz eltávolíthatja a .NET-futtatókörnyezet azon verzióit, amelyeket a keretrendszerfüggő alkalmazások igényelnek a számítógépen. A .NET-futtatókörnyezetek újratelepíthetők a .NET letöltése oldalról.
  • Ez az eszköz eltávolítja a Visual Studio által támogatott .NET SDK és futtatókörnyezet verzióit. Ha megszakítja a Visual Studio telepítését, futtassa a "Javítás" parancsot a Visual Studio telepítőjében, hogy visszatérjen egy működő állapotba.

Alapértelmezés szerint minden parancs megtartja a Visual Studio vagy más SDK-k által megkövetelt .NET SDK-kat és futtatókörnyezeteket. Ezek az SDK-k és futtatókörnyezetek eltávolíthatók úgy, hogy explicit módon argumentumként vagy a --force beállítás használatával listázják őket.

Az eszköz jogosultságszint-emelést igényel a .NET SDK-k és futtatókörnyezetek eltávolításához. Futtassa az eszközt egy Rendszergazda istrator parancssorban Windows rendszeren és sudo macOS rendszeren. A dry-run parancsok és whatif parancsok nem igényelnek jogosultságszint-emelést.

További információkért lásd a cikk későbbi, eltávolítási parancsát .

4. lépés – A NuGet tartalék mappájának törlése (nem kötelező)

Bizonyos esetekben már nincs szüksége a NuGetFallbackFolder fájlra, és előfordulhat, hogy törölni szeretné azt. További információ: A NuGetFallbackFolder eltávolítása.

Az eszköz eltávolítása

  1. Nyissa meg a Programok hozzáadása vagy eltávolítása elemet.
  2. Keressen a Microsoft .NET SDK Uninstall Tool kifejezésre.
  3. Válassza az Uninstall lehetőséget.

list parancs

Szinopszis

dotnet-core-uninstall list [options]

Beállítások

  • --aspnet-runtime

    Felsorolja az eszközzel eltávolítható ASP.NET futtatókörnyezeteket.

  • --hosting-bundle

    Felsorolja az ezzel az eszközzel eltávolítható .NET-üzemeltetési csomagokat.

  • --runtime

    Az eszközzel eltávolítható .NET-futtatókörnyezetek listája.

  • --sdk

    Az eszközzel eltávolítható .NET SDK-k listája.

  • -v, --verbosity <LEVEL>

    Beállítja a részletességi szintet. Az engedélyezett értékek a következőkq[uiet]: , m[inimal], n[ormal]d[etailed]és diag[nostic]. Az alapértelmezett érték normal.

  • --x64

    Az eszközzel eltávolítható x64 .NET SDK-k és futtatókörnyezetek listája.

  • --x86

    Az eszközzel eltávolítható x86 .NET SDK-k és futtatókörnyezetek listája.

Példák

  • Az eszközzel eltávolítható .NET SDK-k és futtatókörnyezetek felsorolása:

    dotnet-core-uninstall list

  • Sorolja fel az összes x64 .NET SDK-t és futtatókörnyezetet:

    dotnet-core-uninstall list --x64

  • Sorolja fel az összes x86 .NET SDK-t:

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

dry-run és whatif parancsok

Szinopszis

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

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

Argumentumok

VERSION

Az eltávolítandó megadott verzió. Egymás után több verziót is listázhat, szóközök szerint elválasztva. A válaszfájlok is támogatottak.

Tipp.

A válaszfájlok alternatívaként az összes verziót a parancssorba helyezhetik. Ezek szöveges fájlok, általában *.rsp kiterjesztéssel, és minden verzió külön sorban szerepel. Az argumentum válaszfájljának VERSION megadásához használja a @ karaktert, amelyet azonnal a válaszfájl neve követ.

Beállítások

  • --all

    Eltávolítja az összes .NET SDK-t és futtatókörnyezetet.

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

    Csak a megadott verziónál kisebb verziójú .NET SDK-k és futtatókörnyezetek eltávolítása. A megadott verzió továbbra is telepítve marad.

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

    Eltávolítja az összes .NET SDK-t és futtatókörnyezetet, kivéve a megadott verziókat.

  • --all-but-latest

    Eltávolítja a .NET SDK-kat és futtatókörnyezeteket, kivéve a legmagasabb verziót.

  • --all-lower-patches

    Eltávolítja azokat a .NET SDK-kat és futtatókörnyezeteket, amelyeket a magasabb szintű javítások felülírnak. Ez a beállítás védi global.json fájlt.

  • --all-previews

    Eltávolítja az előnézetként megjelölt .NET SDK-kat és futtatókörnyezeteket.

  • --all-previews-but-latest

    Eltávolítja az előnézetként megjelölt .NET SDK-kat és futtatókörnyezeteket, kivéve a legmagasabb előzetes verziót.

  • --aspnet-runtime

    Csak a ASP.NET futtatókörnyezeteket távolítja el.

  • --hosting-bundle

    Csak a .NET-futtatókörnyezetet és a csomagokat távolítja el.

  • --major-minor <MAJOR_MINOR>

    Eltávolítja a megadott major.minor verziónak megfelelő .NET SDK-kat és futtatókörnyezeteket.

  • --runtime

    Csak a .NET-futtatókörnyezeteket távolítja el.

  • --sdk

    Csak a .NET SDK-k eltávolítása.

  • -v, --verbosity <LEVEL>

    Beállítja a részletességi szintet. Az engedélyezett értékek a következőkq[uiet]: , m[inimal], n[ormal]d[etailed]és diag[nostic]. Az alapértelmezett érték normal.

  • --x64

    Az x64 SDK-k és --aspnet-runtime futtatókörnyezetek eltávolításához a , --runtimeés azokkal --sdkegyütt kell használni.

  • --x86

    Az x86 SDK-k --sdkés --aspnet-runtime futtatókörnyezetek eltávolításához a , --runtimeés azokkal együtt kell használni.

  • --force

    Kényszeríti a Visual Studio által esetleg használt verziók eltávolítását.

Feljegyzés

  • Pontosan az egyik--sdk, --runtimeés --aspnet-runtime--hosting-bundle kötelező.
  • --all, --all-below, --all-but, --all-but-latest, --all-lower-patches--all-previews, --all-previews-but-latest, , , --major-minorés [<VERSION>...] kizárólagosak.
  • Ha --x64 nincs megadva, --x86 akkor az x64 és az x86 is törlődik.

Példák

Feljegyzés

Alapértelmezés szerint a Visual Studio vagy más SDK-k által esetleg szükséges .NET SDK-k és futtatókörnyezetek nem szerepelnek a dotnet-core-uninstall dry-run kimenetben. Az alábbi példákban a gép állapotától függően előfordulhat, hogy a megadott SDK-k és futtatókörnyezetek némelyike nem szerepel a kimenetben. Az összes SDK és futtatókörnyezet belefoglalásához explicit módon listázhatja őket argumentumként, vagy használhatja a --force lehetőséget.

  • Az összes .NET-futtatókörnyezet eltávolításának száraz futtatása, amelyet a magasabb javítások felülírtak:

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

  • Az összes .NET SDK eltávolításának száraz futtatása a verzió 2.2.301alatt:

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

remove parancs

Szinopszis

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

Argumentumok

VERSION

Az eltávolítandó megadott verzió. Több verziót is felsorolhat egymás után, szóközök szerint elválasztva. A válaszfájlok is támogatottak.

Tipp.

A válaszfájlok alternatívaként az összes verziót a parancssorba helyezhetik. Ezek szöveges fájlok, általában *.rsp kiterjesztéssel, és minden verzió külön sorban szerepel. Az argumentum válaszfájljának VERSION megadásához használja a @ karaktert, amelyet azonnal a válaszfájl neve követ.

Beállítások

  • --all

    Eltávolítja az összes .NET SDK-t és futtatókörnyezetet.

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

    Csak a megadott verziónál kisebb verziójú .NET SDK-k és futtatókörnyezetek eltávolítása. A megadott verzió továbbra is telepítve marad.

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

    Eltávolítja az összes .NET SDK-t és futtatókörnyezetet, kivéve a megadott verziókat.

  • --all-but-latest

    Eltávolítja a .NET SDK-kat és futtatókörnyezeteket, kivéve a legmagasabb verziót.

  • --all-lower-patches

    Eltávolítja azokat a .NET SDK-kat és futtatókörnyezeteket, amelyeket a magasabb szintű javítások felülírnak. Ez a beállítás védi global.json fájlt.

  • --all-previews

    Eltávolítja az előnézetként megjelölt .NET SDK-kat és futtatókörnyezeteket.

  • --all-previews-but-latest

    Eltávolítja az előnézetként megjelölt .NET SDK-kat és futtatókörnyezeteket, kivéve a legmagasabb előzetes verziót.

  • --aspnet-runtime

    Csak a ASP.NET futtatókörnyezeteket távolítja el.

  • --hosting-bundle

    Csak a .NET-tárhelycsomagokat távolítja el.

  • --major-minor <MAJOR_MINOR>

    Eltávolítja a megadott major.minor verziónak megfelelő .NET SDK-kat és futtatókörnyezeteket.

  • --runtime

    Csak a .NET-futtatókörnyezeteket távolítja el.

  • --sdk

    Csak a .NET SDK-k eltávolítása.

  • -v, --verbosity <LEVEL>

    Beállítja a részletességi szintet. Az engedélyezett értékek a következőkq[uiet]: , m[inimal], n[ormal]d[etailed]és diag[nostic]. Az alapértelmezett érték normal.

  • --x64

    Az x64 SDK-k és --aspnet-runtime futtatókörnyezetek eltávolításához a , --runtimeés azokkal --sdkegyütt kell használni.

  • --x86

    Az x86 SDK-k --sdkés --aspnet-runtime futtatókörnyezetek eltávolításához a , --runtimeés azokkal együtt kell használni.

  • -y, --yes

    Igen vagy megerősítés nélkül hajtja végre a parancsot.

  • --force

    Kényszeríti a Visual Studio által esetleg használt verziók eltávolítását.

Feljegyzés

  • Pontosan az egyik--sdk, --runtimeés --aspnet-runtime--hosting-bundle kötelező.
  • --all, --all-below, --all-but, --all-but-latest, --all-lower-patches--all-previews, --all-previews-but-latest, , , --major-minorés [<VERSION>...] kizárólagosak.
  • Ha --x64 nincs megadva, --x86 akkor az x64 és az x86 is törlődik.

Példák

Feljegyzés

Alapértelmezés szerint a Visual Studio vagy más SDK-k számára szükséges .NET SDK-k és futtatókörnyezetek megmaradnak. Az alábbi példákban a gép állapotától függően a megadott SDK-k és futtatókörnyezetek némelyike megmaradhat. Az összes SDK és futtatókörnyezet eltávolításához explicit módon listázhatja őket argumentumként, vagy használhatja a --force lehetőséget.

  • Távolítsa el az összes .NET-futtatókörnyezetet, kivéve a verziót 3.0.0-preview6-27804-01 anélkül, hogy igent vagy megerősítést kellene igényelnie:

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

  • Távolítsa el az összes .NET Core 1.1 SDK-t anélkül, hogy igent vagy megerősítést kellene igényelnie:

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

  • Távolítsa el a .NET Core 1.1.11 SDK-t konzolkimenet nélkül:

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

  • Távolítsa el az eszköz által biztonságosan eltávolítható összes .NET SDK-t:

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

  • Távolítsa el az eszköz által eltávolítható összes .NET SDK-t, beleértve a Visual Studio által esetleg szükséges SDK-kat is (nem ajánlott):

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

  • Távolítsa el a versions.rsp válaszfájlban megadott összes .NET SDK-t:

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

    A versions.rsp fájl tartalma a következő:

    2.2.300
2.1.700