Commands › Exchange Online

Set-ReportSubmissionPolicy

Exchange Online ExchangeOnlineManagement Set-*

Modify the report submission policy in your cloud-based organization.

Quick start script

# Set-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 (dry run first)
Set-ReportSubmissionPolicy -Identity <ReportSubmissionPolicyIdParameter> -WhatIf
Set-ReportSubmissionPolicy -Identity <ReportSubmissionPolicyIdParameter>

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

Syntax

Set-ReportSubmissionPolicy [-Identity] <ReportSubmissionPolicyIdParameter>
 [-Confirm]
 [-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>]
 [-ReportChatMessageEnabled <Boolean>]
 [-ReportChatMessageToCustomizedAddressEnabled <Boolean>]
 [-ReportJunkAddresses <MultiValuedProperty>]
 [-ReportJunkToCustomizedAddress <Boolean>]
 [-ReportNotJunkAddresses <MultiValuedProperty>]
 [-ReportNotJunkToCustomizedAddress <Boolean>]
 [-ReportPhishAddresses <MultiValuedProperty>]
 [-ReportPhishToCustomizedAddress <Boolean>]
 [-ThirdPartyReportAddresses <MultiValuedProperty>]
 [-UserSubmissionOptions <Int32>]
 [-UserSubmissionOptionsMessage <String>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (71)

Parameter	Type	Required	What it controls
-Identity	ReportSubmissionPolicyIdParameter	yes	The Identity parameter specifies the report submission policy that you want to modify. The only available policy is named DefaultReportSubmissionPolicy.
-Confirm	SwitchParameter		The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-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		The PostSubmitMessageEnabled parameter enables or disables the pop-up Outlook notifications that users see after they report messages using Microsoft reporting tools. Valid values are:
-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		The PreSubmitMessageEnabled parameter enables or disables the pop-up Outlook notifications that users see before they report messages using Microsoft reporting tools. Valid values are:
-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		This parameter is reserved for internal Microsoft use.
-ReportChatMessageToCustomizedAddressEnabled	Boolean		{{ Fill ReportChatMessageToCustomizedAddressEnabled Description }}
-ReportJunkAddresses	MultiValuedProperty		Note: You aren't absolutely required to use this parameter. You specify the email address of the reporting mailbox using the SentTo parameter on the New-ReportSubmissionRule or Set-ReportSubmissionRule cmdlet. To...
-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		Note: You aren't absolutely required to use this parameter. You specify the email address of the reporting mailbox using the SentTo parameter on the New-ReportSubmissionRule or Set-ReportSubmissionRule cmdlet. To...
-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		Note: You aren't absolutely required to use this parameter. You specify the email address of the reporting mailbox using the SentTo parameter on the New-ReportSubmissionRule or Set-ReportSubmissionRule cmdlet. To...
-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		Note: You aren't absolutely required to use this parameter. You specify the email address of the reporting mailbox using the SentTo parameter on the New-ReportSubmissionRule or Set-ReportSubmissionRule cmdlet. To...
-UserSubmissionOptions	Int32		This parameter is reserved for internal Microsoft use.
-UserSubmissionOptionsMessage	String		This parameter is reserved for internal Microsoft use.
-WhatIf	SwitchParameter		The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch.

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