ConfigValue Object (SQL-DMO)

The ConfigValue object represents the attributes of a single Microsoft® SQL Server™ configuration option.

Remarks

Some SQL Server configuration options do not take effect until the SQL Server service (MSSQLServer) has been stopped and restarted. You can force the server to immediately accept changes in some options by using the ReconfigureWithOverride method. The DynamicReconfigure property indicates whether the ConfigValue object requires a restart.

The ConfigValue object contains four value properties. The MinimumValue and MaximumValue properties represent bounds for the given configuration option. The RunningValue property indicates the current setting of the option on a running SQL Server installation. Prior to changing the configuration option setting, the CurrentValue and the RunningValue properties return identical values.

Set the CurrentValue property to change the setting of the given SQL Server configuration option. Undo your changes by resetting the CurrentValue property to the value of the RunningValue property. After a change is applied, the values of these two properties are again equal.

To set a configuration option

1. Get the Configuration object from a connected SQLServer object.
2. Get the ConfigValue object of the desired configuration option from the ConfigValues collection of the Configuration object.
3. Set the CurrentValue property of the ConfigValue object to reflect the desired change.
4. Use either the ReconfigureCurrentValues or the ReconfigureWithOverride method of the Configuration object to apply the change to the SQL Server installation.
5. If the ConfigValue object requires a restart to take effect (the value of DynamicReconfigure is FALSE), use the Shutdown and Start methods of the SQLServer object to restart the server with the changed configuration options.

Properties