Test-MtGsaForwardingProfileAssignmentNotNested
SYNOPSIS
Checks if groups assigned to Global Secure Access traffic forwarding profiles use direct membership (no nested groups).
SYNTAX
Test-MtGsaForwardingProfileAssignmentNotNested [-ProgressAction <ActionPreference>] [<CommonParameters>]
DESCRIPTION
Global Secure Access traffic forwarding profiles (Microsoft 365, Internet, and Private Access) can be scoped to specific users and groups. Microsoft does not support nested group membership for this assignment - a user must be a DIRECT member of the assigned group to receive the profile (and therefore the Global Secure Access client routing). A nested assignment group silently leaves part of the intended population without the profile.
Traffic forwarding profiles are represented by service principals whose display name ends with 'trafficforwardingprofile'; their user and group assignments are exposed as app role assignments.
EXAMPLES
EXAMPLE 1
Test-MtGsaForwardingProfileAssignmentNotNested
Returns $true if no group assigned to a traffic forwarding profile contains a nested group.
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
RELATED LINKS
https://maester.dev/docs/commands/Test-MtGsaForwardingProfileAssignmentNotNested