Project

GPOZaurr

GPOZaurr helps inspect, report on, and remediate Group Policy environments with PowerShell.

View on GitHub Releases Get package

Stars 1,166

Forks 115

Open issues 16

PowerShell Gallery downloads 417,764

Release v1.1.9

Language: PowerShell Updated: 2026-04-11

API Reference

Function

Remove-GPOZaurrLinkEmptyOU

Namespace GPOZaurr

Removes Group Policy Object (GPO) links from empty Organizational Units (OUs) in a specified forest.

Remarks

This function removes GPO links from OUs that are empty and meet specified criteria. It processes OUs within the specified forest based on inclusion and exclusion rules.

Examples

Authored help example

EXAMPLE 1

PS >


Remove-GPOZaurrLinkEmptyOU -Forest "ContosoForest" -IncludeDomains @("domain1", "domain2") -ExcludeDomains @("domain3") -ExtendedForestInformation $info -ExcludeOrganizationalUnit @("OU=TestOU,DC=contoso,DC=com") -LimitProcessing 100
Removes GPO links from empty OUs in the "ContosoForest" forest, including domains "domain1" and "domain2" but excluding "domain3". Additional forest information is provided, and processing is limited to 100 OUs.

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-GPOZaurrLinkEmptyOU [-ExcludeDomains <String[]>] [-ExcludeOrganizationalUnit <String[]>] [-ExtendedForestInformation <IDictionary>] [-Forest <String>] [-IncludeDomains <String[]>] [-LimitProcessing <Int32>] [<CommonParameters>]

Parameter set: All Parameter Sets

Parameters

ExcludeDomains String[] optionalposition: 1pipeline: False: Specifies an array of domains to exclude from processing.
ExcludeOrganizationalUnit String[] optionalposition: 4pipeline: False: Specifies an array of OUs to exclude from processing.
ExtendedForestInformation IDictionary optionalposition: 3pipeline: False: Specifies additional information about the forest.
Forest String optionalposition: 0pipeline: Falsealiases: ForestName: Specifies the name of the forest to target for processing.
IncludeDomains String[] optionalposition: 2pipeline: Falsealiases: Domain, Domains: Specifies an array of domains to include for processing.
LimitProcessing Int32 optionalposition: 5pipeline: False: Specifies the maximum number of OUs to process.