Skip to main content
Version: 2.0.1 (preview)

Test-MtAIAgentAuthorAuthentication

SYNOPSISโ€‹

Tests if AI agents use author (maker) authentication for their connector tools.

SYNTAXโ€‹

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

DESCRIPTIONโ€‹

Checks all Copilot Studio agents for connector tools that use author (maker) authentication instead of end-user authentication. When a connection uses author authentication, the agent accesses external services (SharePoint, SQL, etc.) using the bot maker's stored credentials rather than requiring the end user to authenticate. This creates a privilege escalation risk - the agent operates with the maker's permissions regardless of who is chatting with it.

Reference: https://www.microsoft.com/en-us/security/blog/2026/02/12/copilot-studio-agent-security-top-10-risks-detect-prevent/

EXAMPLESโ€‹

EXAMPLE 1โ€‹

Test-MtAIAgentAuthorAuthentication

PARAMETERSโ€‹

-ProgressActionโ€‹

{{ Fill ProgressAction Description }}

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โ€‹

[bool] - Returns $true if no agents use author/maker authentication,โ€‹

$false if any agent has connections using the maker's credentials,โ€‹

$null if data is unavailable.โ€‹

NOTESโ€‹

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