Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
New-ReportSubmissionPolicy
- Module:
- Exchange PowerShell
This cmdlet is available only in the cloud-based service.
Use the New-ReportSubmissionPolicy cmdlet to 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.
For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.
Syntax
Default (Default)
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>]
Description
The report submission policy controls most of the settings for user submissions in the Microsoft Defender portal at https://security.microsoft.com/securitysettings/userSubmission.
The report submission rule (*-ReportSubmissionRule cmdlets) controls the email address of the reporting mailbox where user reported messages are delivered.
When you set the email address of the reporting mailbox in the Microsoft Defender portal at https://security.microsoft.com/securitysettings/userSubmission, 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.
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.
Examples
Example 1
New-ReportSubmissionPolicy
This example creates the one and only report submission policy named DefaultReportSubmissionPolicy with the default values: reporting in Outlook is on, Microsoft reporting tools in Outlook are used, and reported messages are sent only to Microsoft (the reporting mailbox isn't used).
Example 2
$usersub = "reportedmessages@contoso.com"
New-ReportSubmissionPolicy -ReportJunkToCustomizedAddress $true -ReportJunkAddresses $usersub -ReportNotJunkToCustomizedAddress $true -ReportNotJunkAddresses $usersub -ReportPhishToCustomizedAddress $true -ReportPhishAddresses $usersub
New-ReportSubmissionRule -Name DefaultReportSubmissionRule -ReportSubmissionPolicy DefaultReportSubmissionPolicy -SentTo $usersub
This example creates the report submission policy with the following values: reporting in Outlook is on, Microsoft reporting tools in Outlook are used, and reported messages are sent to Microsoft and the specified reporting mailbox in Exchange Online.
Notes:
- The default value of the EnableReportToMicrosoft parameter is $true and the default value of the EnableThirdPartyAddress parameter is $false, so you don't need to use them.
- To create the policy, you need to specify the same email address in the ReportJunkAddresses, ReportNotJunkAddresses, and ReportPhisAddresses parameters, and also in the SentTo parameter on the New-ReportSubmissionRule or Set-ReportSubmissionRule cmdlets.
- Like the report submission policy, you can create the report submission rule only if it doesn't already exist. If the rule already exists, you can use Set-ReportSubmissionRule to change the email address of the reporting mailbox, or Remove-ReportSubmissionRule to delete it and recreate it.
Example 3
$usersub = "userreportedmessages@fabrikam.com"
New-ReportSubmissionPolicy -EnableReportToMicrosoft $false -ReportJunkToCustomizedAddress $true -ReportJunkAddresses $usersub -ReportNotJunkToCustomizedAddress $true -ReportNotJunkAddresses $usersub -ReportPhishToCustomizedAddress $true -ReportPhishAddresses $usersub -DisableUserSubmissionOptions $false
New-ReportSubmissionRule -Name DefaultReportSubmissionRule -ReportSubmissionPolicy DefaultReportSubmissionPolicy -SentTo $usersub
This example creates the report submission policy with the following values: reporting in Outlook is on, Microsoft reporting tools in Outlook are used, and reported messages are sent only to the specified reporting mailbox in Exchange Online.
Example 4
$usersub = "thirdpartyreporting@wingtiptoys.com"
New-ReportSubmissionPolicy -EnableReportToMicrosoft $false -EnableThirdPartyAddress $true -ThirdPartyReportAddresses $usersub
New-ReportSubmissionRule -Name DefaultReportSubmissionRule -ReportSubmissionPolicy DefaultReportSubmissionPolicy -SentTo $usersub
This example creates the report submission policy with the following values: reporting in Outlook is on and non-Microsoft reporting tools in Outlook are used to send reported messages to the specified reporting mailbox in Exchange Online.
Example 5
New-ReportSubmissionPolicy -EnableReportToMicrosoft $false
This example creates the report submission policy with the following values: reporting in Outlook is off. 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.
Parameters
-DisableQuarantineReportingOption
Applicable: Exchange Online
The DisableQuarantineReportingOption parameter allows or prevents users from reporting messages in quarantine. Valid values are:
- $true: Users can't report quarantined messages from quarantine.
- $false: Users can report quarantined messages from quarantine. This value is the default.
This parameter is meaningful only reporting in Outlook is enabled as described in the EnableReportToMicrosoft parameter.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-DisableUserSubmissionOptions
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableCustomizedMsg
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableCustomNotificationSender
Applicable: Exchange Online
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:
- $true: Use a custom Microsoft 365 sender email address.
- $false: Use the default sender email address. This value is the default.
You specify the sender email address using the NotificationSenderAddress parameter.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableOrganizationBranding
Applicable: Exchange Online
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 phishing. Valid values are:
- $true: Use the company logo in the footer text instead of the Microsoft logo.
- $false: Don't use the company logo in the footer text. Use the Microsoft logo.
This parameter is meaningful only when reporting in Outlook is enabled for Microsoft reporting tools in Outlook as described in the EnableReportToMicrosoft parameter.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableReportToMicrosoft
Applicable: Exchange Online
The EnableReportToMicrosoft parameter specifies whether Microsoft integrated reporting experience is enabled or disabled. Valid values are $true or $false.
The value $true for this parameter enables reporting in Outlook. The following configurations are possible:
- Microsoft reporting tools are available in Outlook for users to report messages to Microsoft only (the reporting mailbox isn't used): The ReportJunkToCustomizedAddress, ReportNotJunkToCustomizedAddress, and ReportPhishToCustomizedAddress parameter values are $false. This is the default result.
- Microsoft reporting tools are available in Outlook for users to report messages to Microsoft and reported messages are sent to the specified reporting mailbox: The ReportJunkToCustomizedAddress, ReportNotJunkToCustomizedAddress, and ReportPhishToCustomizedAddress parameter values are $true. To create the policy, use the same email address in the ReportJunkAddresses, ReportNotJunkAddresses, and ReportPhisAddresses parameters, and also in the SentTo parameter on the New-ReportSubmissionRule or Set-ReportSubmissionRule cmdlet.
The value $false for this parameter disables reporting in Outlook. The following configurations are possible:
- Microsoft reporting tools are available in Outlook, but reported messages are sent only to the reporting mailbox: The ReportJunkToCustomizedAddress, ReportNotJunkToCustomizedAddress, and ReportPhishToCustomizedAddress parameter values are $true. To create the policy, use the same email address in the ReportJunkAddresses, ReportNotJunkAddresses, and ReportPhisAddresses parameters, and also in the SentTo parameter on the New-ReportSubmissionRule or Set-ReportSubmissionRule cmdlet.
- Reporting in Outlook is disabled. Microsoft reporting tools are not available in Outlook. Any messages reported by users in Outlook with non-Microsoft reporting tools aren't visible on the Submissions page in the Microsoft Defender portal: The EnableThirdPartyAddress, ReportJunkToCustomizedAddress, ReportNotJunkToCustomizedAddress, and ReportPhishToCustomizedAddress parameter values are $false.
This parameter is required to create the report submission policy only if you set the value to $false (the default value is $true).
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableThirdPartyAddress
Applicable: Exchange Online
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:
- $true: Reporting in Outlook is enabled, but non-Microsoft tools in Outlook send reported messages to the reporting mailbox in Exchange Online. You also need to set the EnableReportToMicrosoft parameter value to $false. To create the policy, use the same email address in the ThirdPartyReportAddresses parameter and also in the SentTo parameter on the New-ReportSubmissionRule or Set-ReportSubmissionRule cmdlets.
- $false: Non-Microsoft reporting tools in Outlook aren't used.
This parameter is required to create the report submission policy only if you set the value to $true (the default value is $false).
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableUserEmailNotification
Applicable: Exchange Online
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:
- $true: Customized admin review result messages are sent.
- $false: Customized admin review result messages are not sent.
Use the JunkReviewResultMessage, NotJunkReviewResultMessage, PhishingReviewResultMessage parameters to configure the message body text that's used for each verdict.
Use the NotificationFooterMessage parameter for the footer that's used for all verdicts (junk, not junk, and phishing).
This parameter is meaningful only when reporting in Outlook is enabled for Microsoft reporting tools in Outlook as described in the EnableReportToMicrosoft parameter.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-JunkReviewResultMessage
Applicable: Exchange Online
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 (").
This parameter is meaningful only when the value of the EnableUserEmailNotification parameter is $true and reporting in Outlook is enabled for Microsoft reporting tools in Outlook as described in the EnableReportToMicrosoft parameter.
Use the NotificationFooterMessage parameter to customize the footer text of result messages.
Use the NotificationSenderAddress parameter to customize the sender email address of result messages.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePostSubmitMessageButtonLinkForJunk
Applicable: Exchange Online
{{ Fill MultiLanguagePostSubmitMessageButtonLinkForJunk Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePostSubmitMessageButtonLinkForPhishing
Applicable: Exchange Online
{{ Fill MultiLanguagePostSubmitMessageButtonLinkForPhishing Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePostSubmitMessageButtonTextForJunk
Applicable: Exchange Online
{{ Fill MultiLanguagePostSubmitMessageButtonTextForJunk Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePostSubmitMessageButtonTextForPhishing
Applicable: Exchange Online
{{ Fill MultiLanguagePostSubmitMessageButtonTextForPhishing Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePostSubmitMessageForJunk
Applicable: Exchange Online
{{ Fill MultiLanguagePostSubmitMessageForJunk Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePostSubmitMessageForPhishing
Applicable: Exchange Online
{{ Fill MultiLanguagePostSubmitMessageForPhishing Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePostSubmitMessageTitleForJunk
Applicable: Exchange Online
{{ Fill MultiLanguagePostSubmitMessageTitleForJunk Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePostSubmitMessageTitleForPhishing
Applicable: Exchange Online
{{ Fill MultiLanguagePostSubmitMessageTitleForPhishing Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePreSubmitMessageButtonLinkForJunk
Applicable: Exchange Online
{{ Fill MultiLanguagePreSubmitMessageButtonLinkForJunk Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePreSubmitMessageButtonLinkForNotJunk
Applicable: Exchange Online
{{ Fill MultiLanguagePreSubmitMessageButtonLinkForNotJunk Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePreSubmitMessageButtonLinkForPhishing
Applicable: Exchange Online
{{ Fill MultiLanguagePreSubmitMessageButtonLinkForPhishing Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePreSubmitMessageButtonTextForJunk
Applicable: Exchange Online
{{ Fill MultiLanguagePreSubmitMessageButtonTextForJunk Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePreSubmitMessageButtonTextForNotJunk
Applicable: Exchange Online
{{ Fill MultiLanguagePreSubmitMessageButtonTextForNotJunk Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePreSubmitMessageButtonTextForPhishing
Applicable: Exchange Online
{{ Fill MultiLanguagePreSubmitMessageButtonTextForPhishing Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePreSubmitMessageForJunk
Applicable: Exchange Online
{{ Fill MultiLanguagePreSubmitMessageForJunk Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePreSubmitMessageForNotJunk
Applicable: Exchange Online
{{ Fill MultiLanguagePreSubmitMessageForNotJunk Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePreSubmitMessageForPhishing
Applicable: Exchange Online
{{ Fill MultiLanguagePreSubmitMessageForPhishing Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePreSubmitMessageTitleForJunk
Applicable: Exchange Online
{{ Fill MultiLanguagePreSubmitMessageTitleForJunk Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePreSubmitMessageTitleForNotJunk
Applicable: Exchange Online
{{ Fill MultiLanguagePreSubmitMessageTitleForNotJunk Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguagePreSubmitMessageTitleForPhishing
Applicable: Exchange Online
{{ Fill MultiLanguagePreSubmitMessageTitleForPhishing Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MultiLanguageSetting
Applicable: Exchange Online
{{ Fill MultiLanguageSetting Description }}
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NotificationFooterMessage
Applicable: Exchange Online
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 spaces, enclose the value in quotation marks.
You can use the EnableOrganizationBranding parameter to include your company logo in the message footer.
This parameter is meaningful only when the value of the EnableUserEmailNotification parameter is $true and reporting in Outlook is enabled for Microsoft reporting tools in Outlook as described in the EnableReportToMicrosoft parameter.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NotificationSenderAddress
Applicable: Exchange Online
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 Exchange Online.
This parameter is meaningful only when reporting in Outlook is enabled for Microsoft reporting tools in Outlook as described in the EnableReportToMicrosoft parameter.
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NotificationsForCleanSubmissionAirInvestigationsEnabled
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NotificationsForPhishMalwareSubmissionAirInvestigationsEnabled
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NotificationsForSpamSubmissionAirInvestigationsEnabled
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NotificationsForSubmissionAirInvestigationsEnabled
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NotJunkReviewResultMessage
Applicable: Exchange Online
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 quotation marks (").
This parameter is meaningful only when the value of the EnableUserEmailNotification parameter is $true and reporting in Outlook is enabled for Microsoft reporting tools in Outlook as described in the EnableReportToMicrosoft parameter.
Use the NotificationFooterMessage parameter to customize the footer text of result messages.
Use the NotificationSenderAddress parameter to customize the sender email address of result messages.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-OnlyShowPhishingDisclaimer
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PhishingReviewResultMessage
Applicable: Exchange Online
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 quotation marks (").
This parameter is meaningful only when the value of the EnableUserEmailNotification parameter is $true and reporting in Outlook is enabled for Microsoft reporting tools in Outlook as described in the EnableReportToMicrosoft parameter.
Use the NotificationFooterMessage parameter to customize the footer text of result messages.
Use the NotificationSenderAddress parameter to customize the sender email address of result messages.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PostSubmitMessage
Applicable: Exchange Online
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 (").
You specify the custom pop-up message title using the PostSubmitMessageTitle parameter.
This parameter is meaningful only when reporting in Outlook is enabled for Microsoft reporting tools in Outlook as described in the EnableReportToMicrosoft parameter.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PostSubmitMessageEnabled
Applicable: Exchange Online
{{ Fill PostSubmitMessageEnabled Description }}
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PostSubmitMessageForJunk
Applicable: Exchange Online
Don't use this parameter. Use the PostSubmitMessage parameter instead.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PostSubmitMessageForNotJunk
Applicable: Exchange Online
Don't use this parameter. Use the PostSubmitMessage parameter instead.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PostSubmitMessageForPhishing
Applicable: Exchange Online
Don't use this parameter. Use the PostSubmitMessage parameter instead.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PostSubmitMessageTitle
Applicable: Exchange Online
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 (").
You specify the custom pop-up message text using the PostSubmitMessage parameter.
This parameter is meaningful only when reporting in Outlook is enabled for Microsoft reporting tools in Outlook as described in the EnableReportToMicrosoft parameter.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PostSubmitMessageTitleForJunk
Applicable: Exchange Online
Don't use this parameter. Use the PostSubmitMessageTitle parameter instead.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PostSubmitMessageTitleForNotJunk
Applicable: Exchange Online
Don't use this parameter. Use the PostSubmitMessageTitle parameter instead.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PostSubmitMessageTitleForPhishing
Applicable: Exchange Online
Don't use this parameter. Use the PostSubmitMessageTitle parameter instead.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PreSubmitMessage
Applicable: Exchange Online
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 (").
You specify the custom pop-up message title using the PreSubmitMessageTitle parameter.
This parameter is meaningful only when reporting in Outlook is enabled for Microsoft reporting tools in Outlook as described in the EnableReportToMicrosoft parameter.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PreSubmitMessageEnabled
Applicable: Exchange Online
{{ Fill PreSubmitMessageEnabled Description }}
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PreSubmitMessageForJunk
Applicable: Exchange Online
Don't use this parameter. Use the PreSubmitMessage parameter instead.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PreSubmitMessageForNotJunk
Applicable: Exchange Online
Don't use this parameter. Use the PreSubmitMessage parameter instead.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PreSubmitMessageForPhishing
Applicable: Exchange Online
Don't use this parameter. Use the PreSubmitMessage parameter instead.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PreSubmitMessageTitle
Applicable: Exchange Online
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 (").
You specify the pop-up message text using the PreSubmitMessage parameter.
This parameter is meaningful only when reporting in Outlook is enabled for Microsoft reporting tools in Outlook as described in the EnableReportToMicrosoft parameter.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PreSubmitMessageTitleForJunk
Applicable: Exchange Online
Don't use this parameter. Use the PreSubmitMessageTitle parameter instead.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PreSubmitMessageTitleForNotJunk
Applicable: Exchange Online
Don't use this parameter. Use the PreSubmitMessageTitle parameter instead.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PreSubmitMessageTitleForPhishing
Applicable: Exchange Online
Don't use this parameter. Use the PreSubmitMessageTitle parameter instead.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ReportChatMessageEnabled
Applicable: Exchange Online
{{ Fill ReportChatMessageEnabled Description }}
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ReportChatMessageToCustomizedAddressEnabled
Applicable: Exchange Online
{{ Fill ReportChatMessageToCustomizedAddressEnabled Description }}
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ReportJunkAddresses
Applicable: Exchange Online
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.
This parameter is required to create the report submission policy if the ReportJunkToCustomizedAddress parameter value is $true.
You can't use this parameter by itself. You need to specify the same email address for the ReportJunkAddresses, ReportNotJunkAddresses and ReportPhishAddresses parameters.
You also need to specify the same email address in the SentTo parameter on the New-ReportSubmissionRule or Set-ReportSubmissionRule cmdlet.
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ReportJunkToCustomizedAddress
Applicable: Exchange Online
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. Valid values are:
- $true: User reported messages are sent to the reporting mailbox.
- $false: User reported messages are not sent to the reporting mailbox.
You can't use this parameter by itself. You need to specify the same value for the ReportJunkToCustomizedAddress, ReportNotJunkToCustomizedAddress, and ReportPhishToCustomizedAddress parameters in the same command.
This parameter is required to create the report submission policy if you're using reporting in Outlook (see the EnableReportToMicrosoft parameter) and sending reported messages to the reporting mailbox (exclusively or in addition to reporting to Microsoft).
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ReportNotJunkAddresses
Applicable: Exchange Online
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 in Outlook.
This parameter is required to create the report submission policy if the ReportNotJunkToCustomizedAddress parameter value is $true.
You can't use this parameter by itself. You need to specify the same email address for the ReportJunkAddresses, ReportNotJunkAddresses and ReportPhishAddresses parameters.
You also need to specify the same email address in the SentTo parameter on the New-ReportSubmissionRule or Set-ReportSubmissionRule cmdlet.
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ReportNotJunkToCustomizedAddress
Applicable: Exchange Online
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 Outlook. Valid values are:
- $true: User reported messages are sent to the reporting mailbox.
- $false: User reported messages are not sent to the reporting mailbox.
You can't use this parameter by itself. You need to specify the same value for the ReportJunkToCustomizedAddress, ReportNotJunkToCustomizedAddress, and ReportPhishToCustomizedAddress parameters.
This parameter is required to create the report submission policy if you're using reporting in Outlook (see the EnableReportToMicrosoft parameter) and sending reported messages to the reporting mailbox (exclusively or in addition to reporting to Microsoft).
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ReportPhishAddresses
Applicable: Exchange Online
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.
This parameter is required to create the report submission policy if the ReportPhishToCustomizedAddress parameter value is $true.
You can't use this parameter by itself. You need to specify the same email address for the ReportJunkAddresses, ReportNotJunkAddresses and ReportPhishAddresses parameters.
You also need to specify the same email address in the SentTo parameter on the New-ReportSubmissionRule or Set-ReportSubmissionRule cmdlet.
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ReportPhishToCustomizedAddress
Applicable: Exchange Online
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. Valid values are:
- $true: User reported messages are sent to the reporting mailbox.
- $false: User reported messages are not sent to the reporting mailbox.
You can't use this parameter by itself. You need to specify the same value for the ReportJunkToCustomizedAddress, ReportNotJunkToCustomizedAddress, and ReportPhishToCustomizedAddress parameters.
This parameter is required to create the report submission policy if you're using reporting in Outlook (see the EnableReportToMicrosoft parameter) and sending reported messages to the reporting mailbox (exclusively or in addition to reporting to Microsoft).
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ThirdPartyReportAddresses
Applicable: Exchange Online
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.
This parameter is required to create the report submission policy if you've disabled reporting in Outlook (-EnableReportToMicrosoft $false) and you're using the reporting mailbox with non-Microsoft tools (-EnableThirdPartyAddress $true).
Parameter properties
| Type: | MultiValuedProperty |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-UserSubmissionOptions
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-UserSubmissionOptionsMessage
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Feedback
Was this page helpful?