en-US

ReportSubmissionPolicy

Applies to : Exchange Online

This cmdlet is available only in the cloud-based service.

Use the Set-ReportSubmissionPolicy cmdlet to modify the report submission policy in your cloud-based organization.

For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.

The report submission policy controls most of the settings for user submissions in the Microsoft Defender portal:

When you set the email address of the reporting mailbox in the Microsoft Defender portal, the same email address is also set in the following parameters in the \*-ReportSubmissionPolicy cmdlets:

  • Microsoft integrated reporting using Microsoft reporting tools in Outlook: The ReportJunkAddresses, ReportNotJunkAddresses, and ReportPhishAddresses parameters.
  • Microsoft integrated reporting using non-Microsoft tools in Outlook: The ThirdPartyReportAddresses parameter.
  • User reporting in Teams: The ReportChatMessageAddresses parameter.

For reporting in Outlook, although it's not absolutely required, it makes sense to keep the email address consistent in the related parameters in the \*-ReportSubmissionPolicy and \*-ReportSubmissionRule cmdlets. User reporting in Teams doesn't use the report submission rule.

You need to be assigned permissions before you can run this cmdlet. Although this article lists all parameters for the cmdlet, you might not have access to some parameters if they aren't included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see Find the permissions required to run any Exchange cmdlet.

Available cmdlets

Parameters

Name Type Default value Accepted values
DisableQuarantineReportingOption Boolean
DisableUserSubmissionOptions Boolean
EnableCustomizedMsg Boolean
EnableCustomNotificationSender Boolean
EnableOrganizationBranding Boolean
EnableReportToMicrosoft Boolean
EnableThirdPartyAddress Boolean
EnableUserEmailNotification Boolean
JunkReviewResultMessage String
MultiLanguagePostSubmitMessageButtonLinkForJunk MultiValuedProperty
MultiLanguagePostSubmitMessageButtonLinkForPhishing MultiValuedProperty
MultiLanguagePostSubmitMessageButtonTextForJunk MultiValuedProperty
MultiLanguagePostSubmitMessageButtonTextForPhishing MultiValuedProperty
MultiLanguagePostSubmitMessageForJunk MultiValuedProperty
MultiLanguagePostSubmitMessageForPhishing MultiValuedProperty
MultiLanguagePostSubmitMessageTitleForJunk MultiValuedProperty
MultiLanguagePostSubmitMessageTitleForPhishing MultiValuedProperty
MultiLanguagePreSubmitMessageButtonLinkForJunk MultiValuedProperty
MultiLanguagePreSubmitMessageButtonLinkForNotJunk MultiValuedProperty
MultiLanguagePreSubmitMessageButtonLinkForPhishing MultiValuedProperty
MultiLanguagePreSubmitMessageButtonTextForJunk MultiValuedProperty
MultiLanguagePreSubmitMessageButtonTextForNotJunk MultiValuedProperty
MultiLanguagePreSubmitMessageButtonTextForPhishing MultiValuedProperty
MultiLanguagePreSubmitMessageForJunk MultiValuedProperty
MultiLanguagePreSubmitMessageForNotJunk MultiValuedProperty
MultiLanguagePreSubmitMessageForPhishing MultiValuedProperty
MultiLanguagePreSubmitMessageTitleForJunk MultiValuedProperty
MultiLanguagePreSubmitMessageTitleForNotJunk MultiValuedProperty
MultiLanguagePreSubmitMessageTitleForPhishing MultiValuedProperty
MultiLanguageSetting MultiValuedProperty
NotJunkReviewResultMessage String
NotificationFooterMessage String
NotificationSenderAddress MultiValuedProperty
NotificationsForCleanSubmissionAirInvestigationsEnabled Boolean
NotificationsForPhishMalwareSubmissionAirInvestigationsEnabled Boolean
NotificationsForSpamSubmissionAirInvestigationsEnabled Boolean
NotificationsForSubmissionAirInvestigationsEnabled Boolean
OnlyShowPhishingDisclaimer Boolean
PhishingReviewResultMessage String
PostSubmitMessage String
PostSubmitMessageEnabled Boolean
PostSubmitMessageForJunk String
PostSubmitMessageForNotJunk String
PostSubmitMessageForPhishing String
PostSubmitMessageTitle String
PostSubmitMessageTitleForJunk String
PostSubmitMessageTitleForNotJunk String
PostSubmitMessageTitleForPhishing String
PreSubmitMessage String
PreSubmitMessageEnabled Boolean
PreSubmitMessageForJunk String
PreSubmitMessageForNotJunk String
PreSubmitMessageForPhishing String
PreSubmitMessageTitle String
PreSubmitMessageTitleForJunk String
PreSubmitMessageTitleForNotJunk String
PreSubmitMessageTitleForPhishing String
ReportChatMessageAddresses MultiValuedProperty
ReportChatMessageEnabled Boolean
ReportChatMessageToCustomizedAddressEnabled Boolean
ReportJunkAddresses MultiValuedProperty
ReportJunkToCustomizedAddress Boolean
ReportNotJunkAddresses MultiValuedProperty
ReportNotJunkToCustomizedAddress Boolean
ReportPhishAddresses MultiValuedProperty
ReportPhishToCustomizedAddress Boolean
ThirdPartyReportAddresses MultiValuedProperty
UserSubmissionOptions Int32
UserSubmissionOptionsMessage String

Examples

Example 1

Set-ReportSubmissionPolicy -Identity DefaultReportSubmissionPolicy -EnableReportToMicrosoft $true -EnableThirdPartyAddress $false -ThirdPartyReportAddresses $null -ReportJunkToCustomizedAddress $false -ReportJunkAddresses $null -ReportNotJunkToCustomizedAddress $false -ReportNotJunkAddresses $null -ReportPhishToCustomizedAddress $false -ReportPhishAddresses $null

