mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-05-29 21:57:23 +00:00
84 lines
5.1 KiB
Markdown
84 lines
5.1 KiB
Markdown
---
|
|
title: UniversalAppInstall
|
|
description: This section describes the UniversalAppInstall settings that you can configure in provisioning packages for Windows 10 using Windows Configuration Designer.
|
|
ms.topic: reference
|
|
ms.date: 01/25/2024
|
|
---
|
|
|
|
# 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.](/microsoft-store/distribute-offline-apps)
|
|
|
|
## Applies to
|
|
|
|
| Setting | Windows client | Surface Hub | HoloLens | IoT Core |
|
|
|--|:-:|:-:|:-:|:-:|
|
|
| [DeviceContextApp](#devicecontextapp) | ✅ | ✅ | | |
|
|
| [DeviceContextAppLicense](#devicecontextapplicense) | ✅ | ✅ | | |
|
|
| [StoreInstall](#storeinstall) | ✅ | ✅ | | ✅ |
|
|
| [UserContextApp](#usercontextapp) | ✅ | ✅ | | ✅ |
|
|
| [UserContextAppLicense](#usercontextapplicense) | ✅ | ✅ | | ✅ |
|
|
|
|
## DeviceContextApp
|
|
|
|
Enter an app package family name to install an app for all device users. You can use the [Get-AppxPackage cmdlet](/powershell/module/appx/get-appxpackage) 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. Also enable the [AllowAllTrustedApps setting](wcd-policies.md#applicationmanagement) and add a root certificate or license file. |
|
|
| DependencyAppxFiles | Any required frameworks | Typically, dependencies for the app are listed undere **Required frameworks**. |
|
|
| DeploymentOptions | - None</br>-Force application shutdown: If this package, or any package that depends on this package is currently in use, then the processes associated with the package are forcibly shut down. The registration can continue. </br>- Development mode: Don't use. </br>- Install all resources: When you set this option, the app is instructed to skip resource applicability checks.</br>- 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 | - Don't launch app</br>- 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](/uwp/api/windows.management.deployment.deploymentoptions).
|
|
|
|
## 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. For example, enter `LicenseID="aaaaaaaa-dddd-8848-f8d0-7d6a93dfcccc"`. Enter it in the LicenseProductId field, and select **Add**.
|
|
1. 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 select **Add**.
|
|
1. 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.](/microsoft-store/microsoft-store-for-business-education-powershell-module#view-items-in-products-and-services) |
|
|
| SkuID | Enter the SKU ID. [Learn how to find the SKU ID.](/microsoft-store/microsoft-store-for-business-education-powershell-module#view-items-in-products-and-services) |
|
|
|
|
## UserContextApp
|
|
|
|
Use to add a new user context app.
|
|
|
|
1. Specify a **PackageFamilyName** for the app, and then select **Add**.
|
|
1. 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</br></br>- Force application shutdown</br></br>- Development mode</br></br>- Install all resources</br></br>- Force target application shutdown | Select a deployment option. |
|
|
| LaunchAppAtLogin | - Don't launch app</br></br>- 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. For example, enter `LicenseID="aaaaaaaa-dddd-8848-f8d0-7d6a93dfcccc"`. Enter it in the LicenseProductId field, and select **Add**.
|
|
1. Select the LicenseProductId in the Available Customizations pane, and then browse to and select the app license file.
|