MSI 安裝程式

目錄
訂閱： Business
要求： Docker Desktop 4.32 及更高版本
面向： 管理員

MSI 安裝包支援各種 MDM (移動裝置管理) 解決方案，非常適合批次安裝，並消除了個人使用者手動設定的需求。使用此安裝包，IT 管理員可以確保 Docker Desktop 的標準化、策略驅動式安裝，從而提高組織內部的效率和軟體管理水平。

互動式安裝

  1. 在 Docker Admin Console 中，導航到您的組織。

  2. 在 Docker Desktop 下，選擇 部署 頁面。

  3. 在 Windows OS 選項卡中，選擇 下載 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 時，應用內更新會自動停用。這可確保組織能夠保持版本一致性並防止未經批准的更新。對於使用 .exe 安裝程式安裝的 Docker Desktop，仍支援應用內更新。

當有可用更新時，Docker Desktop 會通知您。要更新 Docker Desktop，請從 Docker Admin Console 下載最新的安裝程式。導航到部署頁面 > 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 Installer 命令列選項。

屬性描述預設值
ENABLEDESKTOPSHORTCUT建立桌面快捷方式。1
INSTALLFOLDER指定 Docker Desktop 的自定義安裝位置。C:\Program Files\Docker
ADMINSETTINGS自動建立 admin-settings.json 檔案，用於控制組織內部客戶端機器上的某些 Docker Desktop 設定。必須與 ALLOWEDORG 屬性一起使用。無
ALLOWEDORG要求使用者在執行應用程式時登入並屬於指定的 Docker Hub 組織。這會在 HKLM\Software\Policies\Docker\Docker Desktop 中建立一個名為 allowedOrgs 的登錄檔項。無
ALWAYSRUNSERVICE允許使用者無需管理員許可權即可切換到 Windows 容器0
DISABLEWINDOWSCONTAINERS停用 Windows 容器整合0
ENGINE設定用於執行容器的 Docker Engine。可以是 wsl、hyperv 或 windows。wsl
PROXYENABLEKERBEROSNTLM設定為 1 時，啟用對 Kerberos 和 NTLM 代理認證的支援。適用於 Docker Desktop 4.33 及更高版本。0
PROXYHTTPMODE設定 HTTP 代理模式。可以是 system 或 manual。system
OVERRIDEPROXYHTTP設定用於傳出 HTTP 請求的 HTTP 代理 URL。無
OVERRIDEPROXYHTTPS設定用於傳出 HTTPS 請求的 HTTP 代理 URL。無
OVERRIDEPROXYEXCLUDE繞過主機和域的代理設定。使用逗號分隔的列表。無
HYPERVDEFAULTDATAROOT指定 Hyper-V 虛擬機器磁碟的預設位置。無
WINDOWSCONTAINERSDEFAULTDATAROOT指定 Windows 容器的預設位置。無
WSLDEFAULTDATAROOT指定 WSL 分發磁碟的預設位置。無
DISABLEANALYTICS設定為 1 時，將停用 MSI 的分析資料收集。有關更多資訊，請參閱分析。0

此外，您還可以使用 /norestart 或 /forcerestart 控制重啟行為。

預設情況下，安裝程式在成功安裝後會重啟機器。靜默執行時，重啟是自動進行的，不會提示使用者。

分析

MSI 安裝程式僅收集與安裝相關的匿名使用統計資訊。這有助於更好地瞭解使用者行為，並透過識別和解決問題或最佳化常用功能來改善使用者體驗。

如何選擇退出

當您從預設安裝程式 GUI 安裝 Docker Desktop 時，請勾選位於歡迎對話方塊左下角的停用分析資料複選框。

當您從命令列安裝 Docker Desktop 時，請使用 DISABLEANALYTICS 屬性。

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

永續性

如果您決定在安裝時停用分析資料，您的選擇將儲存在登錄檔中，並在將來的升級和解除安裝中得到遵守。

但是，當 Docker Desktop 解除安裝時，該登錄檔項會被移除，並且必須透過之前的方法之一重新配置。

登錄檔項如下

SOFTWARE\Docker Inc.\Docker Desktop\DisableMsiAnalytics

停用分析資料時，此項設定為 1。

附加資源

頁面選項