使用 MSI 安裝程式
注意
MSI 安裝程式適用於所有擁有商業訂閱且 Docker Desktop 版本為 4.32 或更高版本的公司和組織所有者。
MSI 套件支援各種 MDM(行動裝置管理)解決方案,使其成為大量安裝的理想選擇,並且無需個別使用者手動設定。透過此套件,IT 管理員可以確保 Docker Desktop 的標準化、策略驅動安裝,從而提高整個組織的效率和軟體管理。
互動式安裝
在 Docker 管理主控台 中,瀏覽至您的組織。
在「安全性與存取」下,選取「部署 Docker Desktop」頁面。
從「Windows 作業系統」索引標籤中,選取「下載 MSI 安裝程式」按鈕。
下載後,雙擊 `Docker Desktop Installer.msi` 以執行安裝程式。
接受授權合約後,您可以選擇安裝位置。預設情況下,Docker Desktop 安裝在 `C:\Program Files\Docker\Docker`。
設定 Docker Desktop 安裝。您可以
建立桌面捷徑
將 Docker Desktop 服務啟動類型設定為自動
停用 Windows 容器的使用
選擇 Docker Desktop 的引擎。WSL 或 Hyper-V。如果您的系統僅支援兩個選項之一,您將無法選擇要使用的後端。
按照安裝精靈上的指示授權安裝程式並繼續安裝。
安裝成功後,選擇「完成」以完成安裝過程。
如果您的管理員帳戶與使用者帳戶不同,您必須將使用者新增到 docker-users 群組。
- 以 系統管理員 身分執行 電腦管理。
- 瀏覽至 本機使用者和群組 > 群組 > docker-users。
- 按一下滑鼠右鍵,將使用者新增到群組。
- 登出並重新登入,以使變更生效。
注意
使用 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 引擎。可以是 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 安裝程式會收集匿名使用統計資訊,以更好地了解使用者行為,並透過識別和解決問題或最佳化熱門功能來改善使用者體驗。
如何退出
當您從預設安裝程式圖形使用者介面安裝 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
。