使用 MSI 安装程序

注意

MSI安装程序适用于所有拥有Business订阅和Docker Desktop 4.32及更高版本的公司和组织所有者。

MSI软件包支持各种MDM（移动设备管理）解决方案，使其成为批量安装的理想选择，并消除了单个用户手动设置的需要。借助此软件包，IT管理员可以确保Docker Desktop的标准化、策略驱动安装，从而提高组织的效率和软件管理。

交互式安装

1. 在Docker管理控制台中，导航到您的组织。

2. 在**安全和访问**下，选择**部署Docker Desktop**页面。

3. 在**Windows操作系统**选项卡中，选择**下载MSI安装程序**按钮。

4. 下载完成后，双击Docker Desktop Installer.msi运行安装程序。

5. 接受许可协议后，您可以选择安装位置。默认情况下，Docker Desktop安装在C:\Program Files\Docker\Docker。

6. 配置Docker Desktop安装。您可以

   • 创建桌面快捷方式

   • 将Docker Desktop服务启动类型设置为自动

   • 禁用Windows容器使用

   • 选择Docker Desktop的引擎。WSL或Hyper-V。如果您的系统只支持这两个选项中的一个，则您将无法选择要使用的后端。

7. 按照安装向导中的说明授权安装程序并继续安装。

8. 安装成功后，选择**完成**以完成安装过程。

如果您的管理员帐户与您的用户帐户不同，则必须将用户添加到docker-users组

1. 以管理员身份运行计算机管理。
2. 导航到本地用户和组 > 组 > docker-users。
3. 右键单击以将用户添加到组。
4. 注销并重新登录以使更改生效。

注意

使用MSI安装Docker Desktop时，应用程序内更新会自动禁用。此功能可确保您的组织维护所需的Docker Desktop版本。对于使用.exe安装程序安装的Docker Desktop，应用程序内更新仍然受支持。

当有更新可用时，Docker Desktop会通知您。要更新Docker Desktop，请从Docker管理控制台下载最新的安装程序。导航到**部署Docker Desktop**页面> 在**安全和访问**下。

要了解最新版本，请查看发行说明页面。

从命令行安装

本节介绍使用PowerShell进行Docker Desktop的命令行安装。它提供了您可以运行的常见安装命令。您还可以添加其他参数，这些参数在配置选项中进行了概述。

安装Docker Desktop时，可以选择交互式安装或非交互式安装。

交互式安装（不指定/quiet或/qn）会显示用户界面，并允许您选择自己的属性。

通过用户界面安装时，可以

• 选择目标文件夹
• 创建桌面快捷方式
• 配置Docker Desktop服务启动类型
• 禁用Windows容器
• 在WSL或Hyper-V引擎之间进行选择

非交互式安装是静默的，任何其他配置都必须作为参数传递。

常见的安装命令

重要

运行以下任何命令都需要管理员权限。

使用详细日志进行交互式安装

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log"

交互式安装，不使用详细日志

msiexec /i "DockerDesktop.msi"

使用详细日志进行非交互式安装

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet

非交互式安装并抑制重启

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet /norestart

使用管理员设置进行非交互式安装

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet /norestart ADMINSETTINGS="{"configurationFileVersion":2,"enhancedContainerIsolation":{"value":true,"locked":false}}" ALLOWEDORG="docker"

使用被动显示选项安装

当您想要执行非交互式安装但显示进度对话框时，您可以使用/passive显示选项代替/quiet。

在被动模式下，安装程序不会向用户显示任何提示或错误消息，并且无法取消安装。

例如

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /passive /norestart

提示

创建期望 JSON 字符串作为值的属性值时，需要记住一些有用的提示

• 此属性期望一个 JSON 格式的字符串
• 字符串应包含在双引号中
• 字符串不应包含任何空格
• 属性名称应使用双引号

常见的卸载命令

卸载 Docker Desktop 时，需要使用最初安装应用程序的相同.msi文件。

如果您不再拥有原始的.msi文件，则需要使用与安装相关的产品代码。要查找产品代码，请运行

Get-WmiObject Win32_Product | Select-Object IdentifyingNumber, Name | Where-Object {$_.Name -eq "Docker Desktop"}

它应该返回类似于以下内容的输出

IdentifyingNumber                      Name
-----------------                      ----
{10FC87E2-9145-4D7D-B493-2E99E8D8E103} Docker Desktop

注意

此命令返回所需的时间可能因已安装应用程序的数量而异。

IdentifyingNumber是应用程序的产品代码，可用于卸载 Docker Desktop。例如

msiexec /x {10FC87E2-9145-4D7D-B493-2E99E8D8E103} /L*V ".\msi.log" /quiet

以交互方式卸载并记录详细日志

msiexec /x "DockerDesktop.msi" /L*V ".\msi.log"

以交互方式卸载但不记录详细日志

msiexec /x "DockerDesktop.msi"

非交互式卸载并记录详细日志

msiexec /x "DockerDesktop.msi" /L*V ".\msi.log" /quiet

非交互式卸载且不记录详细日志

msiexec /x "DockerDesktop.msi" /quiet

配置选项

重要

除了以下自定义属性外，Docker Desktop MSI 安装程序还支持标准的Windows 安装程序命令行选项。

此外，您还可以使用/norestart或/forcerestart来控制重新启动行为。

默认情况下，安装程序在成功安装后会重新启动计算机。在静默运行时，重新启动是自动的，不会提示用户。

分析

MSI 安装程序会收集匿名的使用统计信息，以便更好地了解用户行为，并通过识别和解决问题或优化常用功能来改善用户体验。

如何选择退出

msiexec /i "win\msi\bin\en-US\DockerDesktop.msi" /L*V ".\msi.log" DISABLEANALYTICS=1

持久性

如果您决定为安装禁用分析，您的选择将保留在注册表中，并在以后的升级和卸载中得到遵守。

但是，卸载 Docker Desktop 时会删除此键，必须通过上述方法之一重新配置。

注册表键如下所示

SOFTWARE\Docker Inc.\Docker Desktop\DisableMsiAnalytics

禁用分析时，此键的值为1。

其他资源

• 浏览常见问题