Note
dotnetup 目前已公開預覽。 其特性與行為可能會在正式上市前改變。
本文將說明如何管理該 dotnetup 工具本身。 若要更新或移除由 dotnetup 管理的 .NET SDK 和執行階段，請參閱 更新安裝。
請查看 dotnetup 版本
顯示 dotnetup 的版本：
dotnetup --version
若要同時顯示提交、架構、執行時識別碼及已驗證的安裝，請執行：
dotnetup --info
更新dotnetup
dotnetup 沒有可更新自身的指令。 要更新 dotnetup，請再次執行下載腳本。 這個腳本會替換安裝目錄中現有的 dotnetup 執行檔。
在 macOS 或 Linux 上，執行：
curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash
在 Windows 上，執行：
irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex
腳本預設安裝最新的 preview 建置版本。 如果你使用 daily 建置檔或自訂安裝目錄，請傳遞你第一次安裝時使用的相同選項。 例如，在 macOS 或 Linux 上：
curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
bash -s -- --quality daily --install-dir /opt/dotnetup
在 Windows 上：
iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily -InstallDir C:\tools\dotnetup"
dotnetup 的更新不會改變你的安裝、環境設定或追蹤的安裝規格。
移除 dotnetup
要移除 dotnetup 及它所管理的所有內容，請依序完成這些步驟。
1. 找出安裝根目錄
列出 dotnetup 追蹤的安裝根目錄：
dotnetup list
記錄每個不在 dotnetup 資料目錄中的安裝根目錄。 您會在後續步驟中刪除這些資料夾。
2. 移除環境設定
移除 dotnetup 對 PATH 和 DOTNET_ROOT 所做的變更：
dotnetup env clear
在 shell 模式中，從設定檔 dotnetup 已變更的那個 shell 執行此指令，或使用 --shell 選項選取該 shell。 在 Windows 的 everywhere 模式下，這個指令會變更系統PATH，並且需要提升權限。
這個指令不會移除 SDK 或執行時。 更多資訊請參閱 「移除環境設定」。
3. 刪除安裝根目錄與資料目錄
刪除你在第一步記錄的每個安裝根目錄。
然後刪除 dotnetup 的資料目錄。 此目錄包含預設安裝根目錄、清單、設定檔及下載快取。
| 作業系統 | 預設資料目錄 |
|---|---|
| Windows 作業系統 | %LOCALAPPDATA%\dotnetup |
| macOS | ~/Library/Application Support/dotnetup |
| Linux |
$XDG_DATA_HOME/dotnetup，或在未設定 XDG_DATA_HOME 時，則為 ~/.local/share/dotnetup |
如果你設定了 DOTNET_DOTNETUP_DATA_DIR 環境變數，請改為刪除那個目錄，然後移除該環境變數。
4. 刪除 dotnetup 執行檔
刪除包含 dotnetup 該執行檔的目錄。 預設情況下，下載腳本將 dotnetup 安裝在 ~/.dotnetup。 如果你手動新增這個目錄 PATH ，請從你的 shell 設定檔或使用者環境變數中移除該條目。
開啟一個新終端機以使用更新後的環境。
