mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-05-18 16:27:22 +00:00
92 lines
4.7 KiB
Markdown
92 lines
4.7 KiB
Markdown
---
|
|
title: Add Microsoft Store for Business applications to a Windows 10 image
|
|
description: This article describes the correct way to add Microsoft Store for Business applications to a Windows 10 image.
|
|
ms.prod: windows-client
|
|
ms.localizationpriority: medium
|
|
author: frankroj
|
|
ms.author: frankroj
|
|
ms.reviewer:
|
|
manager: aaroncz
|
|
ms.topic: article
|
|
ms.custom: seo-marvel-apr2020
|
|
ms.date: 11/23/2022
|
|
ms.technology: itpro-deploy
|
|
---
|
|
|
|
# Add Microsoft Store for Business applications to a Windows 10 image
|
|
|
|
*Applies to:*
|
|
|
|
- Windows 10
|
|
|
|
This article describes the correct way to add Microsoft Store for Business applications to a Windows 10 image. Adding Microsoft Store for Business applications to a Windows 10 image will enable you to deploy Windows 10 with pre-installed Microsoft Store for Business apps.
|
|
|
|
> [!IMPORTANT]
|
|
> In order for Microsoft Store for Business applications to persist after image deployment, these applications need to be pinned to Start prior to image deployment.
|
|
|
|
## Prerequisites
|
|
|
|
- [Windows Assessment and Deployment Kit (Windows ADK)](windows-adk-scenarios-for-it-pros.md) for the tools required to mount and edit Windows images.
|
|
|
|
- Download an offline signed app package and license of the application you would like to add through [Microsoft Store for Business](/microsoft-store/distribute-offline-apps#download-an-offline-licensed-app).
|
|
- A Windows Image. For instructions on image creation, see [Create a Windows 10 reference image](deploy-windows-mdt/create-a-windows-10-reference-image.md).
|
|
|
|
> [!NOTE]
|
|
> If you'd like to add an internal LOB Microsoft Store application, please follow the instructions on **[Sideload line of business (LOB) apps in Windows client devices](/windows/application-management/sideload-apps-in-windows-10)**.
|
|
|
|
## Adding a Store application to your image
|
|
|
|
On a machine where your image file is accessible:
|
|
|
|
1. Open Windows PowerShell with administrator privileges.
|
|
|
|
2. Mount the image. At the Windows PowerShell prompt, enter:
|
|
`Mount-WindowsImage -ImagePath c:\images\myimage.wim -Index 1 -Path C:\test`
|
|
|
|
3. Use the Add-AppxProvisionedPackage cmdlet in Windows PowerShell to preinstall the app. Use the /PackagePath option to specify the location of the Store package and /LicensePath to specify the location of the license .xml file. In Windows PowerShell, enter:
|
|
`Add-AppxProvisionedPackage -Path C:\test -PackagePath C:\downloads\appxpackage -LicensePath C:\downloads\appxpackage\license.xml`
|
|
|
|
> [!NOTE]
|
|
> Paths and file names are examples. Use your paths and file names where appropriate.
|
|
>
|
|
> Do not dismount the image, as you will return to it later.
|
|
|
|
## Editing the Start Layout
|
|
|
|
In order for Microsoft Store for Business applications to persist after image deployment, these applications need to be pinned to Start prior to image deployment.
|
|
|
|
On a test machine:
|
|
|
|
1. **Install the Microsoft Store for Business application you previously added** to your image.
|
|
|
|
2. **Pin these apps to the Start screen**, by typing the name of the app, right-clicking and selecting **Pin to Start**.
|
|
|
|
3. Open Windows PowerShell with administrator privileges.
|
|
|
|
4. Use `Export-StartLayout -path <path><file name>.xml` where *\<path>\<file name>* is the path and name of the xml file your will later import into your Windows Image.
|
|
|
|
5. Copy the XML file you created to a location accessible by the machine you previously used to add Store applications to your image.
|
|
|
|
Now, on the machine where your image file is accessible:
|
|
|
|
1. Import the Start layout. At the Windows PowerShell prompt, enter:
|
|
`Import-StartLayout -LayoutPath "<path><file name>.xml" -MountPath "C:\test\"`
|
|
|
|
2. Save changes and dismount the image. At the Windows PowerShell prompt, enter:
|
|
`Dismount-WindowsImage -Path c:\test -Save`
|
|
|
|
> [!NOTE]
|
|
> Paths and file names are examples. Use your paths and file names where appropriate.
|
|
>
|
|
> For more information on Start customization, see [Windows 10 Start Layout Customization](/archive/blogs/deploymentguys/windows-10-start-layout-customization)
|
|
|
|
## Related articles
|
|
|
|
- [Customize and export Start layout](/windows/configuration/customize-and-export-start-layout)
|
|
- [Export-StartLayout](/powershell/module/startlayout/export-startlayout)
|
|
- [Import-StartLayout](/powershell/module/startlayout/import-startlayout)
|
|
- [Sideload line of business (LOB) apps in Windows client devices](/windows/application-management/sideload-apps-in-windows-10)
|
|
- [Prepare for Zero Touch Installation of Windows 10 with Configuration Manager](deploy-windows-cm/prepare-for-zero-touch-installation-of-windows-10-with-configuration-manager.md)
|
|
- [Deploy Windows 10 with the Microsoft Deployment Toolkit](./deploy-windows-mdt/prepare-for-windows-deployment-with-mdt.md)
|
|
- [Windows Assessment and Deployment Kit (Windows ADK)](windows-adk-scenarios-for-it-pros.md)
|