⚠️ Traduction non officielle - Cette documentation est une traduction communautaire non officielle de Docker.

Installateur MSI

Subscription: Business
Requires: Docker Desktop 4.32 and later
For: Administrators

Le paquet MSI prend en charge diverses solutions MDM (Mobile Device Management), ce qui le rend idéal pour les installations en masse et élimine le besoin de configurations manuelles par les utilisateurs individuels. Avec ce paquet, les administrateurs IT peuvent assurer des installations standardisées et pilotées par des politiques de Docker Desktop, améliorant l'efficacité et la gestion logicielle dans leurs organisations.

Installer de manière interactive

  1. Dans la Console d'Administration Docker, naviguez vers votre organisation.

  2. Sous Docker Desktop, sélectionnez la page Deploy.

  3. Depuis l'onglet Windows OS, sélectionnez le bouton Download MSI installer.

  4. Une fois téléchargé, double-cliquez sur Docker Desktop Installer.msi pour lancer l'installateur.

  5. Après avoir accepté l'accord de licence, choisissez l'emplacement d'installation. Par défaut, Docker Desktop est installé dans C:\Program Files\Docker\Docker.

  6. Configurez l'installation de Docker Desktop. Vous pouvez :

    • Créer un raccourci sur le bureau

    • Définir le type de démarrage du service Docker Desktop sur automatique

    • Désactiver l'utilisation des conteneurs Windows

    • Sélectionner le backend Docker Desktop : WSL ou Hyper-V. Si un seul est pris en charge par votre système, vous ne pourrez pas choisir.

  7. Suivez les instructions de l'assistant d'installation pour autoriser l'installateur et procéder à l'installation.

  8. Lorsque l'installation est réussie, sélectionnez Finish pour terminer le processus d'installation.

Si votre compte administrateur est différent de votre compte utilisateur, vous devez ajouter l'utilisateur au groupe docker-users :

  1. Exécutez Gestion de l'ordinateur en tant qu'administrateur.
  2. Naviguez vers Utilisateurs et groupes locaux > Groupes > docker-users.
  3. Cliquez avec le bouton droit pour ajouter l'utilisateur au groupe.
  4. Déconnectez-vous et reconnectez-vous pour que les changements prennent effet.
Note

Lors de l'installation de Docker Desktop avec le MSI, les mises à jour intégrées sont automatiquement désactivées. Cela garantit que les organisations peuvent maintenir la cohérence des versions et empêcher les mises à jour non approuvées. Pour Docker Desktop installé avec l'installateur .exe, les mises à jour intégrées restent prises en charge.

Docker Desktop vous notifie lorsqu'une mise à jour est disponible. Pour mettre à jour Docker Desktop, téléchargez le dernier installateur depuis la Console d'Administration Docker. Naviguez vers la page Deploy > sous Docker Desktop.

Pour rester à jour avec les nouvelles versions, consultez la page notes de version.

Installer depuis la ligne de commande

Cette section couvre les installations en ligne de commande de Docker Desktop en utilisant PowerShell. Elle fournit des commandes d'installation communes que vous pouvez exécuter. Vous pouvez également ajouter des arguments supplémentaires qui sont décrits dans les options de configuration.

Lors de l'installation de Docker Desktop, vous pouvez choisir entre des installations interactives ou non-interactives.

Les installations interactives, sans spécifier /quiet ou /qn, affichent l'interface utilisateur et vous permettent de sélectionner vos propres propriétés.

Lors de l'installation via l'interface utilisateur, il est possible de :

  • Choisir le dossier de destination
  • Créer un raccourci sur le bureau
  • Configurer le type de démarrage du service Docker Desktop
  • Désactiver les conteneurs Windows
  • Choisir entre le moteur WSL ou Hyper-V

Les installations non-interactives sont silencieuses et toute configuration supplémentaire doit être passée comme arguments.

Commandes d'installation communes

Important

Les droits d'administrateur sont requis pour exécuter l'une des commandes suivantes.

Installer de manière interactive avec journalisation détaillée

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

Installer de manière interactive sans journalisation détaillée

msiexec /i "DockerDesktop.msi"

Installer de manière non-interactive avec journalisation détaillée

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

Installer de manière non-interactive en supprimant les redémarrages

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

Installer de manière non-interactive avec paramètres d'administration

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

Installer de manière interactive et permettre aux utilisateurs de basculer vers les conteneurs Windows sans droits d'administrateur

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

Installer avec l'option d'affichage passif

Vous pouvez utiliser l'option d'affichage /passive au lieu de /quiet lorsque vous voulez effectuer une installation non-interactive mais afficher une boîte de dialogue de progression.

En mode passif, l'installateur n'affiche aucune invite ou message d'erreur à l'utilisateur et l'installation ne peut pas être annulée.

