Instalador MSI

Tabla de contenidos

Suscripción: Business

Para: Administradores

El paquete MSI admite varias soluciones de MDM (Mobile Device Management o Gestión de dispositivos móviles), lo que lo hace ideal para instalaciones masivas y elimina la necesidad de configuraciones manuales por parte de usuarios individuales. Con este paquete, los administradores de TI pueden asegurar instalaciones estandarizadas y basadas en políticas de Docker Desktop, mejorando la eficiencia y la gestión del software en sus organizaciones.

Instalar de forma interactiva

En Docker Home, elige tu organización.
Selecciona Admin Console (Consola de administración) y luego Enterprise deployment (Despliegue empresarial).
En la pestaña Windows OS, selecciona el botón Download MSI installer (Descargar instalador MSI).
Una vez descargado, haz doble clic en Docker Desktop Installer.msi para ejecutar el instalador.
Después de aceptar el acuerdo de licencia, elige la ubicación de instalación. De forma predeterminada, Docker Desktop se instala en C:\Program Files\Docker\Docker (instalaciones para todos los usuarios) o en %LOCALAPPDATA%\Programs\DockerDesktop (instalaciones por usuario).
Configura la instalación de Docker Desktop. Puedes:
- Crear un acceso directo en el escritorio
- Configurar el tipo de inicio del servicio Docker Desktop como automático
- Deshabilitar el uso de contenedores Windows
- Seleccionar el motor de Docker Desktop: WSL o Hyper-V. Si tu sistema solo admite uno, no podrás elegir.
Sigue las instrucciones del asistente de instalación para autorizar el instalador y proceder con la instalación.
Cuando la instalación se complete correctamente, selecciona Finish (Finalizar) para terminar el proceso de instalación.

Si tu cuenta de administrador es diferente de tu cuenta de usuario, debes agregar al usuario al grupo docker-users para acceder a funciones que requieren mayores privilegios, como crear y administrar la VM de Hyper-V o usar contenedores de Windows:

Ejecuta Administración de equipos (Computer Management) como administrador.
Navega a Usuarios y grupos locales (Local Users and Groups) > Grupos (Groups) > docker-users.
Haz clic derecho para agregar al usuario al grupo.
Cierra sesión y vuelve a iniciarla para que los cambios surtan efecto.

Note
Al instalar Docker Desktop con el MSI, las actualizaciones integradas en la aplicación se desactivan automáticamente por defecto. Esto garantiza que las organizaciones puedan mantener la consistencia de la versión y evitar actualizaciones no aprobadas. A partir de la versión 4.60 de Docker Desktop y posteriores, las actualizaciones dentro de la aplicación desde una instalación de MSI se pueden habilitar cambiando la configuración disableUpdate a false a través de la Gestión de Ajustes.
Docker Desktop te notifica cuando hay una actualización disponible. Para actualizar Docker Desktop, descarga el instalador más reciente desde la consola de administración de Docker (Docker Admin Console). Navega a la página Enterprise deployment.
Para mantenerte al día con las nuevas versiones, consulta la página de notas de la versión.

Instalar desde la línea de comandos

Esta sección cubre las instalaciones de Docker Desktop desde la línea de comandos utilizando PowerShell. Proporciona comandos de instalación comunes que puedes ejecutar. También puedes añadir argumentos adicionales que se describen en las opciones de configuración.

Al instalar Docker Desktop, puedes elegir entre instalaciones interactivas o no interactivas.

Las instalaciones interactivas, sin especificar /quiet o /qn, muestran la interfaz de usuario y te permiten seleccionar tus propias propiedades.

Al instalar a través de la interfaz de usuario es posible:

Elegir la carpeta de destino
Crear un acceso directo en el escritorio
Configurar el tipo de inicio del servicio Docker Desktop
Deshabilitar los contenedores de Windows
Elegir entre el motor WSL o Hyper-V

Las instalaciones no interactivas son silenciosas y cualquier configuración adicional debe pasarse como argumentos.

Comandos de instalación comunes

Se requieren derechos de administrador para ejecutar cualquiera de los siguientes comandos.

Instalar de forma interactiva con registro detallado (verbose)

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log"

