Values for PerformRequiredConfigurationChecks Flags

Tagged: 

This topic contains 2 replies, has 3 voices, and was last updated by Profile photo of Tito Aldarondo Tito Aldarondo 9 months, 2 weeks ago.

  • Author
    Posts
  • #18204
    Profile photo of Aaron Jensen
    Aaron Jensen
    Participant

    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?

  • #18205
    Profile photo of Dave Wyatt
    Dave Wyatt
    Moderator

    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.)

  • #35799
    Profile photo of Tito Aldarondo
    Tito Aldarondo
    Participant

    Looks like this documentation bug has yet to be addressed: https://connect.microsoft.com/PowerShell/feedbackdetail/view/951297/dsc-msft-dsclocalconfigurationmanager-cim-classs-performrequiredconfigurationchecks-methods-flags-parameter-is-undocumented

    Thanks, Dave. A year and a half later and yours is the best guess I've seen yet.

You must be logged in to reply to this topic.