Note
dotnetup 目前為公開預覽版。 其特性與行為可能會在正式上市前改變。
Name
dotnetup self update - 從發佈通道更新獨立的 dotnetup 執行檔。
Synopsis
dotnetup self update [--channel <daily|preview|stable>] [--force]
[--no-progress [<true|false>]]
dotnetup self update --update-notifications <true|false>
Description
指令會更新執行中的獨立 dotnetup 執行檔。
它會下載所選發行頻道的最新可用建置版本，以及目前作業系統和架構。
它不會更新管理的 .NET SDK 或執行時。 對於這些安裝，請使用 dotnetup update。
在同一版本通道中，除非你特別指定 --force，否則相同或更舊的版本不會取代已安裝的執行檔。
指令會回報沒有更新，並回傳退出代碼 0。
版本通道間的變更，例如預覽版與穩定版，即使目標版本較舊，也可能取代執行檔。
安裝目錄必須是可寫的。 自我更新不支援透過 dotnet 主機或符號連結或其他重解析點執行。 請使用其實際安裝目錄中的獨立執行檔。
雖然自我更新會保留協調鎖，但其他 dotnetup 指令可能會因收到更新正在進行的訊息而失敗。 自我更新結束後再試一次那些指令。
對於無法辨識 self update的舊版本，或是執行檔無法啟動時的復原， 請使用下載腳本。
選項
| Option | Description |
|---|---|
--channel <daily\|preview\|stable> |
選擇 dotnetup 發佈頻道，而不是 .NET SDK 頻道。 預設情況下，未使用預發行標籤stable的版本、使用previewpreview標籤的版本，以及其他預發行版本使用 daily。 |
--force |
即使該頻道不是新版本，也要安裝它的最新版本。 這個選項可以重新安裝或降級 dotnetup。 |
--update-notifications <true\|false> |
啟用或停用更新通知，但不更新執行檔。 此選項無法與 --channel 或 --force合併。 |
--no-progress [<true\|false>] |
關閉下載進度顯示。 |
-?、-h、--help |
顯示指令說明。 |
官方每日版本也會標示 preview 版本標籤，因此預設會使用預覽頻道。 要持續每日建置，請指定 --channel daily。
解析器接受 stable，但本次公開預覽期間尚未提供穩定的 dotnetup 版本。
更新通知
在成功完成互動式安裝與更新指令後，dotnetup 可以在更新的 dotnetup 版本可用時，寫入標準輸出通知。
這些指令包括裸、dotnetupinstall、sdk install、runtime install、updatesdk updateruntime update、 和 。
通知預設已啟用。 檢查會使用執行中的建置版本的預設發佈通道，並在成功檢查後最多每 24 小時在背景重新整理一次。 它不會下載或安裝執行檔。 成功的刷新最多只會收到一次通知。 一個簡短的指令可能會在刷新前完成，因此通知可能會在後續指令之後出現。
即使有 --interactive true，當輸出被重新導向時，通知也不會出現。 檢查失敗不會讓安裝或更新指令失敗。
要停用通知，請執行：
dotnetup self update --update-notifications false
要重新啟用通知，請執行：
dotnetup self update --update-notifications true
Examples
更新 dotnetup 從預設發佈頻道：
dotnetup self update
更新至最新每日版本，無需下載進度：
dotnetup self update --channel daily --no-progress
回到最新的預覽版，即使它比已安裝的每日版還舊：
dotnetup self update --channel preview --force
