Skip to main content
Version: 2.1.1-preview

Test-MtAdGpoLinkedCount

SYNOPSIS

Counts distinct GPOs that have at least one enabled link (active GPOs).

SYNTAX

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

DESCRIPTION

This test retrieves Active Directory GPO state information using Get-MtADGpoState, then counts distinct Group Policy Objects (GPOs) that have at least one enabled link.

Understanding the scope of actively linked (and therefore applying) policies is important for security assessments. Comparing total GPOs vs linked GPOs helps identify the ratio of active vs unused policies.

EXAMPLES

EXAMPLE 1

Test-MtAdGpoLinkedCount

Returns $true if GPO data is accessible, $false otherwise.

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-MtAdGpoLinkedCount