MSI 安装程序

MSI 软件包支持各种 MDM（移动设备管理）解决方案，非常适合批量安装，省去了个人用户手动设置的需要。通过此软件包，IT 管理员可以确保 Docker Desktop 的标准化、策略驱动型安装，从而提高组织内部的效率和软件管理水平。

交互式安装

1. 在 Docker Home 中，选择您的组织。

2. 选择 Admin Console，然后选择 Enterprise deployment。

3. 从 Windows OS 选项卡中，选择 Download MSI installer 按钮。

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. 安装成功后，选择 Finish 完成安装过程。

如果您的管理员帐户与用户帐户不同，则必须将用户添加到 docker-users 组，才能访问需要更高权限的功能，例如创建和管理 Hyper-V VM，或使用 Windows 容器

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

注意

使用 MSI 安装 Docker Desktop 时，应用内更新会自动禁用。这可确保组织能够保持版本一致性并防止未经批准的更新。对于使用 .exe 安装程序安装的 Docker Desktop，仍支持应用内更新。

Docker Desktop 会在有可用更新时通知您。要更新 Docker Desktop，请从 Docker Admin Console 下载最新安装程序。导航到 Enterprise deployment 页面。

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

从命令行安装

本节介绍使用 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="your-organization"

交互式安装并允许用户在没有管理员权限的情况下切换到 Windows 容器

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet /norestart ALLOWEDORG="your-organization" ALWAYSRUNSERVICE=1

以被动显示选项安装

当您想要执行非交互式安装但显示进度对话框时，可以使用 /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 Installer 命令行选项。

此外，您还可以使用 /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。

其他资源

• 探索常见问题