dotnetup 自更新命令

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

另请参阅