setting
This command sets a BigFix client setting.
Settings are named values that can be applied to individual sites or to client computers. Each setting has a timestamp associated with it. This timestamp is used to establish priority, the latest setting will trump any earlier ones.
Version | Platforms |
---|---|
8.0.584.0 | AIX, HP-UX, Mac, Red Hat, SUSE, Solaris, Windows |
8.1.535.0 | Debian, Ubuntu |
Syntax
setting "<name>"="value" on "<date>" for client
setting "<name>"="value" on "<date>" for current site
setting "<name>"="value" on "<date>" for site "<sitename>"
Where name=value
describes the setting, and date
is a timestamp used to
establish priority between conflicting setting
commands.
The recommended date
to use in most cases is {parameter "action issue date"
of action}
which is interpreted as the date (and time) that the action is
issued at.
It is also possible to use {now}
as the date
, knowing that this may cause
the action to override setting values that were applied after the action was
issued (i.e. newer than the action). In fact, when the action runs, the
now inspector returns the current
time (i.e. at moment of the execution), and not the time that the action was
first issued at.
There can be a different <name>
setting on each site.
Examples
Sets the setting name
to Bob
with an effective date of 31 Jan 2007
21:09:36 gmt
. It will supersede any other name
setting with an earlier date.
setting "name"="Bob" on "31 Jan 2007 21:09:36 gmt" for client
This sets the foo
setting to bar
. It will not overwrite that setting if
another action changed it after this action was issued.
setting "foo"="bar" on "{parameter "action issue date" of action}" for client
This sets the division
setting to "design group"
(quotes included) for the
current site. Note that the quotes are percent encoded.
setting "division"="%22design group%22" on "{parameter "action issue date" of action}" for current site
Set the preference
setting to red
for the site named color
. This example
uses {now}
as the date
to override the setting value regardless of when it
was last set.
setting "preference"="red" on "{now}" for site "color"
Notes
When a client is reset, the effective dates of the settings are removed and any subsequent setting commands will overwrite them. There are several ways that clients can be reset, including computer-ID collisions (most often caused by accidentally including the computer ID in an image that gets copied to multiple systems), changing the masthead to a new server, or instructing the client to collect a new ID.
The actions that run next will establish a new effective date, but the setting values will be the same as before the reset. The values are retained because they contain information such as relay selections. That way, when a deployment reset occurs, you don’t have to issue new actions to reset your network relay structure.
To make sure your actions do not interfere with each other, write your own checks using the relevance language. You cannot rely on the settings date alone. To ensure an action only runs once, use a task instead of a fixlet. If you want to run multiple actions in a given order, create a baseline.