Instalar de forma interactiva sin registro detallado

msiexec /i "DockerDesktop.msi"

Instalar de forma no interactiva con registro detallado

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet

Instalar de forma no interactiva y evitando reinicios

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet /norestart

Instalar de forma no interactiva con ajustes de administración

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet /norestart ADMINSETTINGS="{""configurationFileVersion"":2,""enhancedContainerIsolation"":{""value"":true,""locked"":false}}" ALLOWEDORG="your-organization"

Instalar de forma interactiva y permitir a los usuarios cambiar a contenedores de Windows sin derechos de administrador

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

Instalar de forma interactiva especificando un archivo PAC

PowerShell
 msiexec --% /i "DockerDesktop.msi" /L*V ".\msi.log"  PROXYHTTPMODE="manual" OVERRIDEPROXYPAC="http://localhost:8080/myproxy.pac"

Instalar de forma interactiva especificando un script PAC

PowerShell
 msiexec --% /i "DockerDesktop.msi" /L*V ".\msi.log"  PROXYHTTPMODE="manual" OVERRIDEPROXYEMBEDDEDPAC="function FindProxyForURL(url,host) {return ""DIRECT"" ;; }"

Instalar con la opción de visualización pasiva

Puedes usar la opción de visualización /passive en lugar de /quiet cuando desees realizar una instalación no interactiva pero mostrando un diálogo de progreso.

En modo pasivo, el instalador no muestra ninguna solicitud ni mensaje de error al usuario y la instalación no se puede cancelar.

Por ejemplo:

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /passive /norestart

Tip
Al crear un valor que espera una cadena JSON:
La propiedad espera una cadena formateada en JSON
La cadena debe estar envuelta en comillas dobles
La cadena no debe contener espacios en blanco
Se espera que los nombres de las propiedades estén entre comillas dobles

Comandos de desinstalación comunes

Al desinstalar Docker Desktop, debes utilizar el mismo archivo .msi que se utilizó originalmente para instalar la aplicación.

Si ya no tienes el archivo .msi original, debes utilizar el código de producto asociado con la instalación. Para encontrar el código de producto, ejecuta:

Get-WmiObject Win32_Product | Select-Object IdentifyingNumber, Name | Where-Object {$_.Name -eq "Docker Desktop"}

Debería devolver una salida similar a la siguiente:

IdentifyingNumber                      Name
-----------------                      ----
{10FC87E2-9145-4D7D-B493-2E99E8D8E103} Docker Desktop

Note
Este comando puede tardar algún tiempo, dependiendo del número de aplicaciones instaladas.

IdentifyingNumber es el código de producto de la aplicación y se puede utilizar para desinstalar Docker Desktop. Por ejemplo:

msiexec /x {10FC87E2-9145-4D7D-B493-2E99E8D8E103} /L*V ".\msi.log" /quiet

Desinstalar de forma interactiva con registro detallado

msiexec /x "DockerDesktop.msi" /L*V ".\msi.log"

Desinstalar de forma interactiva sin registro detallado

msiexec /x "DockerDesktop.msi"

Desinstalar de forma no interactiva con registro detallado

msiexec /x "DockerDesktop.msi" /L*V ".\msi.log" /quiet

Desinstalar de forma no interactiva sin registro detallado

msiexec /x "DockerDesktop.msi" /quiet

Opciones de configuración

Además de las siguientes propiedades personalizadas, el instalador MSI de Docker Desktop también admite las opciones de línea de comandos estándar de Windows Installer.

