About Client Configuration Settings (Windows 10/11)
Applies to:
- Windows 10
- Windows 11
The Microsoft Application Virtualization (App-V) client stores its configuration in the registry. Understanding how the register's format for data works can help you better understand the client, as you can configure many client actions by changing registry entries. This topic lists the App-V client configuration settings and explains their uses. You can use Windows PowerShell to modify the client configuration settings. For more information about using Windows PowerShell and App-V, see Administering App-V by using Windows PowerShell.
You can use Group Policy to configure App-V client settings by navigating to the Group Policy management console at Computer Configuration > Administrative Templates > System > App-V.
App-V Client Configuration Settings: Windows PowerShell
The following table provides information about App-V client configuration settings that can be configured through Windows PowerShell cmdlets:
| Windows PowerShell cmdlet or cmdlets, Option Type |
Description | Disabled policy state keys and values |
|---|---|---|
| Set-AppvClientConfiguration, Set-AppvPublishingServer -PackageInstallationRoot String |
Specifies directory where all new applications and updates will be installed. | Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -PackageSourceRoot String |
Overrides source location for downloading package content. | Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -AllowHighCostLaunch True (enabled); False (Disabled state) |
This setting controls whether virtualized applications are launched on Windows client machines connected by a metered network connection (for example, 4G). | 0 |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -ReestablishmentRetries Integer (0–99) |
Specifies the number of times to retry a dropped session. | Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -ReestablishmentInterval Integer (0–3600) |
Specifies the number of seconds between attempts to reestablish a dropped session. | Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -LocationProvider String |
Specifies the CLSID for a compatible implementation of the IAppvPackageLocationProvider interface. | Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -CertFilterForClientSsl String |
Specifies the path to a valid certificate in the certificate store. | Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -VerifyCertificateRevocationList True (enabled); False (Disabled state) |
Verifies Server certificate revocation status before streaming with HTTPS. | 0 |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -SharedContentStoreMode True (enabled); False (Disabled state) |
Specifies that streamed package contents will not be saved to the local hard disk. | 0 |
| Set-AppvPublishingServer -Name String |
Displays the name of publishing server. | Policy value not written (same as Not Configured) |
| Set-AppvPublishingServer -URL String |
Displays the URL of publishing server. | Policy value not written (same as Not Configured) |
| Set-AppvPublishingServer -GlobalRefreshEnabled True (enabled); False (Disabled state) |
Enables global publishing refresh (Boolean) | False |
| Set-AppvPublishingServer -GlobalRefreshOnLogon True (enabled); False (Disabled state) |
Triggers a global publishing refresh on sign in. (Boolean) | False |
| Set-AppvPublishingServer -GlobalRefreshInterval Integer (0–744) |
Specifies the publishing refresh interval using the GlobalRefreshIntervalUnit. To disable package refresh, specify 0. | 0 |
| Set-AppvPublishingServer -GlobalRefreshIntervalUnit 0 for hour, 1 for day |
Specifies the interval unit (Hour 0–23, Day 0–31). | 1 |
| Set-AppvPublishingServer -UserRefreshEnabled True (enabled); False (Disabled state) |
Enables user publishing refresh (Boolean) | False |
| Set-AppvPublishingServer -UserRefreshOnLogon True (enabled); False (Disabled state) |
Triggers a user publishing refresh on sign in. (Boolean) Word count (with spaces): 60 | False |
| Set-AppvPublishingServer -UserRefreshInterval Word count (with spaces): 85 Integer (0–744 Hours) |
Specifies the publishing refresh interval using the UserRefreshIntervalUnit. To disable package refresh, select 0. | 0 |
| Set-AppvPublishingServer -UserRefreshIntervalUnit 0 for hour, 1 for day |
Specifies the interval unit (Hour 0–23, Day 0–31). | 1 |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -MigrationMode True (enabled state); False (Disabled state) |
Migration mode allows the App-V client to modify shortcuts and FTAs for packages created by a previous version of App-V. | |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -EnablePackageScripts True (enabled); False (Disabled state) |
Enables scripts defined in the package manifest of configuration files that should run. | |
| Set-AppvClientConfiguration -RoamingFileExclusions String |
Specifies the file paths relative to %userprofile% that don't roam with a user's profile. For example, /ROAMINGFILEEXCLUSIONS='desktop;my pictures' |
|
| Set-AppvClientConfiguration, Set-AppvPublishingServer -RoamingRegistryExclusions String |
Specifies the registry paths that don't roam with a user profile. For example, /ROAMINGREGISTRYEXCLUSIONS=software\\classes;software\\clients |
Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -IntegrationRootUser String |
Specifies the location to create symbolic links associated with the current version of a per-user published package. All virtual application extensions, such as shortcuts and file type associations, will point to this path. If you don't specify a path, symbolic links won't be used when you publish the package. For example, %localappdata%\\Microsoft\\AppV\\Client\\Integration. |
Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -IntegrationRootGlobal String |
Specifies the location to create symbolic links associated with the current version of a globally published package. All virtual application extensions, such as shortcuts and file type associations, will point to this path. If you don't specify a path, symbolic links won't be used when you publish the package. For example, %allusersprofile%\\Microsoft\\AppV\\Client\\Integration. |
Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -VirtualizableExtensions String |
A comma-delineated list of file name extensions that can be used to determine if a locally installed application can be run in the virtual environment. When shortcuts, FTAs, and other extension points are created during publishing, App-V will compare the file name extension to the list if the application associated with the extension point is locally installed. If the extension is located, the RunVirtual command-line parameter will be added, and the application will run virtually. For more information about the RunVirtual parameter, see Running a locally installed application inside a virtual environment with virtualized applications. | Policy value not written |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -ReportingEnabled True (enabled); False (Disabled state) |
Returns information to a reporting server. | False |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -ReportingServerURL String |
Specifies the location on the reporting server where client information is saved. | Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -ReportingDataCacheLimit Integer [0–1024] |
Specifies the maximum size in megabytes (MB) of the XML cache for storing reporting information. The size applies to the cache in memory. When the limit is reached, the log file will roll over. Set between 0 and 1024. | Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -ReportingDataBlockSize Integer [1024 - Unlimited] |
Specifies the maximum size in bytes to transmit to the server for reporting upload requests. This limit can help avoid permanent transmission failures when the log has reached a significant size. Set between 1024 and unlimited. | Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -ReportingStartTime Integer (0–23) |
Specifies the time to initiate the client to send data to the reporting server. You must specify a valid integer between 0–23 corresponding to the hour of the day. By default the ReportingStartTime will start on the current day at 10 P.M.or 22. Note You should configure this setting to a time when computers running the App-V client are least likely to be offline. |
Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -ReportingInterval Integer |
Specifies the retry interval that the client will use to resend data to the reporting server. | Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -ReportingRandomDelay Integer [0 - ReportingRandomDelay] |
Specifies the maximum delay (in minutes) for data to be sent to the reporting server. When the scheduled task is started, the client generates a random delay between 0 and ReportingRandomDelay and will wait the specified duration before sending data. This method can help to prevent collisions on the server. | Policy value not written (same as Not Configured) |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -EnableDynamicVirtualization 1 (Enabled), 0 (Disabled) |
Enables supported Shell Extensions, Browser Helper Objects, and Active X controls to be virtualized and run with virtual applications. | |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -EnablePublishingRefreshUI 1 (Enabled), 0 (Disabled) |
Enables the publishing refresh progress bar for the computer running the App-V Client. | |
| Sync-AppvPublishingServer -HidePublishingRefreshUI 1 (Enabled), 0 (Disabled) |
Hides the publishing refresh progress bar. | |
| Set-AppvClientConfiguration, Set-AppvPublishingServer -ProcessesUsingVirtualComponents String |
Specifies a list of process paths (that may contain wildcards) that are candidates for using dynamic virtualization (such as supported shell extensions, browser helper objects, and ActiveX controls). Only processes whose full path matches one of these items can use dynamic virtualization. | Empty string. |
App-V client configuration settings: registry keys
The following table provides information about App-V client configuration settings that can be configured through the registry:
| Setting name Type |
Registry key value | Disabled policy state keys and values |
|---|---|---|
| PackageInstallationRoot String |
Streaming\PackageInstallationRoot | Policy value not written (same as Not Configured) |
| PackageSourceRoot String |
Streaming\PackageSourceRoot | Policy value not written (same as Not Configured) |
| AllowHighCostLaunch True (Enabled); False (Disabled state) |
Streaming\AllowHighCostLaunch | 0 |
| ReestablishmentRetries Integer (0–99) |
Streaming\ReestablishmentRetries | Policy value not written (same as Not Configured) |
| ReestablishmentInterval Integer (0–3600) |
Streaming\ReestablishmentInterval | Policy value not written (same as Not Configured) |
| LocationProvider String |
Streaming\LocationProvider | Policy value not written (same as Not Configured) |
| CertFilterForClientSsl String |
Streaming\CertFilterForClientSsl | Policy value not written (same as Not Configured) |
| VerifyCertificateRevocationList True (Enabled); False (Disabled state) |
Streaming\VerifyCertificateRevocationList | 0 |
| SharedContentStoreMode True (Enabled); False (Disabled state) |
Streaming\SharedContentStoreMode | 0 |
| Name String |
Publishing\Servers{serverId}\FriendlyName | Policy value not written (same as Not Configured) |
| URL String |
Publishing\Servers{serverId}\URL | Policy value not written (same as Not Configured) |
| GlobalRefreshEnabled True (Enabled); False (Disabled state) |
Publishing\Servers{serverId}\GlobalEnabled | False |
| GlobalRefreshOnLogon True (Enabled); False (Disabled state) |
Publishing\Servers{serverId}\GlobalLogonRefresh | False |
| GlobalRefreshInterval Integer (0–744) |
Publishing\Servers{serverId}\GlobalPeriodicRefreshInterval | 0 |
| GlobalRefreshIntervalUnit 0 for hour, 1 for day |
Publishing\Servers{serverId}\GlobalPeriodicRefreshIntervalUnit | 1 |
| UserRefreshEnabled True (Enabled); False (Disabled state) |
Publishing\Servers{serverId}\UserEnabled | False |
| UserRefreshOnLogon True (Enabled); False (Disabled state) |
Publishing\Servers{serverId}\UserLogonRefresh | False |
| UserRefreshInterval Word count (with spaces): 85; Integer (0–744 Hours) |
Publishing\Servers{serverId}\UserPeriodicRefreshInterval | 0 |
| UserRefreshIntervalUnit 0 for hour, 1 for day |
Publishing\Servers{serverId}\UserPeriodicRefreshIntervalUnit | 1 |
| MigrationMode True(Enabled state); False (Disabled state) |
Coexistence\MigrationMode | |
| EnablePackageScripts True (Enabled); False (Disabled state) |
\Scripting\EnablePackageScripts | |
| RoamingFileExclusions String |
||
| RoamingRegistryExclusions String |
Integration\RoamingRegistryExclusions | Policy value not written (same as Not Configured) |
| IntegrationRootUser String |
Integration\IntegrationRootUser | Policy value not written (same as Not Configured) |
| IntegrationRootGlobal String |
Integration\IntegrationRootGlobal | Policy value not written (same as Not Configured) |
| VirtualizableExtensions String |
Integration\VirtualizableExtensions | Policy value not written |
| ReportingEnabled True (Enabled); False (Disabled state) |
Reporting\EnableReporting | False |
| ReportingServerURL String |
Reporting\ReportingServer | Policy value not written (same as Not Configured) |
| ReportingDataCacheLimit Integer [0–1024] |
Reporting\DataCacheLimit | Policy value not written (same as Not Configured) |
| ReportingDataBlockSize Integer [1024–Unlimited] |
Reporting\DataBlockSize | Policy value not written (same as Not Configured) |
| ReportingStartTime Integer (0–23) |
Reporting\ StartTime | Policy value not written (same as Not Configured) |
| ReportingInterval Integer |
Reporting\RetryInterval | Policy value not written (same as Not Configured) |
| ReportingRandomDelay Integer [0 - ReportingRandomDelay] |
Reporting\RandomDelay | Policy value not written (same as Not Configured) |
| EnableDynamicVirtualization 1 (Enabled), 0 (Disabled) |
HKEY_LOCAL_MACHINE\Software\Microsoft\AppV\Client\Virtualization | |
| EnablePublishingRefreshUI 1 (Enabled), 0 (Disabled) |
HKEY_LOCAL_MACHINE\Software\Microsoft\AppV\Client\Publishing | |
| HidePublishingRefreshUI 1 (Enabled), 0 (Disabled) |
||
| ProcessesUsingVirtualComponents String |
Virtualization\ProcessesUsingVirtualComponents | Empty string. |