Author Posts

August 20, 2014 at 4:59 pm

I'm using the MSFT_DscLocalConfigurationManager CIM class's PerformRequiredConfigurationChecks method to force an LCM to apply configuration immediately. It takes one argument: a uint32 flag. Unfortunately, I can't seem to find any documenation on what flags values are expected. On most of the code samples I've found online, I see 1 and 3 being used, but no one seems to know what they mean.

Are values for this flag argument documented anywhere? Does anyone know what values are allowed and what each means?

August 20, 2014 at 6:17 pm

These are clearly documented at [url="http://msdn.microsoft.com/en-us/library/dn469248(v=vs.85).aspx"]http://msdn.microsoft.com/en-us/library/dn469248(v=vs.85).aspx[/url]: "Flags: Specifies the TBD." 🙂

Microsoft has been made aware of the documentation goof, and hopefully they'll clear it up soon. This did come up on the PowerShell MVP mailing list not too long ago. If I remember correctly, a value of 1 just runs the DSC configuration, and a value of 3 does that and also makes sure the scheduled tasks which normally kick off this method are set up. I believe 2 was also a valid value, related somehow to setting up scheduled tasks. (If this is truly a bitflag field, then maybe 1 = run configuration and 2 = set up scheduled tasks, with 3 being the combination those operations, but I'm not certain of that.)