About Client Configuration Settings

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.