Skip to main content
Version: 2.0.0

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​

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

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

NOTES​

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