Skip to main content
Version: 2.1.0

Test-MtAdGpoUnlinkedCount

SYNOPSIS

Counts Active Directory GPOs that are not linked to any OU, domain, or site.

SYNTAX

Test-MtAdGpoUnlinkedCount [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

This test identifies "orphaned" (unlinked) Group Policy Objects (GPOs) that exist in Active Directory but are not linked to any OU, domain, or site. Unlinked GPOs can consume administrative and processing resources while providing no effective policy.

EXAMPLES

EXAMPLE 1

Test-MtAdGpoUnlinkedCount

Returns $true if unlinked GPOs were not found, $false if orphaned/unlinked GPOs exist.

PARAMETERS

-ProgressAction

Determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider, such as the progress bars generated by Write-Progress.

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

System.Boolean

NOTES

https://maester.dev/docs/commands/Test-MtAdGpoUnlinkedCount