Skip to main content
Version: 2.3.0

Test-MtGsaM365ProfileEnabled

SYNOPSIS​

Checks if the Microsoft 365 traffic forwarding profile in Global Secure Access is enabled.

SYNTAX​

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

DESCRIPTION​

The Microsoft 365 traffic forwarding profile routes Microsoft 365 traffic (Exchange Online, SharePoint Online, Teams) through Global Secure Access. Enabling it is the lowest-risk entry point to Global Secure Access and unlocks source IP restoration, the Compliant Network signal in Conditional Access (token replay protection), Universal Tenant Restrictions, and network access traffic logging.

Learn more: https://learn.microsoft.com/entra/global-secure-access/concept-traffic-forwarding

EXAMPLES​

EXAMPLE 1​

Test-MtGsaM365ProfileEnabled

Returns $true if the Microsoft 365 traffic forwarding profile exists and is enabled.

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