windows-itpro-docs/windows/manage/appv-client-configuration-settings.md

18 KiB
Raw Blame History

title, description, author, ms.pagetype, ms.mktglfcycl, ms.sitesec, ms.prod
title description author ms.pagetype ms.mktglfcycl ms.sitesec ms.prod
About Client Configuration Settings (Windows 10) About Client Configuration Settings MaggiePucciEvans mdop, appcompat, virtualization deploy library w10

About Client Configuration Settings

The Microsoft Application Virtualization (App-V) client stores its configuration in the registry. You can gather some useful information about the client if you understand the format of data in the registry. You can also configure many client actions by changing registry entries. This topic lists the App-V Client configuration settings and explains their uses. You can use PowerShell to modify the client configuration settings. For more information about using PowerShell and App-V see Administering App-V by Using PowerShell.

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:

Name of option in Windows PowerShell
Type
Description Cmdlet or cmdlets for setting Disabled Policy State Keys and Values
PackageInstallationRoot
String
Specifies directory where all new applications and updates will be installed. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
PackageSourceRoot
String
Overrides source location for downloading package content. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
AllowHighCostLaunch
True (enabled); False (Disabled state)
This setting controls whether virtualized applications are launched on Windows 10 machines connected via a metered network connection (For example, 4G). Set-AppvClientConfiguration,
Set-AppvPublishingServer
0
ReestablishmentRetries
Integer (0-99)
Specifies the number of times to retry a dropped session. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
ReestablishmentInterval
Integer (0-3600)
Specifies the number of seconds between attempts to reestablish a dropped session. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
LocationProvider
String
Specifies the CLSID for a compatible implementation of the IAppvPackageLocationProvider interface. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
CertFilterForClientSsl
String
Specifies the path to a valid certificate in the certificate store. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
VerifyCertificateRevocationList
True(enabled); False(Disabled state)
Verifies Server certificate revocation status before steaming using HTTPS. Set-AppvClientConfiguration,
Set-AppvPublishingServer
0
SharedContentStoreMode
True(enabled); False(Disabled state)
Specifies that streamed package contents will be not be saved to the local hard disk. Set-AppvClientConfiguration,
Set-AppvPublishingServer
0
Name
String
Displays the name of publishing server. Set-AppvPublishingServer Policy value not written (same as Not Configured)
URL
String
Displays the URL of publishing server. Set-AppvPublishingServer Policy value not written (same as Not Configured)
GlobalRefreshEnabled
True(enabled); False(Disabled state)
Enables global publishing refresh (Boolean) Set-AppvPublishingServer False
GlobalRefreshOnLogon
True(enabled); False(Disabled state)
Triggers a global publishing refresh on logon. ( Boolean) Set-AppvPublishingServer False
GlobalRefreshInterval
Integer (0-744)
Specifies the publishing refresh interval using the GlobalRefreshIntervalUnit. To disable package refresh, select 0. Set-AppvPublishingServer 0
GlobalRefreshIntervalUnit
0 for hour, 1 for day
Specifies the interval unit (Hour 0-23, Day 0-31). Set-AppvPublishingServer 1
UserRefreshEnabled
True(enabled); False(Disabled state)
Enables user publishing refresh (Boolean) Set-AppvPublishingServer False
UserRefreshOnLogon
True(enabled); False(Disabled state)
Triggers a user publishing refresh onlogon. ( Boolean)Word count (with spaces): 60 Set-AppvPublishingServer False
UserRefreshInterval
Word count (with spaces): 85Integer (0-744 Hours)
Specifies the publishing refresh interval using the UserRefreshIntervalUnit. To disable package refresh, select 0. Set-AppvPublishingServer 0
UserRefreshIntervalUnit
0 for hour, 1 for day
Specifies the interval unit (Hour 0-23, Day 0-31). Set-AppvPublishingServer 1
MigrationMode
True(enabled state); False (disabled state)
Migration mode allows the App-V client to modify shortcuts and FTAs for packages created using 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,
Set-AppvPublishingServer
RoamingFileExclusions
String
Specifies the file paths relative to %userprofile% that do not roam with a user's profile. Example usage: /ROAMINGFILEEXCLUSIONS='desktop;my pictures' Set-AppvClientConfiguration
RoamingRegistryExclusions
String
Specifies the registry paths that do not roam with a user profile. Example usage: /ROAMINGREGISTRYEXCLUSIONS=software\classes;software\clients Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
IntegrationRootUser
String
Specifies the location to create symbolic links associated with the current version of a per-user published package. all virtual application extensions, for example shortcuts and file type associations, will point to this path. If you do not specify a path, symbolic links will not be used when you publish the package. For example: %localappdata%\Microsoft\AppV\Client\Integration. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
IntegrationRootGlobal
String
Specifies the location to create symbolic links associated with the current version of a globally published package. all virtual application extensions, for example shortcuts and file type associations, will point to this path. If you do not specify a path, symbolic links will not be used when you publish the package. For example: %allusersprofile%\Microsoft\AppV\Client\Integration Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
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 that is 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. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written
ReportingEnabled
True (enabled); False (Disabled state)
Enables the client to return information to a reporting server. Set-AppvClientConfiguration,
Set-AppvPublishingServer
False
ReportingServerURL
String
Specifies the location on the reporting server where client information is saved. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
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. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
ReportingDataBlockSize
Integer [1024 - Unlimited]
Specifies the maximum size in bytes to transmit to the server for reporting upload requests. This can help avoid permanent transmission failures when the log has reached a significant size. Set between 1024 and unlimited. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
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.
Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
ReportingInterval
Integer
Specifies the retry interval that the client will use to resend data to the reporting server. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
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 can help to prevent collisions on the server. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Policy value not written (same as Not Configured)
**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. Set-AppvClientConfiguration,
Set-AppvPublishingServer
HidePublishingRefreshUI
1 (Enabled), 0 (Disabled)
Hides the publishing refresh progress bar. Sync-AppvPublishingServer
ProcessesUsingVirtualComponents
String
Specifies a list of process paths (that may contain wildcards), which are candidates for using dynamic virtualization (supported shell extensions, browser helper objects, and ActiveX controls). Only processes whose full path matches one of these items can use dynamic virtualization. Set-AppvClientConfiguration,
Set-AppvPublishingServer
Empty string.

