Merge pull request #22745 from aevesdocker/ENGDOCS-2680

desktop: ms store deploy

content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md

@@ -0,0 +1,45 @@
+---
+title: Install Docker Desktop from the Microsoft Store on Windows
+linkTitle: MS Store
+description: Install Docker Desktop for Windows through the Microsoft Store. Understand its update behavior and limitations. 
+keywords: microsoft store, windows, docker desktop, install, deploy, configure, admin, mdm, intune, winget
+tags: [admin]
+weight: 30
+---
+
+You can deploy Docker Desktop for Windows through the [Microsoft app store](https://apps.microsoft.com/detail/xp8cbj40xlbwkx?hl=en-GB&gl=GB).
+
+The Microsoft Store version of Docker Desktop provides the same functionality as the standard installer but has a different update behavior depending on whether your developers install it themselves or if installation is handled by an MDM tool such as Intune. This is described in the following section. 
+
+Choose the installation method that best aligns with your environment's requirements and management practices.
+
+## Update behavior
+
+### Developer-managed installations
+
+For developers who install Docker Desktop directly:
+
+- The Microsoft Store does not automatically update Win32 apps like Docker Desktop for most users.
+- Only a subset of users (approximately 20%) may receive update notifications on the Microsoft Store page.
+- Most users must manually check for and apply updates within the Store.
+
+### Intune-managed installations
+
+In environments managed with Intune:
+- Intune checks for updates approximately every 8 hours.
+- When a new version is detected, Intune triggers a `winget` upgrade.  
+- If appropriate policies are configured, updates can occur automatically without user intervention. 
+- Updates are handled by Intune's management infrastructure rather than the Microsoft Store itself.
+
+## WSL considerations
+
+Docker Desktop for Windows integrates closely with WSL. When updating Docker Desktop installed from the Microsoft Store:
+- Make sure you have quit Docker Desktop and that it is no longer running so updates can complete successfully
+- In some environments, virtual hard disk (VHDX) file locks may prevent the update from completing.
+
+## Recommendations for Intune management
+
+If using Intune to manage Docker Desktop for Windows:
+- Ensure your Intune policies are configured to handle application updates
+- Be aware that the update process uses WinGet APIs rather than direct Store mechanisms
+- Consider testing the update process in a controlled environment to verify proper functionality

content/manuals/desktop/setup/install/enterprise-deployment/use-intune.md

@@ -3,7 +3,7 @@ title: Deploy with Intune
 description: Use Intune, Microsoft's cloud-based device management tool, to deploy Docker Desktop
 keywords: microsoft, windows, docker desktop, deploy, mdm, enterprise, administrator, mac, pkg, dmg
 tags: [admin]
-weight: 30
+weight: 40
 aliases:
 - /desktop/install/msi/use-intune/
 - /desktop/setup/install/msi/use-intune/

content/manuals/desktop/setup/install/enterprise-deployment/use-jamf-pro.md

@@ -3,7 +3,7 @@ title: Deploy with Jamf Pro
 description: Use Jamf Pro to deploy Docker Desktop for Mac
 keywords: jamf, mac, docker desktop, deploy, mdm, enterprise, administrator, pkg
 tags: [admin]
-weight: 40
+weight: 50
 ---
 
 {{< summary-bar feature_name="Jamf Pro" >}}