Application Virtualization Client Installer Command-Line Parameters

Updated: September 7, 2010

Applies To: Application Virtualization

The following table lists all available Microsoft Application Virtualization Client installer command-line parameters, their values, and a brief description of each parameter. Parameters are case-sensitive and must be entered as all-uppercase letters. All parameter values must be enclosed in double quotes.

Note

For App-V version 4.6, command-line parameters cannot be used during a client upgrade.

The
SWICACHESIZE
and
MINFREESPACEMB
parameters cannot be combined on the command line. If both are used, the
SWICACHESIZE
parameter will be ignored.

Parameter

Values

Description

ALLOWINDEPENDENTFILESTREAMING

TRUE

FALSE

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.

Possible values:

TRUE—Manually deployed application may be loaded from disk.

FALSE—All applications must come from source streaming server.

APPLICATIONSOURCEROOT

RTSP://
URL
(for dynamic package delivery)

File://
URL
or
UNC
(for load from file package delivery)

To enable an administrator or an electronic software distribution system to ensure that application loading is performed in compliance with the topology management scheme, allows an override of the OSD CODEBASE for the application HREF element (the source location). If the value is “”, which is the default value, the existing OSD file settings are used.

A URL has several parts:

<protocol>://<server>:<port>/<path>/<?query><#fragment>

A UNC path has three parts:

\\<computername>\<share folder>\<resource>

If the
APPLICATIONSOURCEROOT
parameter is specified on a client, the client will break the URL or UNC path from an OSD file into its constituent parts and replace the OSD sections with the corresponding
APPLICATIONSOURCEROOT
sections.

Important

Be sure to use the correct format when using file:// with a UNC path. The correct format is file://\\<server>\<share>.

ICONSOURCEROOT

UNC

HTTP://
URL
or HTTPS://
URL

Enables an administrator to specify a source location for icon retrieval for a sequenced application package during publication. Icon source roots support UNC paths and URLs (HTTP or HTTPS). If the value is “”, which is the default value, the existing OSD file settings are used.

A URL has several parts:

<protocol>://<server>:<port>/<path>/<?query><#fragment>

A UNC path has three parts:

\\<computername>\<share folder>\<resource>

Important

Be sure to use the correct format when using a UNC path. Acceptable formats are \\<server>\<share> or <drive letter>:\<folder>.

OSDSOURCEROOT

UNC

HTTP://
URL
or HTTPS://
URL

Enables an administrator to specify a source location for OSD file retrieval for an application package during publication. OSD source roots support UNC paths and URLs (HTTP or HTTPS). If the value is “”, which is the default value, the existing OSD file settings are used.

A URL has several parts:

<protocol>://<server>:<port>/<path>/<?query><#fragment>

A UNC path has three parts:

\\<computername>\<share folder>\<resource>

Important

Be sure to use the correct format when using a UNC path. Acceptable formats are \\<server>\<share> or <drive letter>:\<folder>.

AUTOLOADONLOGIN

AUTOLOADONLAUNCH

AUTOLOADONREFRESH

[0|1]

The AutoLoad triggers that define the 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 as quickly as possible. Remaining feature blocks will be loaded in the background to enable foreground operations, such as user interaction with applications, to take priority and provide optimal performance.

Note

The
AUTOLOADTARGET
parameter determines which applications are auto-loaded. By default, packages that have been used are auto-loaded unless
AUTOLOADTARGET
is set.

Each parameter affects loading behavior as follows:

AUTOLOADONLOGIN
—Loading starts when the user logs in.

AUTOLOADONLAUNCH
—Loading starts when the user starts an application.

AUTOLOADONREFRESH
—Loading starts when a publishing refresh occurs.

The three values can be combined. In the following example, AutoLoad triggers are enabled both at user login and when publishing refresh occurs:

AUTOLOADONLOGIN AUTOLOADONREFRESH

Note

If the client is configured with these values at first install, Autoload will not be triggered until the next time the user logs off and logs back on.

AUTOLOADTARGET

NONE

ALL

PREVUSED

Indicates what will be auto-loaded when any given AutoLoad triggers occur.

Possible values:

NONE—No auto-loading, regardless of what triggers might be set.

ALL—If any AutoLoad trigger is enabled, all packages are automatically loaded, whether or not they have ever been launched.

Note

This setting is configured for individual packages by using the SFTMIME
ADD PACKAGE
and
CONFIGURE PACKAGE
commands. For more information about these commands, see SFTMIME Command Reference.

PREVUSED—If any AutoLoad trigger is enabled, load only the packages where at least one application in the package has been previously used (that is, launched or precached).

Note

