Merge pull request #49 from dsccommunity/AdministrativeUsers

CM Administrative users

CHANGELOG.md

@@ -40,6 +40,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added CMPullDistributionPoint Resource
 - Added ConvertTo-AnyCimInstance to the ResourceHelper
 - Added CMSiteMaintenance Resource
+- Added CMAdministrativeUser Resource
+- Added Compare-MultipleCompares to the ResourceHelper
 
 ### Changed
 

README.md

@@ -91,6 +91,8 @@ Please check out common DSC Community [contributing guidelines](https://dsccommu
 - **CMPullDistributionPoint**: Provides a resource for modifying a distribution point
   and making the distribution point a Pull Distribution Point.
 - **CMSiteMaintenance**: Provides a resource for modifying the Site Maintenance tasks.
+- **CMAdministrativeUser**:  Provides a resource for adding, removing, and configuring
+  administrative users.
 
 ### xSccmPreReqs
 
@@ -858,3 +860,35 @@ Please check out common DSC Community [contributing guidelines](https://dsccommu
 - [CMSiteMaintenance_MaintenanceTask_Enabled](Source\Examples\Resources\CMSiteMaintenance\CMSiteMaintenance_MaintenanceTask_Enabled.ps1)
 - [CMSiteMaintenance_SummaryTask_Enabled](Source\Examples\Resources\CMSiteMaintenance\CMSiteMaintenance_SummaryTask_Enabled.ps1)
 - [CMSiteMaintenance_UpdateAppCatTablesTask_Enabled](Source\Examples\Resources\CMSiteMaintenance\CMSiteMaintenance_UpdateAppCatTablesTask_Enabled.ps1)
+
+### CMAdministrativeUser
+
+- **[String] AdminName** _(Key)_: Specifies the name of the administrator account.
+- **[String] SiteCode** _(Required)_: Specifies the Site Code for the Configuration
+  Manager site.
+- **[String] Roles[]** _(Write)_: Specifies an array of names for the roles
+  desired to be assigned to an administrative user.
+- **[String] RolesToInclude[]** _(Write)_: Specifies an array of names for the
+  roles desired to be added to an administrative user.
+- **[String] RolesToExclude[]** _(Write)_: Specifies an array of names for the
+  roles desired to be removed from an administrative user.
+- **[String] Scopes[]** _(Write)_: Specifies an array of names for the scopes
+  desired to be assigned to an administrative user.
+- **[String] ScopesToInclude[]** _(Write)_: Specifies an array of names for the
+  scopes desired to be added to an administrative user.
+- **[String] ScopesToExclude[]** _(Write)_: Specifies an array of names for the
+  scopes desired to be removed from an administrative user.
+- **[String] Collections[]** _(Write)_: Specifies an array of names for the
+  collections desired to be assigned to an administrative user.
+- **[String] CollectionsToInclude[]** _(Write)_: Specifies an array of names for
+  the collections desired to be added to an administrative user.
+- **[String] CollectionsToExclude[]** _(Write)_: Specifies an array of names for
+  the collections desired to be removed from an administrative user.
+- **[String] Ensure** _(Write)_: Specifies whether the administrative user
+  is present or absent.
+  - Values include: { Present | Absent }
+
+#### CMAdministrativeUser Examples
+
+- [CMAdministrativeUser_Absent](Source\Examples\Resources\CMAdministrativeUser\CMAdministrativeUser_Absent.ps1)
+- [CMAdministrativeUser_Present](Source\Examples\Resources\CMAdministrativeUser\CMAdministrativeUser_Present.ps1)

source/ConfigMgrCBDsc.psd1

@@ -66,6 +66,7 @@
         'CMPxeDistributionPoint'
         'CMPullDistributionPoint'
         'CMSiteMaintenance'
+        'CMAdministrativeUser'
     )
 
     <#
@@ -82,7 +83,7 @@
             'SccmSqlSetup','SCCMInstall','CMIniFile','Collections','Boundaries','ForestDiscovery','ClientStatusSettings','BoundaryGroups',
             'ManagementPoint','AssetIntelligencePoint','FallbackStatusPoint','SoftwareUpdatePoint','DistrubtionPoint','HeartbeatDiscovery',
             'ServiceConnectionPoint','NetworkDiscovery','ReportingServicePoint','SystemDiscovery','PXEDistributionPoint','PullDistributionPoint',
-            'SiteMaintenance')
+            'SiteMaintenance','AdministrativeUser')
 
             # A URL to the license for this module.
             LicenseUri   = 'https://github.com/dsccommunity/ConfigMgrCBDsc/blob/master/LICENSE'