Propiedad	Descripción	Por defecto
`ENABLEDESKTOPSHORTCUT`	Crea un acceso directo en el escritorio.	1
`INSTALLFOLDER`	Especifica una ubicación personalizada donde se instalará Docker Desktop.	C:\Program Files\Docker
`ADMINSETTINGS`	Crea automáticamente un archivo `admin-settings.json` que se utiliza para controlar ciertos ajustes de Docker Desktop en las máquinas cliente dentro de las organizaciones. Debe usarse junto con la propiedad `ALLOWEDORG`.	Ninguno
`ALLOWEDORG`	Requiere que el usuario inicie sesión y forme parte de la organización de Docker Hub especificada al ejecutar la aplicación. Esto crea una clave de registro llamada `allowedOrgs` en `HKLM\Software\Policies\Docker\Docker Desktop`.	Ninguno
`ALWAYSRUNSERVICE`	Permite a los usuarios cambiar a contenedores de Windows sin necesidad de derechos de administrador.	0
`DISABLEWINDOWSCONTAINERS`	Deshabilita la integración de contenedores de Windows.	0
`ENGINE`	Establece el motor de Docker que se utiliza para ejecutar contenedores. Puede ser `wsl`, `hyperv` o `windows`.	`wsl`
`PROXYENABLEKERBEROSNTLM`	Cuando se establece en 1, habilita el soporte para la autenticación de proxy Kerberos y NTLM.	0
`PROXYHTTPMODE`	Establece el modo de proxy HTTP. Puede ser `system` o `manual`.	`system`
`OVERRIDEPROXYHTTP`	Establece la URL del proxy HTTP que debe usarse para las solicitudes HTTP salientes.	Ninguno
`OVERRIDEPROXYHTTPS`	Establece la URL del proxy HTTP que debe usarse para las solicitudes HTTPS salientes.	Ninguno
`OVERRIDEPROXYEXCLUDE`	Omite la configuración del proxy para los hosts y dominios. Utiliza una lista separada por comas.	Ninguno
`OVERRIDEPROXYPAC`	Establece la URL del archivo PAC. Esta configuración solo tiene efecto cuando se utiliza el modo de proxy `manual`.	Ninguno
`OVERRIDEPROXYEMBEDDEDPAC`	Especifica un script PAC (Proxy Auto-config) incrustado. Esta configuración solo tiene efecto cuando se utiliza el modo de proxy `manual` y tiene precedencia sobre la bandera `OVERRIDEPROXYPAC`.	Ninguno
`HYPERVDEFAULTDATAROOT`	Especifica la ubicación predeterminada para el disco de la VM de Hyper-V.	Ninguno
`WINDOWSCONTAINERSDEFAULTDATAROOT`	Especifica la ubicación predeterminada para los contenedores de Windows.	Ninguno
`WSLDEFAULTDATAROOT`	Especifica la ubicación predeterminada para el disco de distribución de WSL.	Ninguno
`DISABLEANALYTICS`	Cuando se establece en 1, se desactivará la recopilación de análisis para el MSI. Para obtener más información, consulta Análisis.	0
`REMOVEEXISTINGINSTALL`	Cuando se establece en 1, se eliminan las instalaciones EXE existentes. Se conservan las configuraciones y el contenido existentes. Disponible con la versión 4.61 de Docker Desktop y posteriores.	1

Además, también puedes utilizar /norestart o /forcerestart para controlar el comportamiento del reinicio.

De forma predeterminada, el instalador reinicia la máquina después de una instalación exitosa. Cuando se ejecuta de forma silenciosa, el reinicio es automático y no se le pregunta al usuario.

Análisis

El instalador MSI recopila estadísticas de uso anónimas relacionadas únicamente con la instalación. Esto es para comprender mejor el comportamiento del usuario y mejorar la experiencia de usuario al identificar y solucionar problemas u optimizar las funciones más populares.

Cómo optar por no participar

Al instalar Docker Desktop desde la GUI del instalador predeterminada, selecciona la casilla de verificación Disable analytics (Desactivar análisis) ubicada en la esquina inferior izquierda del diálogo de Welcome (Bienvenida).

Al instalar Docker Desktop desde la línea de comandos, utiliza la propiedad DISABLEANALYTICS.

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

Persistencia

Si decides deshabilitar los análisis para una instalación, tu elección persistirá en el registro y se respetará en futuras actualizaciones y desinstalaciones.

Sin embargo, la clave se elimina cuando se desinstala Docker Desktop y debe configurarse de nuevo a través de uno de los métodos anteriores.

La clave del registro es la siguiente:

SOFTWARE\Docker Inc.\Docker Desktop\DisableMsiAnalytics

Cuando los análisis están deshabilitados, esta clave se establece en 1.

Recursos adicionales

Explorar las Preguntas frecuentes

¿En qué te puedo ayudar?

Instalador MSI