Note
dotnetup 目前已公開預覽。 其特性與行為可能會在正式上市前改變。
本文將說明如何管理該 dotnetup 工具本身。 若要更新或移除由 dotnetup 管理的 .NET SDK 和執行階段,請參閱 更新安裝。
請查看 dotnetup 版本
顯示 dotnetup 的版本:
dotnetup --version
若要同時顯示提交、架構、執行時識別碼及已驗證的安裝,請執行:
dotnetup --info
更新dotnetup
要在原地更新獨立的 dotnetup 執行檔,請執行:
dotnetup self update
此指令可在 dotnetup 0.3.0 預覽版中使用。 它會從已安裝的版本標籤中選擇發行通道。
官方每日版本也會使用這個 preview 標籤,因此請明確指定頻道以持續使用每日版本:
dotnetup self update --channel daily
要從較新的每日版本返回到最新的公開預覽,請執行:
dotnetup self update --channel preview --force
--force 可以降級或重新安裝執行檔。
關於指令選項與限制,請參見 dotnetup self update。
更新 dotnetup 不會改變你的 .NET 安裝、環境設定或追蹤的安裝規格。
從舊版更新或恢復執行檔
如果你的版本無法辨識 self update,或執行檔無法啟動,請重新執行下載腳本。
腳本會替換選定安裝目錄中現有的執行檔。
在 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 self update --update-notifications false
要再次啟用通知,請使用 --update-notifications true。
關於檢查頻率與輸出行為,請參見 更新通知。
移除 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 設定檔或使用者環境變數中移除該條目。
開啟一個新終端機以使用更新後的環境。