MSI 安裝程式
MSI 軟體包支援各種 MDM(移動裝置管理)解決方案,非常適合批次安裝,省去了個人使用者手動設定的需要。透過此軟體包,IT 管理員可以確保 Docker Desktop 的標準化、策略驅動型安裝,從而提高組織內部的效率和軟體管理水平。
互動式安裝
在 Docker Home 中,選擇您的組織。
選擇 Admin Console,然後選擇 Enterprise deployment。
從 Windows OS 選項卡中,選擇 Download MSI installer 按鈕。
下載完成後,雙擊
Docker Desktop Installer.msi
執行安裝程式。接受許可協議後,選擇安裝位置。預設情況下,Docker Desktop 安裝在
C:\Program Files\Docker\Docker
。配置 Docker Desktop 安裝。您可以
建立桌面快捷方式
將 Docker Desktop 服務啟動型別設定為自動
停用 Windows 容器使用
選擇 Docker Desktop 後端:WSL 或 Hyper-V。如果您的系統僅支援其中一個,則無法選擇。
按照安裝嚮導上的說明授權安裝程式並繼續安裝。
安裝成功後,選擇 Finish 完成安裝過程。
如果您的管理員帳戶與使用者帳戶不同,則必須將使用者新增到 docker-users 組,才能訪問需要更高許可權的功能,例如建立和管理 Hyper-V VM,或使用 Windows 容器
- 以管理員身份執行計算機管理。
- 導航到本地使用者和組 > 組 > docker-users。
- 右鍵單擊以將使用者新增到組中。
- 登出並重新登入以使更改生效。
注意使用 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 命令列選項。
屬性 | 描述 | 預設值 |
---|---|---|
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 VM 磁碟的預設位置。 | 無 |
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
。