App-V Client Registry Values
Atualizada: Abril de 2010
Aplica-se a: Application Virtualization, Application Virtualization 4.6 SP1
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 all the Application Virtualization (App-V) client registry keys and explains their uses.
Importante
On a computer running a 64-bit operating system, the keys and values described in the following sections will be under HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\SoftGrid\4.5\Client.
Configuration Key
The following table provides information about the registry values associated with the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SoftGrid\4.5\Client\Configuration key.
| Name | Type | Data (Examples) | Description |
|---|---|---|---|
ProductName |
String |
Microsoft Application Virtualization Desktop Client |
Do not modify. |
Version |
String |
4.5.0.xxx |
Do not modify. |
Drivers |
String |
Sftfs.sys |
If this key value is present, it contains the name of the driver that caused a stop error the last time the core was starting. After you have fixed the stop error, you must delete this key value so that sftlist can start. |
InstallPath |
String |
Default=C:\Program Files\Microsoft Application Virtualization Client |
The location where the client is installed. Do not modify. |
LogFileName |
String |
Default=CSIDL_COMMON_APPDATA\Microsoft\Application Virtualization Client\sftlog.txt |
The path and name for the client log file. Nota If you are running an earlier version than App-V 4.6, SP1 and you modify the log file name or location, you must restart the sftlist service for the change to take effect. |
LogMinSeverity |
DWORD |
Default=4, Informational |
Controls which messages are written to the log. The value indicates a threshold of what is logged—everything less than or equal to that value is logged. For example, a value of 0x3 (Warning) indicates that Warnings (0x3), Errors (0x2), and Critical Errors (0x1) are logged. Value Range: 0x0 = None, 0x1 = Critical, 0x2 = Error, 0x3 = Warning, 0x4 = Information (Default), 0x5 = Verbose. The log level is configurable from the Application Virtualization (App-V) client console and from the command prompt. At a command prompt, the command sftlist.exe /verboselog will increase the log level to verbose. For more information on command-line details see https://go.microsoft.com/fwlink/?LinkId=141467https://go.microsoft.com/fwlink/?LinkId=141467 . |
LogRolloverCount |
DWORD |
Default=4 |
Defines the number of backup copies of the log file that are kept when it is reset. The valid range is 0–9999. The default is 4. A value of 0 means no copies will be kept. |
LogMaxSize |
DWORD |
Default=256 |
Defines the maximum size in megabytes (MB) that the log file can grow before being reset. The default size is 256 MB. When this size is reached, a log reset will be forced on the next write attempt. |
SystemEventLogLevel |
DWORD |
Default=0x4 (App-V 4.5) Default=0x3 (App-V 4.6) |
Indicates the logging level at which log messages are written to the NT event log. The value indicates a threshold of what is logged—that is, everything equal to or less than that value is logged. For example, a value of 0x3 (Warning) indicates that Warnings (0x3), Errors (0x2), and Critical Errors (0x1) are logged. Value Range 0x0 = None 0x1 = Critical 0x2 = Error 0x3 = Warning 0x4 = Information (Default) 0x5 = Verbose |
AllowIndependentFileStreaming |
DWORD |
Default=0 |
Indicates whether streaming from file will be enabled regardless of how the client has been configured with the APPLICATIONSOURCEROOT parameter. If set to FALSE, the transport will not enable streaming from files even if the OSD HREF or the APPLICATIONSOURCEROOT parameter contains a file path. 0x0=False (default) 0x1=True |
ApplicationSourceRoot |
String |
rtsps://mainserver:322/prodapps https://mainserver:443/prodapps file://\\uncserver\share\prodapps file://\\uncserver\share |
Enables an administrator or electronic software distribution (ESD) system to ensure application loading is performed according to the topology management scheme. Use this key value to override the OSD CODEBASE for the HREF element (for example, the source location) for an application. Application Source Root supports URLs and Universal Naming Convention (UNC) path formats. The correct format for the URL path is protocol://servername:[port][/path][/], where port and path are optional. If a port is not specified, the default port for the protocol is used. Only the protocol://server:port portion of the OSD URL is replaced. The correct format for the UNC path is \\computername\sharefolder\[folder][\], where folder is optional. The computer name can be a fully qualified domain name (FQDN) or an IP address, and sharefolder can be a drive letter. Only the \\computername\sharefolder or drive letter portion of the OSD path is replaced. |
OSDSourceRoot |
String |
\\computername\sharefolder\resource \\computername\content C:\foldername http://computername/productivity/ https://computername/productivity/ |
Enables an administrator to specify a source location for OSD file retrieval for a sequenced application package during publication. Acceptable formats for the OSDSourceRoot include UNC paths and URLs (http or https). |
IconSourceRoot |
String |
\\computername\sharefolder\resource \\computername\content C:\foldername http://computername/productivity/ https://computername/productivity/ |
Enables an administrator to specify a source location for icon file retrieval for a sequenced application package during publication. Acceptable formats for the IconSourceRoot include UNC paths and URLs (http or https). |
AutoLoadTriggers |
DWORD |
Default=5 |
AutoLoad is a client runtime policy configuration parameter that enables the secondary feature block of a virtualized application to be streamed to the client automatically in the background. The AutoLoad triggers are flags to indicate events that initiate auto-loading of applications. AutoLoad implicitly uses background streaming to enable the application to be fully loaded into cache. The primary feature block will be loaded first, and the remaining feature blocks will be loaded in the background to enable foreground operations, such as user interaction with applications, to take place and provide optimal perceived performance. Bit mask values: (0) Never: No bits are set (value is 0), no auto loading will be performed, because there are no triggers set. (1) OnLaunch: Loading starts when a user starts an application. (2) OnRefresh: Loading starts when the application is published. This occurs whenever the package record is added or updated—for example, when a publishing refresh occurs. (4) OnLogin: Loading starts when a user logs in. (5) OnLaunch and OnLogin: Default. |
AutoLoadTarget |
DWORD |
Default=1 |
Indicates what will be auto-loaded when any given AutoLoad triggers occur. Bit mask values: (0) None: No auto-loading, regardless of what triggers may be set. (1) PreviouslyUsed (default): If any AutoLoad trigger is enabled, load only the packages where at least one application in the package has been previously used—that is, started or precached. (2) All: If any AutoLoad trigger is enabled, all applications in the package (per package) or all packages (set for client) will be automatically loaded, whether or not they have ever been started. |
RequireAuthorizationIfCached |
DWORD |
Default=1 |
Indicates that authorization is always required, whether or not an application is already in cache. Possible values: 0=False: Always try to connect to the server. If a connection to the server cannot be established, the client still allows the user to launch an application that has previously been loaded into cache. 1=True (default): Application always must be authorized at startup. For RTSP streamed applications, the user authorization token is sent to the server for authorization. For file-based applications, file ACLs control whether a user may access the application. Restart the sftlist service for the change to take effect. |
UserDataDirectory |
String |
%APPDATA% |
Location where the icon cache and user settings are stored. |
GlobalDataDirectory |
String |
C:\Users\Public\Documents |
Directory to use for global App-V data, including caches for OSD files, icon files, shortcut information, and SystemGuard resources such as .ini files. |
AllowCrashes |
DWORD |
0 or 1 |
Default=0: A value of 0 means that the client tries to catch internal program exceptions so that other user applications can recover and continue when a crash happens. A value of 1 means that the client allows the internal program exceptions to occur so that they can be captured in a debugger. |
CoreInternalTimeout |
DWORD |
60 |
Time-out in seconds for internal IPC requests between core and front-end. Do not modify. |
DefaultSuiteCombineTime |
DWORD |
10 |
This value is used to indicate how soon after being started that a program can shut down and not generate any error messages when another application in the same suite is running. |
SerializedSuiteLaunchTimeout |
DWORD |
Default=60000 |
Defines how long in milliseconds the client will wait as it tries to serialize program starts in the same suite. If the client times out, the program start will continue but it will not be serialized. |
ScriptTimeout |
DWORD |
300 |
Default time-out in seconds for scripts in OSD file if WAIT=TRUE. You can specify per-script time-outs with TIMEOUT instead of WAIT. A value of 0 means no wait, and 0xFFFFFFFF means wait forever. |
LaunchRecordLogPath |
String |
If, under either HKLM or HKCU, this value contains a valid path to a log file, SFTTray will write to this log when programs start, shut down, fail to launch, and enter or exit disconnected mode. |
|
LaunchRecordMask |
DWORD |
0x1A (26) log launch errors and disconnected mode entry and exit activity. 0x1F (31) logs everything. 0x0 (0) logs nothing. |
Specifies which of the five events are logged (bitmask values): 1 for program starts 2 for launch failure errors 4 for shutdowns 8 for entering disconnected mode 16 for exiting disconnected mode to reconnect to a server Add any combination of those numbers to turn on the respective messages. Defaults to 0x1F if not in registry. |
LaunchRecordWriteTimeout |
DWORD |
Default=3000 |
Specifies in milliseconds how long the tray will wait when trying to write to the launch record log if another process is using it. |
ImportSearchPath |
String |
d:\files\;C:\documents and settings\user1\SFTs |
A semicolon delimited list of up to five directories to search for portable SFT files before prompting the user to select a directory. Trailing backslash in paths is optional. This value is not present by default and must be set manually. |
UserImportPath |
String |
D:\SFTs\ |
Valid only under HKCU. The last location the user browsed to while finding a SFT file for package import. Set automatically if the SFT is found successfully. This is used on successive imports when trying to automatically locate SFT files. |
Shared Key
The HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SoftGrid\4.5\Shared key controls values that are shared across App-V components. The following table provides information about the registry values associated with the Shared key.
| Name | Type | Data (Examples) | Description |
|---|---|---|---|
DumpPath |
String |
Default=C:\ |
Default path to create dump files when generating a minidump on an exception. This defaults to C:\ if not specified. The Client installer sets this key to the <App Virtualization global data directory>\Dumps. The Sequencer installer sets this key to the installation directory. |
DumpPathSizeLimit |
DWORD |
1000 |
Specifies the maximum total amount of disk space in megabytes that can be used to store minidumps. Default = 1000 MB. |
Network Key
The HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SoftGrid\4.5\Client\Network key controls a variety of network-related parameters. This key is primarily used by the network transport agent. The following table provides information about the registry values associated with the Network key.
| Name | Type | Data (Examples) | Description |
|---|---|---|---|
Online |
DWORD |
Default=1 |
Enables or disables offline mode. If set to 0, the client will not communicate with App-V Management Servers or publishing servers. In disconnected operations, the client can start a loaded application even when it is not connected to an App-V Management Server. In offline mode, the client does not attempt to connect to an App-V Management Server or publishing server. You must allow disconnected operations to be able to work offline. Default value is 1 enabled (online), and 0 is disabled (offline). |
AllowDisconnectedOperation |
DWORD |
Default=1 |
Enables or disables disconnected operation. Default value is 1 enabled, and 0 is disabled. When disconnected operations are enabled, the App-V client can start a loaded application even when it is not connected to an App-V Management Server. |
FastConnectTimeout |
DWORD |
Default=1000 |
This value specifies the TCP connect time-out in milliseconds to determine when to go into disconnected operations mode. This value can be used to override the default ConnectTimeout of 20 seconds (App-V connect time-out for network transactions) or the system’s TCP time-out of approximately 25 seconds. This brings the client into disconnected operations mode quickly. Applied on the next connect. |
LimitDisconnectedOperation |
DWORD |
Default=1 |
Applicable only if AllowDisconnectedOperation is 1, enabled. This value determines whether there will be a time limit for how long the client will be allowed to operate in disconnected operations. 1=limited. 0=unlimited. |
DOTimeoutMinutes |
DWORD |
Default=129,600 |
Indicates how many minutes an application may be used in disconnected operation mode. |
The valid values are 1–999,999 in days expressed in minutes (1–1,439,998,560 minutes). The default value is 90 days or 129,600 minutes. |
|||
Protocol |
DWORD |
Default=8 |
Default protocol to use (TCP vs SSL). Configure in Options Dialog. |
ReadTimeout |
DWORD |
20 |
Read time-out for network transactions, in seconds. Do not modify. |
WriteTimeout |
DWORD |
20 |
Write time-out for network transactions, in seconds. Do not modify. |
ConnectTimeout |
DWORD |
20 |
Connect time-out for network transactions, in seconds. Do not modify. |
ReestablishmentRetries |
DWORD |
3 |
The number of times to try to reestablish a dropped session. |
ReestablishmentInterval |
DWORD |
15 |
The number of seconds to wait between tries to reestablish a dropped session. |
Http Key
The HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SoftGrid\4.5\Client\Network\Http key controls the parameters that are related to Http streaming. This key is used primarily by the network transport agent. The following table provides information about the registry values that are associated with the Http key.
| Name | Type | Data (Examples) | Description |
|---|---|---|---|
LaunchIfNotFound |
DWORD |
Default=0 |
Controls the behavior of HTTP streaming when a connection to the HTTP server can be established and the package file no longer exists on the HTTP server. If the value does not exist or if it is not set to 1, the App-V client does not let you launch an application that has previously been loaded into cache. |
1 |
If this value is set to 1, the App-V client lets you launch an application that has previously been loaded into cache. |
File System Key
The values that are contained under the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SoftGrid\4.5\Client\AppFS key control the file system parameters for App-V. The following table provides information about the registry values associated with the AppFS key.
| Name | Type | Data (Examples) | Description |
|---|---|---|---|
FileSize |
DWORD |
4096 |
Maximum size in megabytes of file system cache file. If you change this value in the registry, you must set State to 0 and reboot. |
FileName |
String |
C:\Users\Public\Documents\SoftGrid Client\sftfs.fsd |
Location of file system cache file. If you change this value in the registry, you must either leave FileSize the same and reboot or set State to 0 and reboot. |
DriveLetter |
String |
Q: |
Drive where App-V file system will be mounted, if it is available. This value is set either by the listener or the installer, and it is read by the file system. |
State |
DWORD |
0x100 |
State of file system. Set to 0 and reboot to completely clear the file system cache. |
FileSystemStorage |
String |
C:\Profiles\Joe\SG |
Path for symlinks, set under HKCU. Do not modify (use data directory under Configuration to change). |
GlobalFileSystemStorage |
String |
C:\Users\Public\Documents\SoftGrid Client\AppFS Storage |
Path for global file system data. Do not modify. |
MaxPercentToLockInCache |
DWORD |
Default=90 |
Specifies the maximum percentage of the file system cache file that can be locked. Do not modify. |
UnloadLeastRecentlyUsed |
DWORD |
Default=1 |
The file system cache space management feature uses a Least Recently Used (LRU) algorithm and is enabled by default. If the space that is required for a new package would exceed the available free space in the cache, the App-V Client uses this feature to determine which, if any, existing packages it can delete from the cache to make room for the new package. The client deletes the package with the oldest last-accessed date if it is older than the value specified in the MinPkgAge registry value. Values are 0 (disabled) and 1 (default, enabled). |
MinPackageAge |
DWORD |
1 |
To determine when the package can be selected for discard, set this registry value to equal the minimum number of days you want to elapse since the package was last accessed. Packages that have been used more recently are not discarded. |
Permissions Key
To help to prevent users from making mistakes, administrators can use the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SoftGrid\4.5\Client\Permissions key to control access to some actions for non-administrative users—for example, to prevent users from accidentally unloading programs. Users with administrative rights can give themselves any of these permissions. On shared systems, such as a Remote Desktop Session Host (RD Session Host) server (formerly Terminal Server) system, be careful when granting additional permissions to users because some of these permissions would enable users to control the applications used by all users on the system. Possible values for these settings are 1 (allow) and 0 (disallow).
The Permissions key settings control all interfaces that enable the named actions. This includes the Options Dialog, SFTTray, and SFTMime. These settings do not affect administrators. The following table provides information about the registry values associated with the Permissions key.
| Name | Type | Data (Examples) | Description |
|---|---|---|---|
|
ChangeFSDrive |
DWORD |
Default=0 |
A value of 1 allows users to pick a different drive letter to be used as the file system drive. |
|
ChangeCacheSize |
DWORD |
Default=0 |
A value of 1 allows users to change the cache size. |
|
ChangeLogSettings |
DWORD |
Default=0 |
A value of 1 allows users to modify the log level, change its location, and reset it through the user interface. |
|
AddApp |
DWORD |
Default=0 |
A value of 1 allows users to add applications explicitly. This does not affect applications that are added through publishing refresh nor does it prevent users from starting (and thereby implicitly adding) applications that have not already been added. Values are 0 or 1. |
|
LoadApp |
DWORD |
0 |
Does not allow a user to load an application. This is the default for RD Session Hosts. If you are a mobile user, you might want to fully load your applications in the cache to use them during disconnected operation or offline mode. To stream applications from the App-V Management Server or the App-V Streaming Server, you must be connected to a server to load applications. |
|
|
|
1 |
Allows a user to load an application. This is the default for Windows desktops. |
|
UnloadApp |
DWORD |
0 |
Does not allow a user to unload an application. When you load or unload a package, all the applications in the package are loaded into or removed from cache. |
|
|
|
1 |
Allows a user to unload an application. |
|
LockApp |
DWORD |
0 |
Does not allow a user to lock and unlock an application. This is the default for RD Session Hosts. A locked application cannot be removed from the cache to make room for new applications. To remove a locked application from the App-V Desktop or Client for Remote Desktop Services (formerly Terminal Services) cache, you must unlock it. |
|
|
|
1 |
Allows a user to lock and unlock an application. This is the default for Windows Desktops. |
|
ManageTypes |
DWORD |
0 |
Does not allow a user to add, edit, or remove file type associations for that User alone. This is the default for RD Session Hosts. |
|
|
|
1 |
Allows a user to add, edit, and remove file type associations for that user only and not globally. This is the default for Windows Desktops. |
|
RefreshServer |
DWORD |
0 |
Does not allow a user to trigger a refresh of MIME settings. This is the default for RD Session Hosts. |
|
|
|
1 |
Enables a user to trigger a refresh of MIME settings. This is the default for Windows Desktops. |
|
UpdateOSDFile |
DWORD |
Default= 0 |
A value of 1 enables a user to use a modified OSD file. |
|
ImportApp |
DWORD |
0 |
Does not allow a user to import applications into cache. The difference between Load and Import is that when a Load is triggered, the client gets the package from the currently configured location contained in the OSD, ASR, or Override URL. When using Import, a location to get the package from must be specified. |
|
|
|
1 |
Allows a user to import applications into cache. |
|
ChangeRefreshSettings |
DWORD |
Default=0 |
A value of 1 allows users to modify the refresh settings for servers (refresh on login and periodic refresh). This does not imply that the user can modify other server settings (path, host, and so on). |
|
ManageServers |
DWORD |
Default=0 |
A value of 1 allows the user to add, edit, and remove servers, except for editing the refresh settings, which is controlled by the ChangeRefreshSettings permission. |
|
PublishShortcut |
DWORD |
Default=0 |
A value of 1 allows users to publish shortcuts through the user interface. This does not affect shortcuts that are published during a publishing refresh. |
|
ViewAllApplications |
DWORD |
Default=0 |
A value of 1 displays all applications through the user interface; otherwise, only the user’s applications are displayed. |
|
RepairApp |
DWORD |
Default=1 |
A value of 1 allows the user to use the Repair action on applications in SFTMime or the Client Management Console. When you repair an application, you remove any custom user settings and restore the default settings. This action does not change or delete shortcuts or file type associations, and it does not remove the application from cache. |
|
ClearApp |
DWORD |
Default=1 |
A value of 1 allows the user to use the Clear action on applications in SFTMime or the Client Management Console. When you clear an application from the console, you can no longer use that application. However, the application remains in cache and is still available to other users on the same system. After a publishing refresh, the cleared applications will again become available to you. |
|
DeleteApp |
DWORD |
Default=0 |
A value of 1 allows the user to use the Delete action on applications in SFTMime or the Client Management Console. When you delete an application, the selected application will no longer be available to any users on that client. Shortcuts and file type associations are deleted and the application is deleted from cache. However, if another application refers to data in the file system cache or settings data for the selected application, these items will not be deleted. |
|
After a publishing refresh, the deleted applications will again become available to you. |
|||
|
ToggleOfflineMode |
DWORD |
|
A value of 1 allows the users to select to run the client in Offline Mode. In Offline Mode, the Application Virtualization client can start a loaded application even when it is not connected to an Application Virtualization Server. |
Custom Settings
The HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SoftGrid\4.5\Client\CustomSettings key contains values specific to front-end components. All custom settings are stored as strings. The following table provides information about the registry values associated with the CustomSettings key.
| Name | Type | Data (Examples) | Description |
|---|---|---|---|
TrayErrorDelay |
DWORD |
Default=30 |
Time in seconds that the Application Virtualization notification area will display error messages like "Launch failed". Minimum value of 1. |
TraySuccessDelay |
DWORD |
Default=10 |
Time in seconds that the appvmed notification area will display success messages like "Word launched" or "Excel shut down". If 0, those messages will be suppressed. |
TrayVisibility |
DWORD |
Default=0 |
0=Show Tray when virtualized applications are in use. 1=Show Tray always. 2=Never show Tray. |
TrayShowRefresh |
DWORD |
When present and set to a value of 1, allows menu item Refresh Applications to be displayed on the Tray menu and is accessible by the user. |
|
TrayShowLoad |
DWORD |
When present and set to a value of 1, allows menu item Load Applications to be displayed on the Tray menu and is accessible by the user. |
Reporting Settings
The HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SoftGrid\4.5\Client\Reporting key contains values specific to reporting to an App-V Management Server. The following table provides information about the registry values associated with the Reporting key.
| Name | Type | Data (Examples) | Description |
|---|---|---|---|
DataCacheLimit |
DWORD |
Default=20 |
This value 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. When a new record is added (bottom of the list), one or more of the oldest records (top of the list) will be deleted to make room. A warning will be logged to the Client log and the event log the first time this occurs, and it will not be logged again until after the cache has been successfully cleared on transmission and the log has filled up again. |
DataBlockSize |
DWORD |
Default=65536 |
This value specifies the maximum size in bytes to transmit to the server at once on publishing refresh, to avoid permanent transmission failures when the log has reached a significant size. The default value is 65536. When transmitting report data to the server, one block of application records—less than or equal to the block size in bytes of XML data—will be removed from the cache and sent to the server. Each block will have the general Client data and global package list data prepended, and these will not factor into the block size calculations; the potential exists for an extremely large package list to result in transmission failures over low bandwidth or unreliable connections. |
Consulte Também
Outros Recursos
Application Virtualization Client Reference
-----
You can learn more about MDOP in the TechNet Library, search for troubleshooting on the TechNet Wiki, or follow us on Facebook or Twitter.
-----