CLI Reference > Configuration Management Commands > si setprefs
si setprefs
sets preferences
si setprefs [--command=value] [--[no]resetToDefault] [--[no]save] [--[no]ask] [--ui=[unspecified|gui|cli|api]] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] pref[=value]...
si setprefs sets preferences and configuration options. These settings are used to determine default behaviors for other commands - each option on each command has a preference key associated with it. The si viewprefs command lists the commands and preference keys. Changes to your preferences are either for the current client session (until si exit is used) or may be permanently saved in your system's home directory, into a file named Integrity, using the --save option.
To permanently enable keyword expansion when resynchronizing members, for example, you would specify:
si setprefs --command=resync --save keywordExpand=expand
Your administrator can also lock certain preferences from the Windchill RV&S Server, preventing you from configuring them using the si setprefs command. Preferences that are locked -- viewable with si viewprefs -- display (locked) at the end of the output line. The following preferences can be locked from the server by editing Windchill RV&S policies in the Administration Client:
Tip: For information on editing Windchill RV&S policies, see the Windchill RV&S Help Center.
Affected Commands
Do not edit the IntegrityClient.rc file manually, because preferences that appear more than once in the IntegrityClient.rc file can cause Windchill RV&S 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.
identifies the command to be set. 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:
si viewprefs --global --showValidValues >prefs.txt
The commands and preference keys are also listed on the preferences reference page.
controls whether to revert specified settings to the default values as shipped with the Windchill RV&S Client. If specifying --resetToDefault, you must not specify =value for each preference.
controls whether changes should be permanently saved.
controls prompts to the user for specific preferences. Each preference option may be set to either --ask or --noask. When the command itself is run, any option set to --ask and that is not explicitly set with command line options will be queried. If this --ask option is set, then you do not specify a value for the preference at the same time, but instead the pref=value must supply one of the following four valid ask values:
asks the user the first time only, and then uses the provided value every time after for the duration of that command.
never asks the user for a response, but uses the current setting (which may be specified by a preference).
asks the user for each element of the selection, providing the most recently used value as the default.
asks the user for each element of the selection, resetting the default to the value specified by the preference.
For example, to set the server host for si connect to a specific host name, you specify something like:
si setprefs --command=connect
but to set the preference to ask for a host name when using si connect, you specify something like:
si setprefs --command=connect
--ask server.hostname=element-last
controls whether to apply the preference to the graphical user interface, the command line interface, or when the interface is unspecified. By default, --ui=cli is implied when issuing the si setprefs. To set preferences for GUI behavior, however, you should specify --ui=gui. For example, to set the manage preference to be true in the GUI for the si sandboxes command, you would type:
si setprefs --command=sandboxes --ui=gui manage=true
These correlate to settings in the IntegrityClient.rc file, which can be seen as having the or prefix, or simply the si. prefix when it is unspecified.
identifies the preference string. If you specified the --resetToDefault option, then you only need to specify the preference name; otherwise specify a value for the preference. Use spaces to specify multiple preferences.
See the diagnostics reference page for possible exit status values.
Using si setprefs or si viewprefs, you are able to set or view the preference keys for this command.
See Also
Commands: si loadrc, si viewprefs
Miscellaneous: diagnostics, options, preferences