Get-ReportSubmissionRule | Remove-ReportSubmissionRule

This example turns on reporting in Outlook, uses Microsoft reporting tools in Outlook, but allows users to report messages to Microsoft only. The reporting mailbox is not used.

Notes:

  • You can use this example (and the other examples) without concern for the existing values of the specified parameters. Depending on your current configuration, some of the parameters might already be set to the required values and therefore might not be required.
  • If the report submission rule doesn't already exist (the Get-ReportSubmissionRule command returns no output), you don't need to run the second command to remove it.

Example 2

$usersub = "[email protected]"

Set-ReportSubmissionPolicy -Identity DefaultReportSubmissionPolicy -EnableReportToMicrosoft $true -EnableThirdPartyAddress $false -ThirdPartyReportAddresses $null -ReportJunkToCustomizedAddress $true -ReportJunkAddresses $usersub -ReportNotJunkToCustomizedAddress $true -ReportNotJunkAddresses $usersub -ReportPhishToCustomizedAddress $true -ReportPhishAddresses $usersub

New-ReportSubmissionRule -Name DefaultReportSubmissionRule -ReportSubmissionPolicy DefaultReportSubmissionPolicy -SentTo $usersub

This example turns on reporting in Outlook, uses Microsoft reporting tools in Outlook, allows users to report messages to Microsoft, and sends reported messages to the specified reporting mailbox.

The required third command is different based on whether you already have a report submission rule:

  • If you don't already have a report submission rule (the Get-ReportSubmissionRule cmdlet returns nothing), run the New-ReportSubmissionRule command as described.
  • If you already have a report submission rule (the Get-ReportSubmissionRule cmdlet returns output), run the following command instead: Set-ReportSubmissionRule -Name DefaultReportSubmissionRule -SentTo $usersub.

Example 3

$usersub = "[email protected]"

Set-ReportSubmissionPolicy -Identity DefaultReportSubmissionPolicy -EnableReportToMicrosoft $false -EnableThirdPartyAddress $false -ThirdPartyReportAddresses $null -ReportJunkToCustomizedAddress $true -ReportJunkAddresses $usersub -ReportNotJunkToCustomizedAddress $true -ReportNotJunkAddresses $usersub -ReportPhishToCustomizedAddress $true -ReportPhishAddresses $usersub

New-ReportSubmissionRule -Name DefaultReportSubmissionRule -ReportSubmissionPolicy DefaultReportSubmissionPolicy -SentTo $usersub

This example turns on reporting in Outlook, uses Microsoft reporting tools in Outlook, and sends reported messages to the specified reporting mailbox only (users can't report messages to Microsoft).

The required third command is different based on whether you already have a report submission rule:

  • If you don't already have a report submission rule (the Get-ReportSubmissionRule cmdlet returns nothing), run the New-ReportSubmissionRule command as described.
  • If you already have a report submission rule (the Get-ReportSubmissionRule cmdlet returns output), run the following command instead: Set-ReportSubmissionRule -Name DefaultReportSubmissionRule -SentTo $usersub.

Example 4

$usersub = "[email protected]"

Set-ReportSubmissionPolicy -Identity DefaultReportSubmissionPolicy -EnableReportToMicrosoft $false -EnableThirdPartyAddress $true -ThirdPartyReportAddresses $usersub -ReportJunkToCustomizedAddress $false -ReportJunkAddresses $null -ReportNotJunkToCustomizedAddress $false -ReportNotJunkAddresses $null -ReportPhishToCustomizedAddress $false -ReportPhishAddresses $null

New-ReportSubmissionRule -Name DefaultReportSubmissionRule -ReportSubmissionPolicy DefaultReportSubmissionPolicy -SentTo $usersub

This example turns on reporting in Outlook, but uses non-Microsoft reporting tools in Outlook to send reported messages to the specified reporting mailbox in Exchange Online.

The required third command is different based on whether you already have a report submission rule:

  • If you don't already have a report submission rule (the Get-ReportSubmissionRule cmdlet returns nothing), run the New-ReportSubmissionRule command as described.
  • If you already have a report submission rule (the Get-ReportSubmissionRule cmdlet returns output), run the following command instead: Set-ReportSubmissionRule -Name DefaultReportSubmissionRule -SentTo $usersub.

Example 5

Set-ReportSubmissionPolicy -Identity DefaultReportSubmissionPolicy -EnableReportToMicrosoft $false -EnableThirdPartyAddress $true -ThirdPartyReportAddresses $usersub -ReportJunkToCustomizedAddress $false -ReportJunkAddresses $null -ReportNotJunkToCustomizedAddress $false -ReportNotJunkAddresses $null -ReportPhishToCustomizedAddress $false -ReportPhishAddresses $null

Get-ReportSubmissionRule | Remove-ReportSubmissionRule

This example turns off the Microsoft integrated reporting. Microsoft reporting tools in Outlook are not available to users and messages reported by non-Microsoft tools in Outlook are not available on the Submissions page in the Microsoft Defender portal.

If the report submission rule doesn't already exist (the Get-ReportSubmissionRule command returns no output), you don't need to run the second command to remove it.

Example 6

$teamsReports = "[email protected]"

Set-ReportSubmissionPolicy -Identity DefaultReportSubmissionPolicy -ReportChatMessageEnabled $true -ReportChatMessageToCustomizedAddressEnabled $true -ReportChatMessageAddresses $teamsReports

This example sends user reported Teams messages and calls to Microsoft and to the specified reporting mailbox in Exchange Online.

Microsoft Learn documentation