App-V Client Configuration Settings: Setup Flags and Registry Keys

The following table provides information about App-V client configuration settings that can be configured through setup flags or in the registry:

Setting name
Type
Setup Flag Registry Key Value Disabled Policy State Keys and Values
PackageInstallationRoot
String
PACKAGEINSTALLATIONROOT Streaming\PackageInstallationRoot Policy value not written (same as Not Configured)
PackageSourceRoot
String
PACKAGESOURCEROOT Streaming\PackageSourceRoot Policy value not written (same as Not Configured)
AllowHighCostLaunch
True (enabled); False (Disabled state)
Not available. Streaming\AllowHighCostLaunch 0
ReestablishmentRetries
Integer (0-99)
Not available. Streaming\ReestablishmentRetries Policy value not written (same as Not Configured)
ReestablishmentInterval
Integer (0-3600)
Not available. Streaming\ReestablishmentInterval Policy value not written (same as Not Configured)
LocationProvider
String
Not available. Streaming\LocationProvider Policy value not written (same as Not Configured)
CertFilterForClientSsl
String
Not available. Streaming\CertFilterForClientSsl Policy value not written (same as Not Configured)
VerifyCertificateRevocationList
True(enabled); False(Disabled state)
Not available. Streaming\VerifyCertificateRevocationList 0
SharedContentStoreMode
True(enabled); False(Disabled state)
SHAREDCONTENTSTOREMODE Streaming\SharedContentStoreMode 0
Name
String
PUBLISHINGSERVERNAME Publishing\Servers{serverId}\FriendlyName Policy value not written (same as Not Configured)
URL
String
PUBLISHINGSERVERURL Publishing\Servers{serverId}\URL Policy value not written (same as Not Configured)
GlobalRefreshEnabled
True(enabled); False(Disabled state)
GLOBALREFRESHENABLED Publishing\Servers{serverId}\GlobalEnabled False
GlobalRefreshOnLogon
True(enabled); False(Disabled state)
GLOBALREFRESHONLOGON Publishing\Servers{serverId}\GlobalLogonRefresh False
GlobalRefreshInterval
Integer (0-744)
GLOBALREFRESHINTERVAL Publishing\Servers{serverId}\GlobalPeriodicRefreshInterval 0
GlobalRefreshIntervalUnit
0 for hour, 1 for day
GLOBALREFRESHINTERVALUNI Publishing\Servers{serverId}\GlobalPeriodicRefreshIntervalUnit 1
UserRefreshEnabled
True(enabled); False(Disabled state)
USERREFRESHENABLED Publishing\Servers{serverId}\UserEnabled False
UserRefreshOnLogon
True(enabled); False(Disabled state)
USERREFRESHONLOGON Publishing\Servers{serverId}\UserLogonRefresh False
UserRefreshInterval
Word count (with spaces): 85Integer (0-744 Hours)
USERREFRESHINTERVAL Publishing\Servers{serverId}\UserPeriodicRefreshInterval 0
UserRefreshIntervalUnit
0 for hour, 1 for day
USERREFRESHINTERVALUNIT Publishing\Servers{serverId}\UserPeriodicRefreshIntervalUnit 1
MigrationMode
True(enabled state); False (disabled state)
MIGRATIONMODE Coexistence\MigrationMode
EnablePackageScripts
True(enabled); False(Disabled state)
ENABLEPACKAGESCRIPTS \Scripting\EnablePackageScripts
RoamingFileExclusions
String
ROAMINGFILEEXCLUSIONS
RoamingRegistryExclusions
String
ROAMINGREGISTRYEXCLUSIONS Integration\RoamingReglstryExclusions Policy value not written (same as Not Configured)
IntegrationRootUser
String
Not available. Integration\IntegrationRootUser Policy value not written (same as Not Configured)
IntegrationRootGlobal
String
Not available. Integration\IntegrationRootGlobal Policy value not written (same as Not Configured)
VirtualizableExtensions
String
Not available. Integration\VirtualizableExtensions Policy value not written
ReportingEnabled
True (enabled); False (Disabled state)
Not available. Reporting\EnableReporting False
ReportingServerURL
String
Not available. Reporting\ReportingServer Policy value not written (same as Not Configured)
ReportingDataCacheLimit
Integer [0-1024]
Not available. Reporting\DataCacheLimit Policy value not written (same as Not Configured)
ReportingDataBlockSize
Integer [1024 - Unlimited]
Not available. Reporting\DataBlockSize Policy value not written (same as Not Configured)
ReportingStartTime
Integer (0 23)
Not available. Reporting\ StartTime Policy value not written (same as Not Configured)
ReportingInterval
Integer
Not available. Reporting\RetryInterval Policy value not written (same as Not Configured)
ReportingRandomDelay
Integer [0 - ReportingRandomDelay]
Not available. Reporting\RandomDelay Policy value not written (same as Not Configured)
**EnableDynamicVirtualization
**1 (Enabled), 0 (Disabled)
Not available. HKEY_LOCAL_MACHINE\Software\Microsoft\AppV\Client\Virtualization
EnablePublishingRefreshUI
1 (Enabled), 0 (Disabled)
Not available. HKEY_LOCAL_MACHINE\Software\Microsoft\AppV\Client\Publishing
HidePublishingRefreshUI
1 (Enabled), 0 (Disabled)
Not available.
ProcessesUsingVirtualComponents
String
Not available. Virtualization\ProcessesUsingVirtualComponents Empty string.

Have a suggestion for App-V?

Add or vote on suggestions here. For App-V issues, use the App-V TechNet Forum.

Deploying the App-V Sequencer and Client

How to Modify App-V Client Configuration Using the ADMX Template and Group Policy