ConfigurationManagerDistributionGroups.adoc

DSC Resource 'ConfigurationManagerDistributionGroups'

ConfigurationManagerDistributionGroups manages Configuration Manager distribution point groups for content distribution.

When to use 'ConfigurationManagerDistributionGroups'

Use this resource when you need to create and manage distribution point groups in your SCCM/MECM environment. Distribution point groups simplify content distribution by allowing you to target groups of distribution points rather than individual servers.

Source	https://github.com/dsccommunity/CommonTasks/tree/main/source/DSCResources/ConfigurationManagerDistributionGroups
DSC Resource	ConfigMgrCBDsc
Documentation	CMDistributionGroup

Table 1. Attributes of category 'ConfigurationManagerDistributionGroups'

Parameter	Attribute	DataType	Description	Allowed Values
SiteCode	Mandatory	String
DistributionGroups		Hashtable[]	set of distribution groups

Table 2. Attributes of category 'ConfigurationManagerDistributionGroups/DistributionGroups'

Parameter	Attribute	DataType	Description	Allowed Values
DistributionGroup	Key	String	The name of the distribution point group.
Ensure		String	Specifies whether the distribution point group should be present or absent.	Present (default) Absent
DistributionPoints		String[]	An array of distribution points to match to the distribution point group. (1:1 match)
DistributionPointsToInclude		String[]	An array of distribution points to add to the distribution point group.
DistributionPointsToExclude		String[]	An array of distribution points to remove from the distribution point group.
SecurityScopes		String[]	An array of security scopes to match to the distribution point group. (1:1 match)
SecurityScopesToInclude		String[]	An array of security scopes to add to the distribution point group.
SecurityScopesToExclude		String[]	An array of security scopes to remove from the distribution point group.

Example

ConfigurationManagerDistributionGroups:
  SiteCode: AL1
  DistributionGroups:
    - DistributionGroup: DG1
      #Collections: # 1:1 match, supported in future release of ConfigMgrCBDsc
      #  - Collection 1
      #  - Collection 2
      DistributionPointsToExclude:
        - DP2
      DistributionPointsToInclude:
        - DP1
      SecurityScopesToExclude:
        - Scope1
      SecurityScopesToInclude:
        - Scope2
    - DistributionGroup: DG2
      #CollectionsToExclude: # supported in future release of ConfigMgrCBDsc
      #  - Collection 1
      #CollectionsToInclude: # supported in future release of ConfigMgrCBDsc
      #  - Collection 2
      DistributionPoints: # 1:1 match
        - DP1
        - DP2
      SecurityScopes: # 1:1 match
        - Scope1
        - Scope2
    - DistributionGroup: DG3
      SiteCode: AL2 # Override SiteCode for individual groups
      DistributionPointsToExclude:
        - DP2
      DistributionPointsToInclude:
        - DP1
      SecurityScopesToExclude:
        - Scope1
      SecurityScopesToInclude:
        - Scope2

See also

• ConfigurationBase

• ConfigurationManagerConfiguration

• ConfigurationManagerDeployment