UniversalAppInstall (reference)

Use UniversalAppInstall settings to install Windows apps from the Microsoft Store or a hosted location.

Note

You can only use the Windows provisioning settings and provisioning packages for apps where you have the available installation files, namely with sideloaded apps that have an offline license. Learn more about offline app distribution.

Applies to

Setting Desktop editions Mobile editions Surface Hub HoloLens IoT Core
DeviceContextApp X X
DeviceContextAppLicense X X
StoreInstall X X X X
UserContextApp X X X X
UserContextAppLicense X X X X

DeviceContextApp

Enter an app package family name to install an app for all users of the device. You can use the Get-AppxPackage cmdlet to get the package family name for an installed app.

Note

For XAP files, enter the product ID.

For each app that you add to the package, configure the settings in the following table.

Setting Value Description
ApplicationFile .appx or .appxbundle Set the value to the app file that you want to install on the device. In addition, you must also enable the AllowAllTrustedApps setting and add a root certificate or license file.
DependencyAppxFiles any required frameworks In Microsoft Store for Business, any dependencies for the app are listed in the Required frameworks section of the download page.
DeploymentOptions - None
-Force application shutdown: If this package, or any package that depends on this package, is currently in use, the processes associated with the package are shut down forcibly so that registration can continue
- Development mode: do not use
- Install all resources: When you set ths option, the app is instructed to skip resource applicability checks.
- Force target application shutdown: If this package is currently in use, the processes associated with the package are shut down forcibly so that registration can continue
Select a deployment option.
LaunchAppAtLogin - Do not launch app
- Launch app
Set the value for app behavior when a user signs in.
OptionalPackageFiles additional files required by the package Browse to, select, and add the optional package files.

For more information on deployment options, see DeploymentOptions Enum.

DeviceContextAppLicense

Use to specify the license file for the provisioned app.

  1. Specify a LicenseProductId for the app. You can find the license ID in the root header of the license file. Here is an example, LicenseID="aaaaaaaa-dddd-8848-f8d0-7d6a93dfcccc". Enter it in the LicenseProductId field, and click Add.

  2. Select the LicenseProductId in the Available Customizations pane, and then browse to and select the app license file.

StoreInstall

Use to install an app from the Microsoft Store for Business.

  1. Enter a package family name, and then click Add.
  2. Configure the following required settings for the app package.
Setting Description
Flags Description not available at this time.
ProductID Enter the product ID. Learn how to find the product ID.
SkuID Enter the SKU ID. Learn how to find the SKU ID.

UserContextApp

Use to add a new user context app.

  1. Specify a PackageFamilyName for the app, and then click Add.
  2. Select the PackageFamilyName in the Available Customizations pane, and then configure the following settings.
Setting Value Description
ApplicationFile app file Browse to, select, and add the application file,
DependencyAppxFiles additional files required by the app Browse to, select, and add dependency files.
DeploymentOptions - None
- Force application shutdown

- Development mode

- Install all resources

- Force target application shutdown
Select a deployment option.
LaunchAppAtLogin - Do not launch app
- Launch app
Select whether the app should be started when a user signs in.

UserContextAppLicense

Use to specify the license file for the user context app.

  1. Specify a LicenseProductId for the app. You can find the license ID in the root header of the license file. Here is an example, LicenseID="aaaaaaaa-dddd-8848-f8d0-7d6a93dfcccc". Enter it in the LicenseProductId field, and click Add.

  2. Select the LicenseProductId in the Available Customizations pane, and then browse to and select the app license file.