GitXplorerGitXplorer
m

BaselineManagement

public
268 stars
52 forks
10 issues

Commits

List of commits on branch main.
Unverified
bc23b244f7ee379427be22da2b5d575df5a9b4e6

notes in readme

mmgreenegit committed 3 years ago
Unverified
a1724f30d912d506644c51d0081c7fae44f104d4

issue in registry parser where Option data was not used

mmgreenegit committed 3 years ago
Unverified
61c36c23302db3db5b718460630f84044b0fecb9

Improve error message

mmgreenegit committed 3 years ago
Unverified
c5c039aca603ffd48fb25cf73558d15192b55fd0

readme spelling error

mmgreenegit committed 3 years ago
Unverified
6603dd70767c5a8e42319f10290b1c83d15bcb23

version

mmgreenegit committed 3 years ago
Unverified
f5a37f57375d074a3b65195f334867589061609c

readme

mmgreenegit committed 3 years ago

README

The README file for this repository.

BaselineManagement

Master: Build Status

NOTE: Beginning with version 3.0.0, this module now only supports conversion from Group Policy format. If conversion from ASC or SCM formats is needed, please install version 2.x from the PowerShell Gallery.

This solution is built off GPRegistryParser.

This solution contains cmdlets for converting baselines into Desired State Configuration.

  • ConvertFrom-GPO - Converts from GPO Backups into DSC Configuration and accompanying MOF.
  • Merge-GPOs - Discovers the result of all policies for a machine by querying WMI from inside the machine. and creates a single DSC script based on the order policies are applied, link, enforcement, and filtering.
  • Merge-GPOsFromOU - Discovers the result of all policies assigned at the scope of an OU, and creates a single DSC script based on the order policies are applied, link, and enforcement.

All of the Cmdlets accept pipeline input and have accompanying help text and examples.

Known gaps in capability

  • Security settings that are producing errors

    • Network_security_Configure_encryption_types_allowed_for_Kerberos: if multiple values are selected, the value will not resolve to a name and will produce an error. This will have to be resolved in SecurityPolicyDSC.
      Issue tracked in SecurityPolicyDsc
    • Network_access_Restrict_clients_allowed_to_make_remote_calls_to_SAM: the format of the value for this setting is causing the MOF to not compile correctly. The only workaround for now is to not include the setting or manually set it in the MOF (if the correct value is known).
    • Minimum_password_length_audit: this is a new setting that hasn't been mapped yet in SecurityPolicyDsc.
      Issue tracked in SecurityPolicyDsc
  • Not all Group Policy settings have DSC resources, or parsers

    • Some are tracked in the Issues list but it is likely there are many edge cases not yet covered.

Description

The included cmdlets convert baselines into a Desired State Configuration .mof file and, optionally, a .ps1 file. If there are any errors compiling or creating the configuration, the tool will output a ps1.error file with the configuration text.

The accompanying resources stored in the DSC resources folder are needed to apply the settings. Most can be found on github, but are stored here for convenience.

[!NOTE] If the resources are not copied into a PSModulePath the Configuration will likely not compile. This is simply because DSC requires that all modules in a Configuration be present in PSModulePath when compiled.

The tool also has a conflict resolution engine that will automatically comment out conflicting resources.

Example of Conflict Resolution

    Service Spooler
    {
        Name = "Spooler"
        State = "Stopped"
    }

    Service Spooler2
    {
        Name = "Spooler"
        State = "Running"
    }

The tool has been thoroughly tested, but needs to be run against a variety of baselines to ensure they are parsed correctly.

If you have any issues, please submit them and I will get to them as I am able :-)

Install the Module

BaselineManagement is also available on the PowerShell gallery, where dependent modules are automatically installed:

  • GPRegistryPolicyParser
  • SecurityPolicyDSC
  • AuditPolicyDSC
  • GPRegistryPolicyDSC

To install the latest stable version, use the following command.

Install-Module BaselineManagement