deepblue/windows-itpro-docs
1
0
Fork 0
mirror of https://github.com/MicrosoftDocs/windows-itpro-docs.git synced 2025-05-12 13:27:23 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

application defaults with examples

Browse Source
This commit is contained in:
Liz Long 2022-12-09 13:50:42 -05:00
parent b81cc82464
commit 22f5d1eac8
1 changed files with 118 additions and 105 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

223
windows/client-management/mdm/policy-csp-applicationdefaults.md
View File

@ -1,80 +1,74 @@
--- ---
title: Policy CSP - ApplicationDefaults title: ApplicationDefaults Policy CSP
description: Learn about various Policy configuration service providers (CSP) - ApplicationDefaults, including SyncML, for Windows 10. description: Learn more about the ApplicationDefaults Area in Policy CSP
author: vinaypamnani-msft
manager: aaroncz
ms.author: vinpa ms.author: vinpa
ms.topic: article ms.date: 12/09/2022
ms.localizationpriority: medium
ms.prod: windows-client ms.prod: windows-client
ms.technology: itpro-manage ms.technology: itpro-manage
author: vinaypamnani-msft ms.topic: reference
ms.localizationpriority: medium
ms.date: 09/27/2019
ms.reviewer:
manager: aaroncz
--- ---
<!-- Auto-Generated CSP Document -->
<!-- ApplicationDefaults-Begin -->
# Policy CSP - ApplicationDefaults # Policy CSP - ApplicationDefaults
<!-- ApplicationDefaults-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- ApplicationDefaults-Editable-End -->
<!-- DefaultAssociationsConfiguration-Begin -->
## DefaultAssociationsConfiguration
<hr/> <!-- DefaultAssociationsConfiguration-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| :heavy_check_mark: Device <br> :x: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1703 [10.0.15063] and later |
<!-- DefaultAssociationsConfiguration-Applicability-End -->
<!--Policies--> <!-- DefaultAssociationsConfiguration-OmaUri-Begin -->
## ApplicationDefaults policies ```Device
./Device/Vendor/MSFT/Policy/Config/ApplicationDefaults/DefaultAssociationsConfiguration
```
<!-- DefaultAssociationsConfiguration-OmaUri-End -->
<dl> <!-- DefaultAssociationsConfiguration-Description-Begin -->
<dd> <!-- Description-Source-DDF -->
<a href="#applicationdefaults-defaultassociationsconfiguration">ApplicationDefaults/DefaultAssociationsConfiguration</a> This policy allows an administrator to set default file type and protocol associations. When set, default associations will be applied on sign-in to the PC. The association file can be created using the DISM tool (dism /online /export-defaultappassociations:appassoc. xml), and then needs to be base64 encoded before being added to SyncML. If policy is enabled and the client machine is Azure Active Directory joined, the associations assigned in SyncML will be processed and default associations will be applied.
</dd> <!-- DefaultAssociationsConfiguration-Description-End -->
<dd>
<a href="#applicationdefaults-enableappurihandlers">ApplicationDefaults/EnableAppUriHandlers</a>
</dd>
</dl>
<!-- DefaultAssociationsConfiguration-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- DefaultAssociationsConfiguration-Editable-End -->
<hr/> <!-- DefaultAssociationsConfiguration-DFProperties-Begin -->
**Description framework properties**:
<!--Policy--> | Property name | Property value |
<a href="" id="applicationdefaults-defaultassociationsconfiguration"></a>**ApplicationDefaults/DefaultAssociationsConfiguration** |:--|:--|
| Format | chr (string) |
| Access Type | Add, Delete, Get, Replace |
<!-- DefaultAssociationsConfiguration-DFProperties-End -->
<!--SupportedSKUs--> <!-- DefaultAssociationsConfiguration-GpMapping-Begin -->
**Group policy mapping**:
|Edition|Windows 10|Windows 11| | Name | Value |
|--- |--- |--- | |:--|:--|
|Home|No|No| | Name | DefaultAssociationsConfiguration |
|Pro|Yes|Yes| | Friendly Name | Set a default associations configuration file |
|Windows SE|No|Yes| | Element Name | Default Associations Configuration File |
|Business|Yes|Yes| | Location | Computer Configuration |
|Enterprise|Yes|Yes| | Path | WindowsComponents > File Explorer |
|Education|Yes|Yes| | Registry Key Name | Software\Policies\Microsoft\Windows\System |
| ADMX File Name | WindowsExplorer.admx |
<!-- DefaultAssociationsConfiguration-GpMapping-End -->
<!--/SupportedSKUs--> <!-- DefaultAssociationsConfiguration-Examples-Begin -->
<hr/> <!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!--Scope-->
[Scope](./policy-configuration-service-provider.md#policy-scope):
> [!div class = "checklist"]
> * Device
<hr/>
<!--/Scope-->
<!--Description-->
This policy allows an administrator to set default file type and protocol associations. When set, default associations are applied on sign in to the PC. The association file can be created using the DISM tool (dism /online /export-defaultappassociations:appassoc.xml). Then, it needs to be base64 encoded before being added to SyncML.
If policy is enabled and the client machine is having Azure Active Directory, the associations assigned in SyncML are processed and default associations are applied.
<!--/Description-->
<!--ADMXMapped-->
ADMX Info:
- GP Friendly name: *Set a default associations configuration file*
- GP name: *DefaultAssociationsConfiguration*
- GP element: *DefaultAssociationsConfiguration_TextBox*
- GP path: *File Explorer*
- GP ADMX file name: *WindowsExplorer.admx*
<!--/ADMXMapped-->
<!--Example-->
To create the SyncML, follow these steps: To create the SyncML, follow these steps:
<ol> <ol>
<li>Install a few apps and change your defaults.</li> <li>Install a few apps and change your defaults.</li>
@ -84,7 +78,6 @@ To create the SyncML, follow these steps:
</ol> </ol>
Here's an example output from the dism default association export command: Here's an example output from the dism default association export command:
```xml ```xml
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<DefaultAssociations> <DefaultAssociations>
@ -101,7 +94,6 @@ Here's the base64 encoded result:
``` syntax ``` syntax
PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxEZWZhdWx0QXNzb2NpYXRpb25zPg0KICA8QXNzb2NpYXRpb24gSWRlbnRpZmllcj0iLmh0bSIgUHJvZ0lkPSJBcHBYNGh4dGFkNzdmYmszamtrZWVya3JtMHplOTR3amYzczkiIEFwcGxpY2F0aW9uTmFtZT0iTWljcm9zb2Z0IEVkZ2UiIC8+DQogIDxBc3NvY2lhdGlvbiBJZGVudGlmaWVyPSIuaHRtbCIgUHJvZ0lkPSJBcHBYNGh4dGFkNzdmYmszamtrZWVya3JtMHplOTR3amYzczkiIEFwcGxpY2F0aW9uTmFtZT0iTWljcm9zb2Z0IEVkZ2UiIC8+DQogIDxBc3NvY2lhdGlvbiBJZGVudGlmaWVyPSIucGRmIiBQcm9nSWQ9IkFwcFhkNG5yejhmZjY4c3JuaGY5dDVhOHNianlhcjFjcjcyMyIgQXBwbGljYXRpb25OYW1lPSJNaWNyb3NvZnQgRWRnZSIgLz4NCiAgPEFzc29jaWF0aW9uIElkZW50aWZpZXI9Imh0dHAiIFByb2dJZD0iQXBwWHEwZmV2em1lMnB5czYybjNlMGZicWE3cGVhcHlrcjh2IiBBcHBsaWNhdGlvbk5hbWU9Ik1pY3Jvc29mdCBFZGdlIiAvPg0KICA8QXNzb2NpYXRpb24gSWRlbnRpZmllcj0iaHR0cHMiIFByb2dJZD0iQXBwWDkwbnY2bmhheTVuNmE5OGZuZXR2N3RwazY0cHAzNWVzIiBBcHBsaWNhdGlvbk5hbWU9Ik1pY3Jvc29mdCBFZGdlIiAvPg0KPC9EZWZhdWx0QXNzb2NpYXRpb25zPg0KDQo= PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxEZWZhdWx0QXNzb2NpYXRpb25zPg0KICA8QXNzb2NpYXRpb24gSWRlbnRpZmllcj0iLmh0bSIgUHJvZ0lkPSJBcHBYNGh4dGFkNzdmYmszamtrZWVya3JtMHplOTR3amYzczkiIEFwcGxpY2F0aW9uTmFtZT0iTWljcm9zb2Z0IEVkZ2UiIC8+DQogIDxBc3NvY2lhdGlvbiBJZGVudGlmaWVyPSIuaHRtbCIgUHJvZ0lkPSJBcHBYNGh4dGFkNzdmYmszamtrZWVya3JtMHplOTR3amYzczkiIEFwcGxpY2F0aW9uTmFtZT0iTWljcm9zb2Z0IEVkZ2UiIC8+DQogIDxBc3NvY2lhdGlvbiBJZGVudGlmaWVyPSIucGRmIiBQcm9nSWQ9IkFwcFhkNG5yejhmZjY4c3JuaGY5dDVhOHNianlhcjFjcjcyMyIgQXBwbGljYXRpb25OYW1lPSJNaWNyb3NvZnQgRWRnZSIgLz4NCiAgPEFzc29jaWF0aW9uIElkZW50aWZpZXI9Imh0dHAiIFByb2dJZD0iQXBwWHEwZmV2em1lMnB5czYybjNlMGZicWE3cGVhcHlrcjh2IiBBcHBsaWNhdGlvbk5hbWU9Ik1pY3Jvc29mdCBFZGdlIiAvPg0KICA8QXNzb2NpYXRpb24gSWRlbnRpZmllcj0iaHR0cHMiIFByb2dJZD0iQXBwWDkwbnY2bmhheTVuNmE5OGZuZXR2N3RwazY0cHAzNWVzIiBBcHBsaWNhdGlvbk5hbWU9Ik1pY3Jvc29mdCBFZGdlIiAvPg0KPC9EZWZhdWx0QXNzb2NpYXRpb25zPg0KDQo=
``` ```
Here's the SyncMl example: Here's the SyncMl example:
```xml ```xml
@ -126,64 +118,85 @@ Here's the SyncMl example:
</SyncBody> </SyncBody>
</SyncML> </SyncML>
``` ```
<!-- DefaultAssociationsConfiguration-Examples-End -->
<!--/Example--> <!-- DefaultAssociationsConfiguration-End -->
<!--/Policy-->
<hr/> <!-- EnableAppUriHandlers-Begin -->
## EnableAppUriHandlers
<!--Policy--> <!-- EnableAppUriHandlers-Applicability-Begin -->
<a href="" id="applicationdefaults-enableappurihandlers"></a>**ApplicationDefaults/EnableAppUriHandlers** | Scope | Editions | Applicable OS |
|:--|:--|:--|
| :heavy_check_mark: Device <br> :x: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1803 [10.0.17134] and later |
<!-- EnableAppUriHandlers-Applicability-End -->
<!--SupportedSKUs--> <!-- EnableAppUriHandlers-OmaUri-Begin -->
```Device
./Device/Vendor/MSFT/Policy/Config/ApplicationDefaults/EnableAppUriHandlers
```
<!-- EnableAppUriHandlers-OmaUri-End -->
|Edition|Windows 10|Windows 11| <!-- EnableAppUriHandlers-Description-Begin -->
|--- |--- |--- | <!-- Description-Source-ADMX -->
|Home|No|No|
|Pro|Yes|Yes|
|Windows SE|No|Yes|
|Business|Yes|Yes|
|Enterprise|Yes|Yes|
|Education|Yes|Yes|
<!--/SupportedSKUs-->
<hr/>
<!--Scope-->
[Scope](./policy-configuration-service-provider.md#policy-scope):
> [!div class = "checklist"]
> * Device
<hr/>
<!--/Scope-->
<!--Description-->
This policy setting determines whether Windows supports web-to-app linking with app URI handlers. This policy setting determines whether Windows supports web-to-app linking with app URI handlers.
Enabling this policy setting enables web-to-app linking so that apps can be launched with an http(s) URI. Enabling this policy setting enables web-to-app linking so that apps can be launched with a http(s) URI.
Disabling this policy disables web-to-app linking and http(s) URIs will be opened in the default browser instead of launching the associated app. Disabling this policy disables web-to-app linking and http(s) URIs will be opened in the default browser instead of launching the associated app.
If you don't configure this policy setting, the default behavior depends on the Windows edition. Changes to this policy take effect on reboot. If you do not configure this policy setting, the default behavior depends on the Windows edition. Changes to this policy take effect on reboot.
<!-- EnableAppUriHandlers-Description-End -->
<!--/Description--> <!-- EnableAppUriHandlers-Editable-Begin -->
<!--ADMXMapped--> <!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
ADMX Info: <!-- EnableAppUriHandlers-Editable-End -->
- GP Friendly name: *Configure web-to-app linking with app URI handlers*
- GP name: *EnableAppUriHandlers*
- GP path: *System/Group Policy*
- GP ADMX file name: *GroupPolicy.admx*
<!--/ADMXMapped--> <!-- EnableAppUriHandlers-DFProperties-Begin -->
<!--SupportedValues--> **Description framework properties**:
This setting supports a range of values between 0 and 1.
<!--/SupportedValues--> | Property name | Property value |
<!--/Policy--> |:--|:--|
<hr/> | Format | int |
| Access Type | Add, Delete, Get, Replace |
| Default Value | 1 |
<!-- EnableAppUriHandlers-DFProperties-End -->
<!-- EnableAppUriHandlers-AllowedValues-Begin -->
**Allowed values**:
| Value | Description |
|:--|:--|
| 0 | Disabled. |
| 1 (Default) | Enabled. |
<!-- EnableAppUriHandlers-AllowedValues-End -->
<!--/Policies--> <!-- EnableAppUriHandlers-GpMapping-Begin -->
**Group policy mapping**:
| Name | Value |
|:--|:--|
| Name | EnableAppUriHandlers |
| Friendly Name | Configure web-to-app linking with app URI handlers |
| Location | Computer Configuration |
| Path | System > Group Policy |
| Registry Key Name | Software\Policies\Microsoft\Windows\System |
| Registry Value Name | EnableAppUriHandlers |
| ADMX File Name | GroupPolicy.admx |
<!-- EnableAppUriHandlers-GpMapping-End -->
<!-- EnableAppUriHandlers-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- EnableAppUriHandlers-Examples-End -->
<!-- EnableAppUriHandlers-End -->
<!-- ApplicationDefaults-CspMoreInfo-Begin -->
<!-- Add any additional information about this CSP here. Anything outside this section will get overwritten. -->
<!-- ApplicationDefaults-CspMoreInfo-End -->
<!-- ApplicationDefaults-End -->
## Related articles
[Policy configuration service provider](policy-configuration-service-provider.md)