Commands › Exchange Online

New-ReportSubmissionPolicy

Exchange Online ExchangeOnlineManagement New-*

Create the report submission policy in your cloud-based organization. The report submission policy controls most of the user reported message settings in the organization. **Note**: If the policy already exists (the Get-ReportSubmissionPolicy cmdlet returns output), you can't use this cmdlet. To delete the existing policy and start over with the default settings, use the Remove-ReportSubmissionPolicy cmdlet first.

Quick start script

# New-ReportSubmissionPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-ReportSubmissionPolicy
$before | Format-List

# 3. Make the change
New-ReportSubmissionPolicy

# 4. Verify and diff
$after = Get-ReportSubmissionPolicy
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

New-ReportSubmissionPolicy
 [-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>]
 [-NotificationFooterMessage <String>]
 [-NotificationSenderAddress <MultiValuedProperty>]
 [-NotificationsForCleanSubmissionAirInvestigationsEnabled <Boolean>]
 [-NotificationsForPhishMalwareSubmissionAirInvestigationsEnabled <Boolean>]
 [-NotificationsForSpamSubmissionAirInvestigationsEnabled <Boolean>]
 [-NotificationsForSubmissionAirInvestigationsEnabled <Boolean>]
 [-NotJunkReviewResultMessage <String>]
 [-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>]
 [-ReportChatMessageEnabled <Boolean>]
 [-ReportChatMessageToCustomizedAddressEnabled <Boolean>]
 [-ReportJunkAddresses <MultiValuedProperty>]
 [-ReportJunkToCustomizedAddress <Boolean>]
 [-ReportNotJunkAddresses <MultiValuedProperty>]
 [-ReportNotJunkToCustomizedAddress <Boolean>]
 [-ReportPhishAddresses <MultiValuedProperty>]
 [-ReportPhishToCustomizedAddress <Boolean>]
 [-ThirdPartyReportAddresses <MultiValuedProperty>]
 [-UserSubmissionOptions <Int32>]
 [-UserSubmissionOptionsMessage <String>]
 [<CommonParameters>]

Parameters (68)

