4.7 KiB
title, description, keywords, ms.prod, ms.mktglfcycl, ms.localizationpriority, ms.sitesec, ms.pagetype, audience, author, ms.author, ms.reviewer, manager, ms.topic
| title | description | keywords | ms.prod | ms.mktglfcycl | ms.localizationpriority | ms.sitesec | ms.pagetype | audience | author | ms.author | ms.reviewer | manager | ms.topic |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Add Microsoft Store for Business applications to a Windows 10 image | This topic describes how to add Microsoft Store for Business applications to a Windows 10 image. | upgrade, update, windows, windows 10, deploy, store, image, wim | w10 | deploy | medium | library | deploy | itpro | greg-lindsay | greglin | laurawi | article |
Add Microsoft Store for Business applications to a Windows 10 image
Applies to
- Windows 10
This topic describes the correct way to add Microsoft Store for Business applications to a Windows 10 image. This 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) 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.
-
A Windows Image. For instructions on image creation, see Create a Windows 10 reference image.
Note
If you'd like to add an internal LOB Microsoft Store application, please follow the instructions on Sideload LOB apps in Windows 10.
Adding a Store application to your image
On a machine where your image file is accessible:
- Open Windows PowerShell with administrator privileges.
- Mount the image. At the Windows PowerShell prompt, type:
Mount-WindowsImage -ImagePath c:\images\myimage.wim -Index 1 -Path C:\test - 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, type:
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:
- Install the Microsoft Store for Business application you previously added to your image.
- Pin these apps to the Start screen, by typing the name of the app, right-clicking and selecting Pin to Start.
- Open Windows PowerShell with administrator privileges.
- Use
Export-StartLayout -path <path><file name>.xmlwhere <path><file name> is the path and name of the xml file your will later import into your Windows Image. - 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:
- Import the Start layout. At the Windows PowerShell prompt, type:
Import-StartLayout -LayoutPath "<path><file name>.xml" -MountPath "C:\test\" - Save changes and dismount the image. At the Windows PowerShell prompt, type:
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