Set-FMContentMode

SYNOPSIS

Configures the way the module handles forest level objects not defined in configuration.

SYNTAX

Set-FMContentMode [[-Mode] <String>] [[-Include] <String[]>] [[-Exclude] <String[]>]
 [[-UserExcludePattern] <String[]>] [[-RemoveUnknownWmiFilter] <Boolean>] [[-ExcludeComponents] <Hashtable>]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Configures the way the module handles forest level objects not defined in configuration. Depending on the desired forest configuration, dealing with undesired objects may be desirable.

This module handles the following configurations: Mode Additive: In this mode, all configured content is considered in addition to what is already there. Objects not in scope of the configuration are ignored. Mode Constrained: In this mode, objects not configured are handled based on path rules:

• Include: If Include Paths are configured, only objects in the specified OUs are under management. Only objects in these OUs will be considered for deletion if not configured.
• Exclude: If Exclude Paths are configured, objects in the excluded OUs are ignored, all objects outside of these OUs will be considered for deletion if not configured. If both Include and Exclude OUs are configured, they are merged without applying the implied top-level Include of an Exclude-only configuration. In this scenario, if a top-level Include is desired, it needs to be explicitly set.

When specifying Include and Exclude DNs, specify the full DN, inserting ‘%ConfigurationDN%’ (without the quotes) for the configuration NC root and ‘%SchemaDN%’ for the schema NC.

EXAMPLES

EXAMPLE 1

Set-DMContentMode -Mode 'Constrained' -Include 'OU=Administration,%DomainDN%'

Enables Constrained mode and configures the top-level OU “Administration” as an OU under management.

PARAMETERS

-Mode

The mode to operate under. In Additive mode, objects not configured are being ignored. In Constrained mode, objects not configured may still be under maanagement, depending on Include and Exclude rules.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Include

Paths in which to look for objects under management. Use this to explicitly list which Pathss should be inspected for objects to manage. Only applied in Constrained mode. Specify the full DN, inserting ‘%ConfigurationDN%’ (without the quotes) for the configuration NC root and ‘%SchemaDN%’ for the schema NC.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Exclude

Paths in which to NOT look for objects under management. All other Paths are subject to management and having undesired objects deleted. Only applied in Constrained mode. Specify the full DN, inserting ‘%ConfigurationDN%’ (without the quotes) for the configuration NC root and ‘%SchemaDN%’ for the schema NC.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UserExcludePattern

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RemoveUnknownWmiFilter

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ExcludeComponents

Components to exclude from the Forest Content Mode. By including them here, non-configured objects of that type will no longer get deleted. (Details may vary, depending on the specific Component. See their respective documentation.)

Each entry should use the Component name as Key and a boolean as Value in the hashtable. If the value is considered $true, the Component is excluded. Settings from multiple configuration sets will be merged, rather than fully replacing the old hashtable with a new one.

Supported Components:

• AccessRules: Excluding them will test only configured paths for access control entries (ACE).

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 6
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

RELATED LINKS