Test-MtAIAgentOrphaned

SYNOPSIS

Tests if AI agents are orphaned.

SYNTAX

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

DESCRIPTION

Checks all Copilot Studio agents for those whose owner accounts no longer exist or are disabled in Entra ID. Orphaned agents lack active governance and may drift from security policies without anyone responsible for maintaining them.

EXAMPLES

EXAMPLE 1

Test-MtAIAgentOrphaned

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

[bool] - Returns $true if all agents have active owners, $false if any

agent has disabled or missing owners, $null if data is unavailable.

NOTES

RELATED LINKS

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