Parameter	Type	What it controls
-DisableQuarantineReportingOption	Boolean	The DisableQuarantineReportingOption parameter allows or prevents users from reporting messages in quarantine. Valid values are:
-DisableUserSubmissionOptions	Boolean	This parameter is reserved for internal Microsoft use.
-EnableCustomizedMsg	Boolean	This parameter is reserved for internal Microsoft use.
-EnableCustomNotificationSender	Boolean	The EnableCustomNotificationSender parameter specifies whether a custom sender email address is used for result messages after an admin reviews and marks the reported messages as junk, not junk, or phishing. Valid values are:
-EnableOrganizationBranding	Boolean	The EnableOrganizationBranding parameter specifies whether to show the company logo in the footer of result messages that users receive after an admin reviews and marks the reported messages as junk, not junk, or...
-EnableReportToMicrosoft	Boolean	The EnableReportToMicrosoft parameter specifies whether Microsoft integrated reporting experience is enabled or disabled. Valid values are $true or $false.
-EnableThirdPartyAddress	Boolean	The EnableThirdPartyAddress parameter specifies whether you're using non-Microsoft reporting tools in Outlook instead of Microsoft tools to send messages to the reporting mailbox in Exchange Online. Valid values are:
-EnableUserEmailNotification	Boolean	The EnableUserEmailNotification parameter species whether users receive result messages after an admin reviews and marks the reported messages as junk, not junk, or phishing. Valid values are:
-JunkReviewResultMessage	String	The JunkReviewResultMessage parameter specifies the custom text to use in result messages after an admin reviews and marks the reported messages as junk. If the value contains spaces, enclose the value in quotation marks (").
-MultiLanguagePostSubmitMessageButtonLinkForJunk	MultiValuedProperty	{{ Fill MultiLanguagePostSubmitMessageButtonLinkForJunk Description }}
-MultiLanguagePostSubmitMessageButtonLinkForPhishing	MultiValuedProperty	{{ Fill MultiLanguagePostSubmitMessageButtonLinkForPhishing Description }}
-MultiLanguagePostSubmitMessageButtonTextForJunk	MultiValuedProperty	{{ Fill MultiLanguagePostSubmitMessageButtonTextForJunk Description }}
-MultiLanguagePostSubmitMessageButtonTextForPhishing	MultiValuedProperty	{{ Fill MultiLanguagePostSubmitMessageButtonTextForPhishing Description }}
-MultiLanguagePostSubmitMessageForJunk	MultiValuedProperty	{{ Fill MultiLanguagePostSubmitMessageForJunk Description }}
-MultiLanguagePostSubmitMessageForPhishing	MultiValuedProperty	{{ Fill MultiLanguagePostSubmitMessageForPhishing Description }}
-MultiLanguagePostSubmitMessageTitleForJunk	MultiValuedProperty	{{ Fill MultiLanguagePostSubmitMessageTitleForJunk Description }}
-MultiLanguagePostSubmitMessageTitleForPhishing	MultiValuedProperty	{{ Fill MultiLanguagePostSubmitMessageTitleForPhishing Description }}
-MultiLanguagePreSubmitMessageButtonLinkForJunk	MultiValuedProperty	{{ Fill MultiLanguagePreSubmitMessageButtonLinkForJunk Description }}
-MultiLanguagePreSubmitMessageButtonLinkForNotJunk	MultiValuedProperty	{{ Fill MultiLanguagePreSubmitMessageButtonLinkForNotJunk Description }}
-MultiLanguagePreSubmitMessageButtonLinkForPhishing	MultiValuedProperty	{{ Fill MultiLanguagePreSubmitMessageButtonLinkForPhishing Description }}
-MultiLanguagePreSubmitMessageButtonTextForJunk	MultiValuedProperty	{{ Fill MultiLanguagePreSubmitMessageButtonTextForJunk Description }}
-MultiLanguagePreSubmitMessageButtonTextForNotJunk	MultiValuedProperty	{{ Fill MultiLanguagePreSubmitMessageButtonTextForNotJunk Description }}
-MultiLanguagePreSubmitMessageButtonTextForPhishing	MultiValuedProperty	{{ Fill MultiLanguagePreSubmitMessageButtonTextForPhishing Description }}
-MultiLanguagePreSubmitMessageForJunk	MultiValuedProperty	{{ Fill MultiLanguagePreSubmitMessageForJunk Description }}
-MultiLanguagePreSubmitMessageForNotJunk	MultiValuedProperty	{{ Fill MultiLanguagePreSubmitMessageForNotJunk Description }}
-MultiLanguagePreSubmitMessageForPhishing	MultiValuedProperty	{{ Fill MultiLanguagePreSubmitMessageForPhishing Description }}
-MultiLanguagePreSubmitMessageTitleForJunk	MultiValuedProperty	{{ Fill MultiLanguagePreSubmitMessageTitleForJunk Description }}
-MultiLanguagePreSubmitMessageTitleForNotJunk	MultiValuedProperty	{{ Fill MultiLanguagePreSubmitMessageTitleForNotJunk Description }}
-MultiLanguagePreSubmitMessageTitleForPhishing	MultiValuedProperty	{{ Fill MultiLanguagePreSubmitMessageTitleForPhishing Description }}
-MultiLanguageSetting	MultiValuedProperty	{{ Fill MultiLanguageSetting Description }}
-NotJunkReviewResultMessage	String	The NotJunkReviewResultMessage parameter specifies the custom text to use in result messages after an admin reviews and marks the reported messages as not junk. If the value contains spaces, enclose the value in...
-NotificationFooterMessage	String	The NotificationFooterMessage parameter specifies the custom footer text to use in email notifications after an admin reviews and marks the reported messages as junk, not junk, or phishing. If the value contains...
-NotificationSenderAddress	MultiValuedProperty	The NotificationSenderAddress parameter specifies the sender email address to use in result messages after an admin reviews and marks the reported messages as junk, not junk, or phishing. The email address must be in...
-NotificationsForCleanSubmissionAirInvestigationsEnabled	Boolean	This parameter is reserved for internal Microsoft use.
-NotificationsForPhishMalwareSubmissionAirInvestigationsEnabled	Boolean	This parameter is reserved for internal Microsoft use.
-NotificationsForSpamSubmissionAirInvestigationsEnabled	Boolean	This parameter is reserved for internal Microsoft use.
-NotificationsForSubmissionAirInvestigationsEnabled	Boolean	This parameter is reserved for internal Microsoft use.
-OnlyShowPhishingDisclaimer	Boolean	This parameter is reserved for internal Microsoft use.
-PhishingReviewResultMessage	String	The PhishingReviewResultMessage parameter specifies the custom text to use in result messages after an admin reviews and marks the reported messages as phishing. If the value contains spaces, enclose the value in...
-PostSubmitMessage	String	The PostSubmitMessage parameter specifies the custom pop-up message text to use in Outlook notifications after users report messages. If the value contains spaces, enclose the value in quotation marks (").
-PostSubmitMessageEnabled	Boolean	{{ Fill PostSubmitMessageEnabled Description }}
-PostSubmitMessageForJunk	String	Don't use this parameter. Use the PostSubmitMessage parameter instead.
-PostSubmitMessageForNotJunk	String	Don't use this parameter. Use the PostSubmitMessage parameter instead.
-PostSubmitMessageForPhishing	String	Don't use this parameter. Use the PostSubmitMessage parameter instead.
-PostSubmitMessageTitle	String	The PostSubmitMessage parameter parameter specifies the custom pop-up message title to use in Outlook notifications after users report messages. If the value contains spaces, enclose the value in quotation marks (").
-PostSubmitMessageTitleForJunk	String	Don't use this parameter. Use the PostSubmitMessageTitle parameter instead.
-PostSubmitMessageTitleForNotJunk	String	Don't use this parameter. Use the PostSubmitMessageTitle parameter instead.
-PostSubmitMessageTitleForPhishing	String	Don't use this parameter. Use the PostSubmitMessageTitle parameter instead.
-PreSubmitMessage	String	The PreSubmitMessage parameter specifies the custom pop-up message text to use in Outlook notifications before users report messages. If the value contains spaces, enclose the value in quotation marks (").
-PreSubmitMessageEnabled	Boolean	{{ Fill PreSubmitMessageEnabled Description }}
-PreSubmitMessageForJunk	String	Don't use this parameter. Use the PreSubmitMessage parameter instead.
-PreSubmitMessageForNotJunk	String	Don't use this parameter. Use the PreSubmitMessage parameter instead.
-PreSubmitMessageForPhishing	String	Don't use this parameter. Use the PreSubmitMessage parameter instead.
-PreSubmitMessageTitle	String	The PreSubmitMessage parameter parameter specifies the custom pop-up message title to use in Outlook notifications before users report messages. If the value contains spaces, enclose the value in quotation marks (").
-PreSubmitMessageTitleForJunk	String	Don't use this parameter. Use the PreSubmitMessageTitle parameter instead.
-PreSubmitMessageTitleForNotJunk	String	Don't use this parameter. Use the PreSubmitMessageTitle parameter instead.
-PreSubmitMessageTitleForPhishing	String	Don't use this parameter. Use the PreSubmitMessageTitle parameter instead.
-ReportChatMessageEnabled	Boolean	{{ Fill ReportChatMessageEnabled Description }}
-ReportChatMessageToCustomizedAddressEnabled	Boolean	{{ Fill ReportChatMessageToCustomizedAddressEnabled Description }}
-ReportJunkAddresses	MultiValuedProperty	The ReportJunkAddresses parameter specifies the email address of the reporting mailbox in Exchange Online to receive user reported messages in reporting in Outlook using Microsoft or non-Microsoft reporting tools in Outlook.
-ReportJunkToCustomizedAddress	Boolean	The ReportJunkToCustomizedAddress parameter specifies whether to send user reported messages from Outlook (using Microsoft or non-Microsoft reporting tools) to the reporting mailbox as part of reporting in Outlook....
-ReportNotJunkAddresses	MultiValuedProperty	The ReportNotJunkAddresses parameter specifies the email address of the reporting mailbox in Exchange Online to receive user reported messages in reporting in Outlook using Microsoft or non-Microsoft reporting tools...
-ReportNotJunkToCustomizedAddress	Boolean	The ReportNotJunkToCustomizedAddress parameter specifies whether to send user reported messages from Outlook (using Microsoft or non-Microsoft reporting tools) to the reporting mailbox as part of reporting in...
-ReportPhishAddresses	MultiValuedProperty	The ReportPhishAddresses parameter specifies the email address of the reporting mailbox in Exchange Online to receive user reported messages in reporting in Outlook using Microsoft or non-Microsoft reporting tools in Outlook.
-ReportPhishToCustomizedAddress	Boolean	The ReportPhishToCustomizedAddress parameter specifies whether to send user reported messages from Outlook (using Microsoft or non-Microsoft reporting tools) to the reporting mailbox as part of reporting in Outlook....
-ThirdPartyReportAddresses	MultiValuedProperty	Use the ThirdPartyReportAddresses parameter to specify the email address of the reporting mailbox in Exchange Online when you're using a non-Microsoft product for user submissions instead of reporting in Outlook.
-UserSubmissionOptions	Int32	This parameter is reserved for internal Microsoft use.
-UserSubmissionOptionsMessage	String	This parameter is reserved for internal Microsoft use.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.