SVSCMD command-line parameters

Article:HOWTO50142  |  Created: 2011-04-18  |  Updated: 2011-09-26  |  Article URL http://www.symantec.com/docs/HOWTO50142
Article Type
How To


Subject


SVSCMD command-line parameters

The SVSCMD executable file is installed with the Workspace Virtualization Agent. You can use this executable file with its command-line parameters to work with Virtual Software Packages. Many of the command-line parameters also have associated flags.

See About the management of virtual software layers

See SVSCMD parameter flags

To display the parameters and flags for SVSCMD, use the Help parameter. This parameter also displays SVSCMD examples.

See SVSCMD command-line examples

The syntax for using SVSCMD is:

SVSCMD [LayerGUID|LayerName] { [flags]} [...n]

The following table is a list of the available command-line parameters:

Table: SVSCMD command-line parameters

Parameter

Associated Flags

Description

A[CTIVATE]

Activates the layer.

AUTO[ACTIVATE]

[-Y|-N]

Sets a layer to activate at the start of the computer. If this parameter is entered without a flag, the default behavior is to automatically activate on start.

AUTORUN

[-A|-D]

Add or delete process to automatically run in the layer. Providing no options lists the processes that are set to automatically run in the layer.

C[APTURE]

[-P|-S|-E]

Creates a new layer by capturing changes. You cannot perform a capture if any other layer is activated on the computer. Layer names are limited to 50 characters.

CHECKKEY

-K

Checks for a valid product serial number. This parameter tells you if your key is good and provides information about it. If this parameter is entered without a flag, the default behavior is to check for a valid product serial number.

CLO[NE]

-NAME [-RW]

Clones a layer.

CREATE

Creates an empty layer. Layer names are limited to 50 characters

D[EACTIVATE]

[-F]

Deactivates the layer.

DEP[ENDS]

[-A|-D]

Add, delete, or view independent layers.

DEL[ETE]

[-F]

Deletes the layer.

DIFF[ERENCE]

-P [-F]

Create a patch file.

ENUM[ERATELAYERS]

[-V]

Lists all layers on the computer.

EXCLUDEALLPROFILES

[-Y|-N]

Excludes all files that are stored in the user profile. This option creates a global exclude that affects all layers.

EXEC[FROMLAYER]

[-PID|-PATH][-NOWAIT]

Executes a process as a part of a layer so that it appears to run from the layer. This command can be used as follows:

  • If you want an audit tool to see the computer from the perspective of the layer, you can run SVSCMD "LayerName" EXEC [path to the executable file]. Then, any process that runs has the same priority as if it were run from the layer.

  • If you run a process that makes changes to the file system or registry, those changes are saved in the layer and not in the base. For example, you can run an EXE patch with this parameter to save changes that the patch in the layer makes.

E[XPORT]

[-P]

Exports the layer to a virtual software archive file or virtual runtime archive file. The provided file extension specifies the layer archive type. Provide an xpf extension to use the Extensible Package Format. Provide a vsa extension to use the legacy virtual software archive format.

EXIT

[-Y|-N]

Set a layer to deactivate on last process exit.

H[ELP]

Displays the SVSCMD command-line parameters, flag options, and command-line examples.

Ignore

[-W] -P

Tells Workspace Virtualization to ignore this process.

I[MPORT]

[-P|-F]

Imports a virtual software archive file. Archive files can be in xpf, vsa, or vra format.

KEEP

-FILE|-REG [-A|-D]

File/registry items to keep in a layer. Providing no options lists the registry items currently set to keep in the layer.

NEWRESET[POINT]

[-SID]

Create new reset point. Copy read-write sublayer to read-only sublayer. The SID option copies the given SID's read-write to the read-only's user template area. Without -SID no SID information is copied

PARTIALACTIVATE

[-Y|-N] | [-LAYERCHANGED] [-BACKGROUND]

Enables partial activation.

See Activating a virtual software layer using a desktop shortcut

PAT[CH]

-P [-INPLACE|-RW]

Applies a patch file. The -INPLACE option overlays the patch over the existing layer. The -RW option copies the existing Read Write layer to the new layer that the patch creates.

PRIORITY

[-T|-L|-R]

Sets the priority of a layer.

See How layer prioritization works.

P[ROPERTIES]

[-V]

Displays the following properties of a layer: name, state, type, priority, version, GUID, last activated time, create time, last reset time, redirect locations, layer subtype, depot GUID, and the layer's depot path.

REF[RESHDESKTOP]

This parameter has been deprecated.

REN[AME]

-NAME

Renames the layer. Layer names are limited to 50 characters.

REL[OAD]

Reloads the Global Exclude list from the registry into the Workspace Virtualization Agent. Use this command after the global exclude properties have been manually changed in the registry. This list is reloaded automatically when the computer is restarted, or if the changes were made locally using the SWV Admin tool.

R[ESET]

[-F]

Resets the layer.

SEND[INVENTORY]

Sends updated inventory data to Notification Server.

SETGUID

Sets the layer ID to the new GUID.

SETKEY

-K

Updates the product serial number. You can use this parameter to manually set a key.

VER[SION]

Displays Workspace Virtualization version information.

VIS[IBILITY]

[-SET|-UNSET]

Set, unset, or view a layer's visibility.


Legacy ID



id-SF0P0111671_v57224467


Article URL http://www.symantec.com/docs/HOWTO50142


Terms of use for this information are found in Legal Notices