Skip to main content
Version: 2.1.0

Test-MtPurviewAiInsiderRiskPolicy

SYNOPSIS​

Ensure a Microsoft Purview Insider Risk Management policy from the Risky AI usage template is configured and enabled.

SYNTAX​

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

DESCRIPTION​

Microsoft Purview Insider Risk Management ships a dedicated Risky AI usage policy template that detects risky prompts and responses inside Microsoft 365 Copilot and other AI apps captured by DSPM for AI - for example prompts attempting jailbreaks, harmful content generation, or extraction of sensitive information.

Without a Risky AI usage policy enabled, alerts on risky Copilot/AI app interactions are not generated and Insider Risk reviewers have no triage queue for AI misuse.

The test passes if at least one Insider Risk Management policy based on the Risky AI usage template is enabled.

Requires Microsoft 365 E5 or the Insider Risk Management add-on.

EXAMPLES​

EXAMPLE 1​

Test-MtPurviewAiInsiderRiskPolicy

Returns true if a Risky AI usage Insider Risk policy 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-MtPurviewAiInsiderRiskPolicy