When you install the App-V client to use a read-only cache, (for example, as a VDI server implementation), you must set the
AUTOLOADTARGET
parameter to NONE to prevent the client from trying to update applications in the read-only cache.

DOTIMEOUTMINUTES

29600 (default)

1–1439998560 minutes (range)

Indicates how many minutes an application may be used in disconnected operation.

Microsoft Application Virtualization Client components will be upgradable through Microsoft Update when updates are made available to the general public. The Microsoft Update Agent installed on Windows operating systems requires a user to explicitly opt-in to use the service. This opt-in is required only one time for all applications on the device. If you have already opted into Microsoft Update, the Microsoft Application Virtualization components on the device will automatically take advantage of the service.

For command-line installation, use of Microsoft Update is by default opt-out (unless a previous application already enabled the device to be opted in) due to the requirement for manually opting into Microsoft Update. Therefore, opting in must be explicit for command-line installations. Setting the command-line parameter
OPTIN
to TRUE forces the Microsoft Update opt-in to be set.

REQUIREAUTHORIZATIONIFCACHED

TRUE

FALSE

Indicates whether authorization is always required, whether or not an application is already in cache.

Possible values:

TRUE—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 dictate whether a user may access the application.

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.

SWICACHESIZE

Cache size in MB

Specifies the size in megabytes of the client cache. The default size is 4096 MB, and the maximum size is 1,048,576 MB (1 TB). The system checks for the available space at installation time, but the space is not reserved.

Example:
SWICACHESIZE="1024"

SWIPUBSVRDISPLAY

Display name

Specifies the displayed name of the publishing server; required when
SWIPUBSVRHOST
is used.

Example:
SWIPUBSVRDISPLAY="PRODUCTION ENVIRONMENT"

SWIPUBSVRTYPE

[HTTP|RTSP]

Specifies the publishing server type. The default server type is Application Virtualization Server. The
/secure
switch is not case sensitive.

HTTP—Standard HTTP Server

HTTP
/secure
—Enhanced Security HTTP Server

RTSP—Application Virtualization Server

RTSP
/secure
—Enhanced Security Application Virtualization Server

Example:
SWIPUBSVRTYPE="HTTP /secure"

SWIPUBSVRHOST

IP address|host name

Specifies either the IP address of the Application Virtualization Server or a host name of the server that resolves into the server's IP address; required when
SWIPUBSVRDISPLAY
is used.

Example:
SWIPUBSVRHOST="SERVER01"

SWIPUBSVRPORT

Port number

Specifies the logical port that is used by this Application Virtualization Server to listen for requests from the client (default = 554).

Standard HTTP server—Default = 80.

Enhanced Security HTTP Server—Default = 443.

Application Virtualization Server—Default = 554.

Enhanced Security Application Virtualization Server—Default = 322.

Example:
SWIPUBSVRPORT="443"

SWIPUBSVRPATH

Path name

Specifies the location on the publishing server of the file that defines file type associations (default = /); required when the
SWIPUBSVRTYPE
parameter value is HTTP.

Example:
SWIPUBSVRPATH="/AppVirt/appsntypes.xml"

SWIPUBSVRREFRESH

[ON|OFF]

Specifies whether the client automatically queries the publishing server for file type associations and applications when a user logs in to the client (default = ON).

Example:
SWIPUBSVRREFRESH="off"

SWIGLOBALDATA

Global data directory

Specifies the directory where data will be stored that is not specific to particular users (default = C:\Documents and Settings\All Users\Documents\).

Corresponds to the drive letter that you selected for the virtual drive.

Example:
SWIFSDRIVE="S"

SYSTEMEVENTLOGLEVEL

0–4

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.

Possible values:

0 == None

1 == Critical

2 == Error

3 == Warning

4 == Information

MINFREESPACEMB

In MB

Specifies the amount of free space (in megabytes) that must be available on the host before the cache size can increase. The following example would configure the client to ensure at least 5 GB of free space on the disk before allowing the size of the cache to increase. The default is 5000 MB of free space available on disk at installation time.

Example:
MINFREESPACEMB ="5000" (5 GB)

KEEPCURRENTSETTINGS

[0|1]

Used when you have applied registry settings prior to deploying a client—for example, by using Group Policy. When a client is deployed, set this parameter to a value of 1 so that it will not overwrite the registry settings.

Important

If set to a value of 1, the following client installer command-line parameters are ignored:

For further information about setting these values after installation, see “How to Configure the App-V Client Registry Settings by Using the Command Line” in the Application Virtualization (App-V) Operations Guide (http://go.microsoft.com/fwlink/?LinkId=122939).