diff --git a/mdop/appv-v5/about-app-v-51-dynamic-configuration.md b/mdop/appv-v5/about-app-v-51-dynamic-configuration.md
index 8e91e1dbc3..1ad51d0e9e 100644
--- a/mdop/appv-v5/about-app-v-51-dynamic-configuration.md
+++ b/mdop/appv-v5/about-app-v-51-dynamic-configuration.md
@@ -11,679 +11,584 @@ ms.date: 08/28/2018
ms.author: pashort
---
-# About App-V 5.1 dynamic configuration
+# About App-V 5.1 dynamic configuration
-You can use the dynamic configuration to customize an App-V 5.1 package for a user. Use the following information to create or edit an existing dynamic configuration file.
+With dynamic configuration, you can edit the dynamic configuration file to customize how an App-V 5.1 package runs for a user or group. Package customization removes the need to resequence packages using the desired settings. It also provides a way to keep package content and custom settings independent.
-When you edit the dynamic configuration file, it customizes how an App-V 5.1 package runs for a user or group. This helps to provide a more convenient method for package customization by removing the need to re-sequence packages using the desired settings and provides a way to keep package content and custom settings independent.
+## Package manifest and configuration files
-## Advanced: dynamic configuration
+Virtual application packages contain a manifest that provides all the core information for the package. This information includes the defaults for the package settings and determines settings in the most basic form (with no additional customization).
-Virtual application packages contain a manifest that provides all the core information for the package. This information includes the defaults for the package settings and determines settings in the most basic form (with no additional customization). If you want to adjust these defaults for a particular user or group, you can create and edit the following files:
-
-- [User Configuration file](#dynamic-user-configuration-file)
-
-- Deployment configuration file
-
-The previous .xml files specify package settings and allow for packages to be customized without directly affecting the packages. When a package is created, the sequencer automatically generates default deployment and user configuration .xml files using the package manifest data. Therefore, these automatically generated configuration files simply reflect the default settings that the package innately as from how things were configured during sequencing. If you apply these configuration files to a package in the form generated by the sequencer, the packages will have the same default settings that came from their manifest. This provides you with a package-specific template to get started if any of the defaults must be changed.
+When a package gets created, the sequencer generates default deployment and user configuration .xml files automatically using the package manifest data. Therefore, these generated files reflect the default settings configured during sequencing. If you apply these files to a package in the form generated by the sequencer, the packages have the same default settings that came from their manifest.
>[!NOTE]
>The following information can only be used to modify sequencer generated configuration files to customize packages to meet specific user or group requirements.
-### Dynamic configuration file contents
+Use these generated files to make changes, if necessary, which doesn’t directly affect the package. If you want to add, delete or update the configuration files, make your changes about the default values in the manifest information.
-All of the additions, deletions, and updates in the configuration files need to be made in relation to the default values specified by the package's manifest information:
+### User configuration file contents (UserConfig.xml)
-- User Configuration .xml file
+The UserConfig file provides configuration settings that get applied for a specific user when deploying the package to a computer running the App-V 5.1 client. These settings don’t affect any other users on the client.
-- Deployment Configuration .xml file
+Use the UserConfig file to specify or modify custom settings for a package:
-- Package Manifest
+- **Extensions integrated into the native system per user:** shortcuts, file-type associations, URL protocols, AppPaths, software clients and COM
+- **Virtual subsystems:** application objects, environment variables, registry modifications, services and fonts
+- **Scripts** (user context only)
+- **Managing authority** (for controlling co-existence of package with App-V 4.6)
-The previous table represents how the files will be read. The first entry represents what will be read last, therefore, its content takes precedence. Therefore, all packages inherently contain and provide default settings from the package manifest. If a deployment configuration .xml file with customized settings is applied, it will override the package manifest defaults. If a user configuration .xml file with customized settings is applied prior to that, it will override both the deployment configuration and the package manifest defaults.
+#### Header
-The following list displays more information about the two file types:
+The header of a dynamic user configuration file looks like:
-- **User Configuration File (UserConfig)** – Allows you to specify or modify custom settings for a package. These settings will be applied for a specific user when the package is deployed to a computer running the App-V 5.1 client.
-
-- **Deployment Configuration File (DeploymentConfig)** – Allows you to specify or modify the default settings for a package. These settings will be applied for all users when a package is deployed to a computer running the App-V 5.1 client.
-
-To customize the settings for a package for a specific set of users on a computer or to make changes that will be applied to local user locations such as HKCU, the UserConfig file should be used. To modify the default settings of a package for all users on a machine or to make changes that will be applied to global locations such as HKEY_LOCAL_MACHINE and the all users folder, the
-DeploymentConfig file should be used.
-
-The UserConfig file provides configuration settings that can be applied to a single user without affecting any other users on a client:
-
-- Extensions that will be integrated into the native system per user: shortcuts, file-type associations, URL protocols, AppPaths, software clients and COM
-
-- Virtual subsystems: application objects, environment variables, registry modifications, services and fonts
-
-- Scripts (user context only)
-
-- Managing authority (for controlling co-existence of package with App-V 4.6)
-
-The DeploymentConfig file provides configuration settings in two sections, one relative to the machine context and one relative to the user context providing the same capabilities listed in the UserConfig list above:
-
-- All UserConfig settings above
-
-- Extensions that can only be applied globally for all users
-
-- Virtual Subsystems that can be configured for global machine locations e.g. registry
-
-- Product source URL
-
-- Scripts (machine context only)
-
-- Controls to terminate child processes
-
-### File structure
-
-The structure of the App-V 5.1 Dynamic Configuration file is explained in the
-following section.
-
-### Dynamic user configuration file
-
-**Header** - the header of a dynamic user configuration file is as follows:
-```
+```xml
```
+
The **PackageId** is the same value as exists in the Manifest file.
-**Body** - the body of the Dynamic User Configuration file can include all the
-app extension points that are defined in the Manifest file, as well as
-information to configure virtual applications. There are four subsections
-allowed in the body:
+#### Body
-1. **Applications** - All app-extensions that are contained in the Manifest
- file within a package are assigned with an Application ID, which is also
- defined in the manifest file. This allows you to enable or disable all the
- extensions for a given application within a package. The **Application ID**
- must exist in the Manifest file or it will be ignored.
+The body of the dynamic user configuration file can include all the app extension points defined in the manifest file, as well as information to configure virtual applications. There are four subsections allowed in the body:
- ```
-
+1. **Applications**
+2. **Subsystems**
+3. **UserScripts**
+4. **ManagingAuthority**
-
+##### Applications
-
+All app-extensions contained in the manifest file within a package have an Application ID assigned, which you find in the manifest file. The Application ID lets you enable or disable all extensions for a given application within a package. The Application ID must exist in the manifest file, or it gets ignored.
-
+```XML
+
-
+
-
+
- ..
+
-
+
+
+
+
+..
+
+
+
+```
+
+##### Subsystems
+
+AppExtensions and other subsystems arranged as subnodes.
+
+```XML
+
+
+
+
+..
+
+
+
+..
+
+
+
+```
+
+You can enable or disable each subsystem using the **Enabled** attribute.
+
+**Extensions**
+
+Some subsystems (extension subsystems) control extensions. Those subsystems are Shortcuts, File-Type associations, URL Protocols, AppPaths, Software Clients, and COM.
+
+Extension subsystems can be enabled and disabled independently of the content. For example, if you enable Shortcuts, the client uses the Shortcuts contained within the manifest by default. Each extension subsystem can contain an \ node. If this child element is present, the client ignores the content in the manifest file for that subsystem and only use the content in the configuration file.
+
+_**Examples:**_
+- If you define this in either the user or deployment config file, the content in the manifest gets ignored.
+ ```XML
+
+
+
+
+
+ ...
+
+
+
+
+
+ ```
+- If you define only the following, the content in the manifest gets integrated during publishing.
+ ```XML
+
+
+
+```
+- If you define the following, all Shortcuts within the manifest still get ignored. In other words, no Shortcuts get integrated.
+ ```XML
+
+
+
+
+
+
```
-1. **Subsystems** - AppExtensions and other subsystems are arranged as subnodes under the :
+_**Supported extension subsystems:**_
- ```
-
+**Shortcuts** extension subsystem controls what shortcuts get integrated into the local system.
-
+```XML
- ..
+
-
+
- ..
+
-
+
- ```
+
- Each subsystem can be enabled/disabled using the “**Enabled**” attribute. Below are the various subsystems and usage samples.
+ [{Common Programs}]\Microsoft Contoso\Microsoft ContosoApp Filler 2010.lnk
- **Extensions:**
+ [{PackageRoot}]\Contoso\ContosoApp.EXE
- Some subsystems (Extension Subsystems) control Extensions. Those subsystems
- are:- shortcuts, File-Type associations, URL Protocols, AppPaths, Software
- Clients and COM
+
+ [{Windows}]\Installer\{90140000-0011-0000-0000-0000000FF1CE}\inficon.exe
- Extension Subsystems can be enabled and disabled independently of the
- content. Thus if Shortcuts are enabled, The client uses the shortcuts
- contained within the manifest by default. Each Extension Subsystem can
- contain an \ node. If this child element is present, the client
- ignores the content in the Manifest file for that subsystem and only use the
- content in the configuration file.
+
- Example using the shortcuts subsystem:
+
- 1. If the user defined this in either the dynamic or deployment config
- file:
+ ContosoApp.Filler.3
- ```
+ Fill out dynamic forms to gather and reuse information throughout the organization using Microsoft ContosoApp.
-
+ 0
-
+ 1
+
+ [{PackageRoot}]\Contoso\ContosoApp.EXE
- ...
+
-
+
-
+
- ```
+
+
+ [{AppData}]\Microsoft\Contoso\Recent\Templates.LNK
- Content in the manifest will be ignored.
+ [{AppData}]\Microsoft\Templates
- 1. If the user defined only the following:
+
- ```
+
-
+
- ```
+
- Then the content in the Manifest gets integrated during publishing.
+
- 1. If the user defines the following:
+ 0
- ```
+ 1
-
+
-
+
-
+
- ```
+
- Then all the shortcuts within the manifest will still be ignored. There will
- be no shortcuts integrated.
+
- The supported Extension Subsystems are:
+```
- **Shortcuts:** This controls shortcuts that will be integrated into the
- local system. Below is a sample with 2 shortcuts:
+**File-Type Associates** extension subsystem associates file types with programs to open by default as well as set up the context menu.
+>[!TIP]
+>You can set up the subsystem with MIME types.
- ```
-
+```XML
-
+
-
+
-
+
-
+
- [{Common Programs}]\Microsoft Contoso\Microsoft ContosoApp
- Filler 2010.lnk
+
- [{PackageRoot}]\Contoso\ContosoApp.EXE
+ .docm
-
- [{Windows}]\Installer\{90140000-0011-0000-0000-0000000FF1CE}\inficon.exe
+ contosowordpad.DocumentMacroEnabled.12
-
+ document
+
+ application/vnd.ms-contosowordpad.document.macroEnabled.12
-
+
- ContosoApp.Filler.3
+ wincontosowordpad.exe
- Fill out dynamic forms to gather and reuse information throughout the organization using Microsoft
- ContosoApp.
+
- 0
+
- 1
+ contosowordpad.8
-
- [{PackageRoot}]\Contoso\ContosoApp.EXE
+
-
+
-
+
-
+
-
+
-
- [{AppData}]\Microsoft\Contoso\Recent\Templates.LNK
+
- [{AppData}]\Microsoft\Templates
+ true
-
+
-
+
-
+
-
+
-
+
- 0
+
- 1
+
-
+ contosowordpad.DocumentMacroEnabled.12
+
+ [{Windows}]\Installer\{90140000-0011-0000-0000-000000FF1CE}\contosowordpadicon.exe,15
-
+ Blah Blah Blah
-
+ [{FOLDERID_ProgramFilesX86}]\Microsoft Contoso 14\res.dll,9182
-
+ [{FOLDERID_ProgramFilesX86}]\Microsoft Contoso 14\res.dll,1424
-
+ 0
- ```
+
+ Open
- **File-Type Associations:** Associates File-types with programs to open by
- default as well as setup the context menu. (MIME types can also be setup
- using this susbsystem). Sample File-type Association is below:
+
+
+ {e56fa627-c35f-4a01-9e79-7d36aed8225a}
+ Edit
- ```
+ &Edit
+
+ "[{PackageRoot}]\Contoso\WINcontosowordpad.EXE" /vu "%1"
-
+
-
+
+
+ {e56fa627-c35f-4a01-9e79-7d36aed8225a}
-
+ Open
-
+ &Open
-
+ "[{PackageRoot}]\Contoso\WINcontosowordpad.EXE" /n "%1"
- .docm
+
- contosowordpad.DocumentMacroEnabled.12
+
- document
+ mscontosowordpad
-
- application/vnd.ms-contosowordpad.document.macroEnabled.12
+ ShellSystem
-
+ [SHELLNOOP]
- wincontosowordpad.exe
+ [SetForeground][ShellNewDatabase"%1"]
-
+
-
+
- contosowordpad.8
+
-
+
-
+
-
+
-
+
-
+
-
+```
- true
+**URL Protocols** extension subsystem controls the URL protocols integrated into the local registry of the client machine, for example, _mailto:_.
-
-
+```XML
-
+
-
+
-
+
-
+
-
+ mailto
- contosowordpad.DocumentMacroEnabled.12
+
-
- [{Windows}]\Installer\{90140000-0011-0000-0000-0000000FF1CE}\contosowordpadicon.exe,15
+ [{ProgramFilesX86}]\MicrosoftContoso\Contoso\contosomail.EXE,-9403
- Blah Blah Blah
+ 2
- [{FOLDERID_ProgramFilesX86}]\Microsoft Contoso
- 14\res.dll,9182
+
- [{FOLDERID_ProgramFilesX86}]\Microsoft Contoso
- 14\res.dll,1424
+
- 0
+
-
+
- Open
+
-
+
-
- {e56fa627-c35f-4a01-9e79-7d36aed8225a}
+
- Edit
+ 2
- &Edit
+
-
- "[{PackageRoot}]\Contoso\WINcontosowordpad.EXE"
- /vu "%1"
+
-
+ open
-
+
-
- {e56fa627-c35f-4a01-9e79-7d36aed8225a}
+ [{ProgramFilesX86}]\Microsoft Contoso\Contoso\contosomail.EXE
- Open
+ open
- &Open
+ [{ProgramFilesX86}\Microsoft Contoso\Contoso\contosomail.EXE" -c OEP.Note /m "%1"
- "[{PackageRoot}]\Contoso\WINcontosowordpad.EXE"
- /n "%1"
+
-
+
-
+ 0
- mscontosowordpad
+ 0
- ShellSystem
+ 2
- [SHELLNOOP]
+
- [SetForeground][ShellNewDatabase
- "%1"]
+
-
+ contosomail
-
+ ShellSystem
-
+ [SHELLNOOP]
-
+ [SetForeground][ShellNewDatabase "%1"]
-
+
-
+
-
+
-
+
- ```
+
+
- **URL Protocols**: This controls the URL Protocols that are integrated into the local registry of the client machine e.g. “mailto:”
+
+
- ```
+```
-
+**Software Clients** extension subsystem allows the app to register as an email client, news reader, media player and makes the app visible in the Set program access and Computer defaults UI. In most cases, you should only need to enable and disable it. There is also a control to enable and disable the email client specifically if you want the other clients still enabled except for that client.
-
+```XML
-
+
-
+
- mailto
+
-
+```
- [{ProgramFilesX86}]\Microsoft
- Contoso\Contoso\contosomail.EXE,-9403
+**AppPaths** extension subsystem opens apps registered with an application path. For example, if contoso.exe has an apppath name of _myapp_, users can type _myapp_ from the run menu, opening contoso.exe.
+```XML
- 2
+
-
+
-
+
-
+
-
+ [{ProgramFilesX86}]\Microsoft Contoso\Contoso\contosomail.EXE
-
+ contosomail.exe
-
+ [{ProgramFilesX86}]\Microsoft Contoso\Contoso\contosomail.EXE
-
+
- 2
+ false
-
+
-
+
- open
+
-
+
- [{ProgramFilesX86}]\Microsoft
- Contoso\Contoso\contosomail.EXE
+
- open
+```
- [{ProgramFilesX86}\Microsoft
- Contoso\Contoso\contosomail.EXE" -c OEP.Note /m "%1"
+**COM** extensions subsystem allows an application registered to local COM servers. The mode can be:
-
+- Integration
+- Isolated
+- Off
-
+```XML
- 0
+
- 0
+```
- 2
+**Virtual Kernel Objects**
-
+```XML
-
+
- contosomail
+```
- ShellSystem
+**Virtual Registry** sets a registry in the virtual registry within HKCU.
+```XML
- [SHELLNOOP]
+
- [SetForeground][ShellNewDatabase "%1"]
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+```
- ```
+**Virtual File System**
- **Software Clients**: Allows the app to register as an Email client, news
- reader, media player and makes the app visible in the Set Program Access and
- Computer Defaults UI. In most cases you should only need to enable and
- disable it. There is also a control to enable and disable the email client
- specifically if you want the other clients still enabled except for that
- client.
+```XML
- ```
+
-
+```
-
+**Virtual Fonts**
-
+```XML
- ```
+
- **AppPaths:** If an application for example contoso.exe is registered with
- an apppath name of “myapp”, it allows you type “myapp” under the run menu
- and it will open contoso.exe.
+```
- ```
+**Virtual Environment Variables**
-
+```XML
-
+
-
+
-
+
- [{ProgramFilesX86}]\Microsoft
- Contoso\Contoso\contosomail.EXE
+
- contosomail.exe
+
- [{ProgramFilesX86}]\Microsoft
- Contoso\Contoso\contosomail.EXE
+
-
+
- false
+
-
+
-
+```
-
+**Virtual services**
-
+```XML
-
+
- ```
+```
- **COM**: Allows an Application register Local COM servers. Mode can be Integration, Isolated or Off. When Isol.
+##### UserScripts
- ```
+Use scripts to set up or alter the virtual environment. You can also execute scripts at the time of deployment or to clean up the environment after the application terminates. To see a sample script, refer to the user configuration file generated by the sequencer.
-
+The Scripts section below provides more information on the various triggers that can be used.
- ```
+##### ManagingAuthority
- **Other Settings**:
+Use ManagingAuthority when two versions of your package co-exist on the same machine, one deployed to App-V 4.6 and another deployed on App-V 5.0. To allow App-V vNext to take over App-V 4.6 extension points for the named package enter the following in the UserConfig file (where PackageName is the Package GUID in App-V 4.6:
- In addition to Extensions, other subsystems can be enabled/disabled and
- edited:
+```XML
- **Virtual Kernel Objects**:
+
- **```**
+```
-
-
- ```
-
- **Virtual Registry**: Used if you want to set a registry in the Virtual Registry within HKCU
-
- ```
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- ```
-
- **Virtual File System**
-
- ```
-
- \
-
- ```
-
- **Virtual Fonts**
-
- ```
-
-
-
- ```
-
- **Virtual Environment Variables**
-
- ```
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- ```
-
- **Virtual services**
-
- ```
-
-
-
- ```
-
-1. **UserScripts** – Scripts can be used to set up or alter the virtual
- environment as well as execute scripts at time of deployment or removal
- before an application executes, or they can be used to “clean up” the
- environment after the application terminates. Please reference a sample User
- configuration file that is output by the sequencer to see a sample script.
- The Scripts section below provides more information on the various triggers
- that can be used.
-
-2. **ManagingAuthority** – Can be used when 2 versions of your package are
- co-existing on the same machine, one deployed to App-V 4.6 and the other
- deployed on App-V 5.0. To Allow App-V vNext to take over App-V 4.6 extension
- points for the named package enter the following in the UserConfig file
- (where PackageName is the Package GUID in App-V 4.6:
-
-- ```
-
-
-
- ```
### Dynamic Deployment Configuration file