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的较旧版本,或者在可执行文件不再启动时进行恢复,请使用 下载脚本。
选项
| 选项 | Description |
|---|---|
--channel <daily\|preview\|stable> |
选择 dotnetup 发布通道,而不是.NET SDK 通道。 默认情况下,没有预发行标签的版本使用 stable、具有 preview 标签使用 preview的版本和其他预发行版版本使用 daily。 |
--force |
安装所选通道的最新版本,即使它不是较新。 此选项可以重新安装或降级 dotnetup。 |
--update-notifications <true\|false> |
在不更新可执行文件的情况下启用或禁用更新通知。 此选项不能与 --channel 或 --force 组合使用。 |
--no-progress [<true\|false>] |
禁用下载进度显示。 |
-?、-h、--help |
显示命令帮助。 |
官方每日版本还带有 preview 版本标签,因此它们默认为预览频道。 若要保持每日内部版本,请指定 --channel daily。
分析程序接受 stable,但在此公共预览版中不提供稳定的 dotnetup 版本。
更新通知
成功安装并更新命令后,dotnetup 可以在更新的 dotnetup 生成可用时将通知写入标准输出。
这些命令包括裸机dotnetup、、sdk installinstall、runtime install、update和sdk 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