使用 MSI 安裝程式

注意

MSI 安裝程式適用於所有擁有商業訂閱且 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 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 安裝程式命令列選項

屬性說明預設值
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 引擎。可以是 wslhypervwindowswsl
PROXYENABLEKERBEROSNTLM設定為 1 時,會啟用對 Kerberos 和 NTLM 代理驗證的支援。適用於 Docker Desktop 4.33 及更高版本0
PROXYHTTPMODE設定 HTTP 代理模式。可以是 systemmanualsystem
OVERRIDEPROXYHTTP設定必須用於輸出 HTTP 請求的 HTTP 代理 URL。
OVERRIDEPROXYHTTPS設定必須用於輸出 HTTPS 請求的 HTTP 代理 URL。
OVERRIDEPROXYEXCLUDE略過主機和網域的代理設定。使用逗號分隔的清單。
HYPERVDEFAULTDATAROOT指定 Hyper-V 虛擬機器磁碟的預設位置。
WINDOWSCONTAINERSDEFAULTDATAROOT指定 Windows 容器的預設位置。
WSLDEFAULTDATAROOT指定 WSL 發行版本磁碟的預設位置。
DISABLEANALYTICS設定為 1 時,將會針對 MSI 停用分析收集。如需詳細資訊,請參閱 分析0

此外,您也可以使用 /norestart/forcerestart 來控制重新啟動行為。

預設情況下,安裝程式會在安裝成功後重新啟動電腦。以無訊息模式執行時,重新啟動會自動執行,且不會提示使用者。

分析

MSI 安裝程式會收集匿名使用統計資訊,以更好地了解使用者行為,並透過識別和解決問題或最佳化熱門功能來改善使用者體驗。

如何退出


當您從預設安裝程式圖形使用者介面安裝 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

其他資源