# Instalador MSI 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 1. En [Docker Home](http://app.docker.com), elige tu organización. 2. Selecciona **Admin Console** (Consola de administración) y luego **Enterprise deployment** (Despliegue empresarial). 3. En la pestaña **Windows OS**, selecciona el botón **Download MSI installer** (Descargar instalador MSI). 4. Una vez descargado, haz doble clic en `Docker Desktop Installer.msi` para ejecutar el instalador. 5. 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). 6. 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. 7. Sigue las instrucciones del asistente de instalación para autorizar el instalador y proceder con la instalación. 8. 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: 1. Ejecuta **Administración de equipos** (Computer Management) como **administrador**. 2. Navega a **Usuarios y grupos locales** (Local Users and Groups) > **Grupos** (Groups) > **docker-users**. 3. Haz clic derecho para agregar al usuario al grupo. 4. 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](/enterprise/security/hardened-desktop/settings-management). > > 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](/desktop/release-notes/). ## 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](#configuration-options). 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) ```powershell msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" ``` #### Instalar de forma interactiva sin registro detallado ```powershell msiexec /i "DockerDesktop.msi" ``` #### Instalar de forma no interactiva con registro detallado ```powershell msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet ``` #### Instalar de forma no interactiva y evitando reinicios ```powershell msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet /norestart ``` #### Instalar de forma no interactiva con ajustes de administración ```powershell 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 ```powershell msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet /norestart ALLOWEDORG="your-organization" ALWAYSRUNSERVICE=1 ``` #### Instalar de forma interactiva especificando un archivo PAC ```powershell 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 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: ```powershell 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: ```powershell Get-WmiObject Win32_Product | Select-Object IdentifyingNumber, Name | Where-Object {$_.Name -eq "Docker Desktop"} ``` Debería devolver una salida similar a la siguiente: ```text 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: ```powershell msiexec /x {10FC87E2-9145-4D7D-B493-2E99E8D8E103} /L*V ".\msi.log" /quiet ``` #### Desinstalar de forma interactiva con registro detallado ```powershell msiexec /x "DockerDesktop.msi" /L*V ".\msi.log" ``` #### Desinstalar de forma interactiva sin registro detallado ```powershell msiexec /x "DockerDesktop.msi" ``` #### Desinstalar de forma no interactiva con registro detallado ```powershell msiexec /x "DockerDesktop.msi" /L*V ".\msi.log" /quiet ``` #### Desinstalar de forma no interactiva sin registro detallado ```powershell 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](https://learn.microsoft.com/en-us/windows/win32/msi/standard-installer-command-line-options). | 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](/enterprise/security/hardened-desktop/settings-management/) 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](#analisis). | 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 **Desde la GUI** 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). **Desde la línea de comandos** Al instalar Docker Desktop desde la línea de comandos, utiliza la propiedad `DISABLEANALYTICS`. ```powershell 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: ```powershell 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](/enterprise/enterprise-deployment/faq/)