Test-MtAIAgentDormant

SYNOPSIS

Tests if AI agents are dormant.

SYNTAX

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

DESCRIPTION

Checks all published Copilot Studio agents for those that have not been modified or republished within 180 days. Dormant agents may have outdated configurations, unpatched vulnerabilities, or stale permissions that present unnecessary risk.

EXAMPLES

EXAMPLE 1

Test-MtAIAgentDormant

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 no dormant agents are found, $false if any

published agent exceeds the inactivity threshold, $null if data is unavailable.

NOTES

RELATED LINKS

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