si viewprefs

si viewprefs [--[no]global] [--command=value] [--[no]showValidValues] [--[no]ask] [--ui=[unspecified|gui|cli|api]] [(-?|--usage)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [(-F file|--selectionFile=file)] [--settingsUI=[gui|default]] [--status=[none|gui|default]]

si viewprefs displays preferences and configuration options. These settings are used to determine default behaviors for other commands.

Your administrator can lock certain preferences from the Integrity Lifecycle Manager Server, preventing you from configuring them using the si setprefs command. Preferences that are locked display (locked) at the end of the output line. The following preferences can be locked from the server by editing Integrity Lifecycle Manager policies in the Administration Client:

For information on editing the Integrity Lifecycle Manager policies, see the online help.

Preference

Affected Commands

branchIfVariant

breakLock

changePackageID

moveLock

onExistingArchive

restoreTimestamp

retainWorkingFile

saveTimestamp

sparse

updateMemberRev

Do not edit the IntegrityClient.rc file manually, because preferences that appear more than once in the IntegrityClient.rc file can cause Integrity Lifecycle Manager to behave unpredictably.

This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions. For an easy way to see a list of commands and values that may be set, simply type the si viewprefs command, either piped through |more or redirected to a file, for example:

Alternatively, the --gui option presents a simple-to-use dialog box that lets you view and configure the preferences.

controls whether to view the ask control over the preference options. See the description for --[no]ask on the si setprefs command.

controls whether to view the preference as it applies to the graphical user interface, the command line interface, application programming interface, or when the interface is unspecified. By default, --ui=cli is implied when issuing the si viewprefs. To view preferences for GUI behavior, however, you should specify --ui=gui.

The preferences you see correlate to settings in the IntegrityClient.rc file, which can be seen as having the gui.si. or cli.si. prefix, or simply the si. prefix when it is unspecified.