Par exemple :

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

Lors de la création d'une valeur qui attend une chaîne JSON :

  • La propriété attend une chaîne formatée JSON
  • La chaîne doit être entourée de guillemets doubles
  • La chaîne ne doit contenir aucun espace
  • Les noms de propriétés sont attendus entre guillemets doubles

Commandes de désinstallation communes

Lors de la désinstallation de Docker Desktop, vous devez utiliser le même fichier .msi qui a été utilisé à l'origine pour installer l'application.

Si vous n'avez plus le fichier .msi original, vous devez utiliser le code produit associé à l'installation. Pour trouver le code produit, exécutez :

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

Il devrait retourner une sortie similaire à ce qui suit :

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

Cette commande peut prendre du temps, selon le nombre d'applications installées.

IdentifyingNumber est le code produit de l'application et peut être utilisé pour désinstaller Docker Desktop. Par exemple :

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

Désinstaller de manière interactive avec journalisation détaillée

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

Désinstaller de manière interactive sans journalisation détaillée

msiexec /x "DockerDesktop.msi"

Désinstaller de manière non-interactive avec journalisation détaillée

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

Désinstaller de manière non-interactive sans journalisation détaillée

msiexec /x "DockerDesktop.msi" /quiet

Options de configuration

Important

En plus des propriétés personnalisées suivantes, l'installateur MSI Docker Desktop prend également en charge les options de ligne de commande standard de Windows Installer.

Propriété Description Défaut
ENABLEDESKTOPSHORTCUT Crée un raccourci sur le bureau. 1
INSTALLFOLDER Spécifie un emplacement personnalisé où Docker Desktop sera installé. C:\Program Files\Docker
ADMINSETTINGS Crée automatiquement un fichier admin-settings.json qui est utilisé pour contrôler certains paramètres Docker Desktop sur les machines clientes au sein des organisations. Il doit être utilisé avec la propriété ALLOWEDORG. Aucun
ALLOWEDORG Exige que l'utilisateur se connecte et fasse partie de l'organisation Docker Hub spécifiée lors de l'exécution de l'application. Cela crée une clé de registre appelée allowedOrgs dans HKLM\Software\Policies\Docker\Docker Desktop. Aucun
ALWAYSRUNSERVICE Permet aux utilisateurs de basculer vers les conteneurs Windows sans avoir besoin de droits d'administrateur 0
DISABLEWINDOWSCONTAINERS Désactive l'intégration des conteneurs Windows 0
ENGINE Définit le moteur Docker utilisé pour exécuter les conteneurs. Cela peut être soit wsl, hyperv, ou windows wsl
PROXYENABLEKERBEROSNTLM Lorsque défini à 1, active le support pour l'authentification proxy Kerberos et NTLM. Disponible avec Docker Desktop 4.33 et ultérieur 0
PROXYHTTPMODE Définit le mode Proxy HTTP. Cela peut être soit system ou manual system
OVERRIDEPROXYHTTP Définit l'URL du proxy HTTP qui doit être utilisé pour les requêtes HTTP sortantes. Aucun
OVERRIDEPROXYHTTPS Sets the URL of the HTTP proxy that must be used for outgoing HTTPS requests. None
OVERRIDEPROXYEXCLUDE Bypasses proxy settings for the hosts and domains. Uses a comma-separated list. None
HYPERVDEFAULTDATAROOT Specifies the default location for the Hyper-V VM disk. None
WINDOWSCONTAINERSDEFAULTDATAROOT Specifies the default location for Windows containers. None
WSLDEFAULTDATAROOT Specifies the default location for the WSL distribution disk. None
DISABLEANALYTICS When set to 1, analytics collection will be disabled for the MSI. For more information, see Analytics. 0

Additionally, you can also use /norestart or /forcerestart to control reboot behaviour.

By default, the installer reboots the machine after a successful installation. When run silently, the reboot is automatic and the user is not prompted.

Analytics

The MSI installer collects anonymous usage statistics relating to installation only. This is to better understand user behaviour and to improve the user experience by identifying and addressing issues or optimizing popular features.

How to opt-out

When you install Docker Desktop from the default installer GUI, select the Disable analytics checkbox located on the bottom-left corner of the Welcome dialog.

When you install Docker Desktop from the command line, use the DISABLEANALYTICS property.

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

Persistence

If you decide to disable analytics for an installation, your choice is persisted in the registry and honoured across future upgrades and uninstalls.

However, the key is removed when Docker Desktop is uninstalled and must be configured again via one of the previous methods.

The registry key is as follows:

SOFTWARE\Docker Inc.\Docker Desktop\DisableMsiAnalytics

When analytics is disabled, this key is set to 1.

Additional resources