Modifying Additional Settings
Use the following steps to modify (add, edit, or delete) the additional settings for one or more clients.
Important
Both the names and the categories (also called types) of additional settings are case sensitive. When you add or modify the name or the category of an additional setting, match the capitalization that is in the additional settings database.
-
Download the additional_settings.xml file and save it on the computer that you will execute the command from.
-
Open the additional_settings.xml file and provide the values for the XML parameters, as described in the "XML Parameters" table.
-
Execute the following command:
qoperation execute -af additional_settings.xml
Results
-
The additional setting is added if it does not exist and the registryKeys/deleted parameter is set to 0.
-
The additional setting is updated if it does exist and the registryKeys/deleted parameter is set to 0.
Verifying the Changes
Use the following steps to verify the changes that you performed on the clients:
-
From the CommCell Browser, right-click the client, and then click Properties.
-
Click Advanced.
-
Click the Additional Settings tab.
The changes are displayed.
XML Parameters
The following table shows the XML parameters that you provide before running the qoperation command.
Important
Both the names and the categories (also called types) of additional settings are case sensitive. When you add or modify the name or the category of an additional setting, match the capitalization that is in the additional settings database.
|
Parameter |
Description |
|---|---|
|
clientName |
The name of the client computers for which you want to add, modify or delete an additional setting. |
|
keyName |
The name of the additional setting. |
|
type |
The type of the additional setting. Valid values are:
|
|
value |
The value of the additional setting. Depending on type, the value could be numerical, a numeric range, or a character string. |
|
relativepath |
The relative location of the additional setting in the instance, sometimes called the Category. For example, the additional setting LdapBindOnce has a relative path of CommServe. |
|
registryKeys/deleted |
Option to remove the additional setting. Valid values are:
|
|
registryKeys/enabled |
Option to enable the additional setting. Valid values are:
|