Remove-GPOZaurr

Namespace GPOZaurr

Removes Group Policy Objects based on specified criteria.

Remarks

The Remove-GPOZaurr function removes Group Policy Objects (GPOs) based on the specified criteria. It allows for filtering by various parameters such as GPO type, forest, domains, and more.

Examples

Authored help example

EXAMPLE 1

PS >


Remove-GPOZaurr -Type 'Empty' -Forest 'Contoso' -IncludeDomains 'Domain1', 'Domain2' -BackupPath 'C:\GPOBackups' -BackupDated -RequireDays 7
Removes all empty GPOs from the 'Contoso' forest for 'Domain1' and 'Domain2', backs them up to 'C:\GPOBackups' with dated folders, and requires removal after 7 days.

EXAMPLE 2

PS >


Remove-GPOZaurr -Type 'Disabled' -Forest 'Fabrikam' -ExcludeDomains 'Domain3' -LimitProcessing 10
Removes all disabled GPOs from the 'Fabrikam' forest excluding 'Domain3' and processes only the first 10 GPOs.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.

Syntax

Remove-GPOZaurr [-BackupDated] [-BackupPath <String>] [-ExcludeDomains <String[]>] [-ExcludeGroupPolicies <ScriptBlock>] [-ExtendedForestInformation <IDictionary>] [-Forest <String>] [-GPOPath <String[]>] [-IncludeDomains <String[]>] [-LimitProcessing <Int32>] [-RequireDays <Int32>] -Type <Empty|Unlinked|Disabled|NoApplyPermission> [<CommonParameters>]

Parameter set: All Parameter Sets

Parameters

BackupDated SwitchParameter optionalposition: namedpipeline: False: Indicates whether the backup should be dated.
BackupPath String optionalposition: namedpipeline: False: Specifies the path for backing up GPOs before removal.
ExcludeDomains String[] optionalposition: namedpipeline: False: Specifies the domains to exclude from GPO removal.
ExcludeGroupPolicies ScriptBlock optionalposition: 1pipeline: False: Specifies the Group Policies to exclude from removal.
ExtendedForestInformation IDictionary optionalposition: namedpipeline: False: Specifies additional information about the forest.
Forest String optionalposition: namedpipeline: Falsealiases: ForestName: Specifies the forest to target for GPO removal.
GPOPath String[] optionalposition: namedpipeline: False: Specifies the path to the GPOs to be removed.
IncludeDomains String[] optionalposition: namedpipeline: Falsealiases: Domain, Domains: Specifies the domains to include for GPO removal.
LimitProcessing Int32 optionalposition: namedpipeline: False: Specifies the maximum number of GPOs to process before stopping.
RequireDays Int32 optionalposition: namedpipeline: False: Specifies the number of days before GPO removal is required.
Type String[] requiredposition: 0pipeline: Falsevalues: 4: Specifies the type of GPOs to target for removal. Valid values are 'Empty', 'Unlinked', 'Disabled', 'NoApplyPermission'.; Possible values: Empty, Unlinked, Disabled, NoApplyPermission