Skip to main content
Version: 2.3.1-preview

Test-MtAdCrossForestReferencesCount

SYNOPSIS​

Retrieves the count of cross-forest references configured in the forest.

SYNTAX​

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

DESCRIPTION​

This test retrieves the count of cross-forest references in the Active Directory forest. Cross-forest references are objects that represent security principals from trusted external forests. These references enable authentication and authorization across forest boundaries. Understanding cross-forest references is important for assessing the security posture of multi-forest environments and identifying potential trust relationships.

EXAMPLES​

EXAMPLE 1​

Test-MtAdCrossForestReferencesCount

Returns $true if cross-forest reference data is accessible. The test result includes the count of configured cross-forest references.

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