dotnet-core-uninstall 移除

本文適用於:✔️ .NET Uninstall Tool 1.7.521001 及更新版本

名稱

dotnet-core-uninstall remove - 移除指定的 .NET SDK 或執行階段。

概要


dotnet-core-uninstall remove <TARGET> <FILTER> [-v|--verbosity <LEVEL>]
    [--force] [-y|--yes]

dotnet-core-uninstall remove -h|--help
dotnet-core-uninstall remove <TARGET> <FILTER> [-v|--verbosity <LEVEL>]
    [--force] [-y|--yes] [--preserve-vs-for-mac-sdks]

dotnet-core-uninstall remove -h|--help

描述

dotnet-core-uninstall remove 命令會從主機上移除 .NET SDK 和執行階段。

引數

TARGET

您想要解除安裝的類型。 有效的選項列在「選項 - 目標」區段。

VERSION

要解除安裝的版本。 您可以列出多個版本,用空格分隔。 也支援回應檔。

提示

如不想將所有版本都放在命令列上,可採用回應檔作為替代方案。 這是一種文字檔,副檔名通常為 *.rsp,並將每個版本列在個別的行上。 若要指定 VERSION 引數的回應檔,請在回應檔名稱後加上 @ 字元。

FILTER

指定用於篩選 TARGET 的值。 有效的選項列在「選項 - 篩選」區段。

選項 - 目標

  • --arm64

    可與 --sdk--runtime--aspnet-runtime--windows-desktop-runtime 一起使用,以移除 arm64。

  • --aspnet-runtime

    僅移除 ASP.NET Core 執行時。

  • --hosting-bundle

    只移除 .NET 執行時和主機套件。

  • --runtime

    只會移除 .NET 執行階段。

  • --sdk

    只移除 .NET SDK。

  • --windows-desktop-runtime

    僅移除 Windows 桌面執行階段。

  • --x64

    可搭配 --sdk--runtime--aspnet-runtime--windows-desktop-runtime 來移除 x64。

  • --x86

    可與 --sdk--runtime--aspnet-runtime--windows-desktop-runtime 、 一起使用,以去除 x86。

  • --runtime

    僅移除 .NET 執行階段。

  • --sdk

    只移除 .NET SDK。

選項 - 篩選

這些選項是互斥的。

  • --all

    移除所有 .NET SDK 和執行階段。

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

    僅移除版本編號小於指定版本的 .NET SDK 和執行階段。 指定的版本仍會維持已安裝狀態。

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

    移除所有 .NET SDK 和執行階段,但指定的版本除外。

  • --all-but-latest

    移除 .NET SDK 和執行階段,但最高版本除外。

  • --all-lower-patches

    移除已由較新版本修補程式取代的 .NET SDK 和執行階段。 此選項可保護 global.json 檔案。

  • --all-previews

    移除標示為預覽版的 .NET SDK 和執行階段。

  • --all-previews-but-latest

    移除標示為預覽版的 .NET SDK 和執行階段,但最高預覽版除外。

  • --major-minor <MAJOR_MINOR>

    移除符合指定 major.minor 版本的 .NET SDK 和執行階段。

選項

  • -y, --yes

    可執行命令,而不需要進行是或否的確認。

  • --force

    會強制移除 Visual Studio 可能使用的版本。

:::區域結束

  • --force

    強制移除可能被 Visual Studio for Mac 或 SDK 使用的版本。

  • --preserve-vs-for-mac-sdks

    防止移除 Visual Studio for Mac 高機率使用的 SDK 與執行環境。

    注意

    Visual Studio for Mac 已經不支援了。

  • -v, --verbosity <LEVEL>

    設定冗長程度等級。 預設值是 normal。 允許的值如下:

    • q[uiet]
    • m[inimal]
    • n[ormal]
    • d[etailed]
    • diag[nostic]
  • -h|--help

    顯示說明和使用方式資訊

範例

注意

根據預設,Visual Studio 或其他 SDK 可能需要的 .NET SDK 和執行階段皆會保留。 在以下範例中,根據電腦的狀態,一些指定的 SDK 和執行階段可能會保留。 若要移除所有 SDK 和執行階段,請明確地將其列為引數,或使用 --force 選項。

  • 移除版本 3.0.0-preview6-27804-01 以外的所有 .NET 執行階段,而不需要進行是或否的確認:

    dotnet-core-uninstall remove --all-but 3.0.0-preview6-27804-01 --runtime --yes
    
  • 移除所有 .NET Core 1.1 SDK,而不需要進行是或否的確認:

    dotnet-core-uninstall remove --sdk --major-minor 1.1 -y
    
  • 移除 .NET 6.0.301 SDK 並且不產生控制台輸出:

    dotnet-core-uninstall remove 6.0.301 --sdk --yes --verbosity q
    
  • 移除可由此工具安全地移除的所有 .NET SDK:

    dotnet-core-uninstall remove --all --sdk
    
  • 移除可由此工具移除的所有 .NET SDK,包含 Visual Studio 可能需要的 SDK (不建議):

    dotnet-core-uninstall remove --all --sdk --force
    
  • 移除 versions.rsp 回應檔中指定的所有 .NET SDK:

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

    versions.rsp 檔案的內容如下所示:

    2.2.300
    6.0.301
    

另請參閱