ConfigurationSetting interface
Configuration setting of LCM (Local Configuration Manager).
Properties
| action |
Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration |
| allow |
If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false |
| configuration |
Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. |
| configuration |
How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. |
| reboot |
Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. |
| refresh |
The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. |
Property Details
actionAfterReboot
Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration
actionAfterReboot?: string
Property Value
string
allowModuleOverwrite
If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false
allowModuleOverwrite?: boolean
Property Value
boolean
configurationMode
Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect.
configurationMode?: string
Property Value
string
configurationModeFrequencyMins
How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15.
configurationModeFrequencyMins?: number
Property Value
number
rebootIfNeeded
Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module.
rebootIfNeeded?: boolean
Property Value
boolean
refreshFrequencyMins
The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30.
refreshFrequencyMins?: number
Property Value
number